@miguelarios/pim-core 0.5.0 → 0.7.0

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+# Changelog
+
+## 0.7.0 (2026-07-10)
+
+- RFC 6350 vCard value escaping/unescaping — commas, semicolons, backslashes, and newlines in `N`/`ADR`/`NOTE` fields are now correctly escaped on write and unescaped on read (PR #4, `fix/vcard-escaping`).
+- `vcard.ts` preserves `PHOTO`, structured-name parts, `ORG` units, and social-profile fields through parse/serialize round-trips, fixing silent data loss that card-mcp's update path relied on (PR #5, `fix/contact-roundtrip`).
+- `updateMasterEventIcs` — targeted master `VEVENT` mutation that preserves `RRULE`, `EXDATE`, and recurrence overrides instead of regenerating the whole ICS on update (PR #7, `fix/cal-master-update`).
+- Timezone helpers (`timezone.ts`) resolve preferred-hour boundaries against `PIM_TIMEZONE` instead of the host's local zone (PR #8, `fix/cal-timezones`).
+- `splitIcsByUid` — splits a multi-`VEVENT` ICS payload into one object per UID per RFC 4791 (PR #9, `fix/cal-import-and-exceptions`).
+- `removeExceptionFromIcs` and ICS component handling now match recurrence overrides via `ical.js`, including TZID-form `RECURRENCE-ID` values (PR #9, `fix/cal-import-and-exceptions`).
+
+Earlier releases: see git tags and docs/superpowers/specs/.

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,54 @@
+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 interface MasterEventUpdates {
+    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";
+    timezone?: string;
+}
+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;
+export declare function updateMasterEventIcs(rawIcs: string, updates: MasterEventUpdates): string;
+export declare function removeExceptionFromIcs(icsContent: string, occurrenceDate: string, allDay: boolean): string;
+export declare function splitIcsByUid(icsContent: string): Array<{
+    uid: string;
+    ics: 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;AAKvB,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;AAED,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;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;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;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAgGxF;AAOD,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,OAAO,GACd,MAAM,CAsBR;AAQD,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAuBrF"}

package/dist/ics/components.js

@@ -0,0 +1,326 @@
+import ICAL from "ical.js";
+import "./_tz-init.js";
+import { parseAttendees, parseCategories, parseOrganizer } from "./_shared.js";
+import { IcsParseError } from "./errors.js";
+import { toIcalTime } from "./generate.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();
+}
+export function updateMasterEventIcs(rawIcs, updates) {
+    const root = parseRoot(rawIcs);
+    const master = root
+        .getAllSubcomponents("vevent")
+        .find((c) => !c.getFirstProperty("recurrence-id"));
+    if (!master)
+        throw new IcsParseError("No master VEVENT found in ICS", null);
+    const currentDtstart = master.getFirstPropertyValue("dtstart");
+    const currentAllDay = currentDtstart instanceof ICAL.Time ? currentDtstart.isDate : false;
+    const allDay = updates.all_day ?? currentAllDay;
+    if (updates.title !== undefined)
+        master.updatePropertyWithValue("summary", updates.title);
+    const setTime = (propName, iso) => {
+        const existing = master.getFirstProperty(propName);
+        const existingTzid = existing?.getParameter("tzid");
+        const effectiveTz = updates.timezone ?? (typeof existingTzid === "string" ? existingTzid : undefined);
+        const t = toIcalTime(iso, allDay, effectiveTz);
+        const prop = master.updatePropertyWithValue(propName, t);
+        prop.removeParameter("tzid");
+        prop.removeParameter("value");
+        if (allDay)
+            prop.setParameter("value", "DATE");
+        else if (effectiveTz && ICAL.TimezoneService.get(effectiveTz)) {
+            prop.setParameter("tzid", effectiveTz);
+        }
+    };
+    if (updates.start !== undefined)
+        setTime("dtstart", updates.start);
+    if (updates.end !== undefined)
+        setTime("dtend", updates.end);
+    const setOrRemove = (propName, value) => {
+        if (value === undefined)
+            return;
+        if (value === "")
+            master.removeAllProperties(propName);
+        else
+            master.updatePropertyWithValue(propName, value);
+    };
+    setOrRemove("location", updates.location);
+    setOrRemove("description", updates.description);
+    if (updates.organizer) {
+        const name = updates.organizer.name && updates.organizer.name.trim().length > 0
+            ? updates.organizer.name
+            : updates.organizer.email.split("@")[0];
+        const orgProp = master.updatePropertyWithValue("organizer", `mailto:${updates.organizer.email}`);
+        orgProp.setParameter("cn", name);
+    }
+    if (updates.attendees !== undefined) {
+        master.removeAllProperties("attendee");
+        for (const att of updates.attendees) {
+            master.addPropertyWithValue("attendee", `mailto:${att.email}`);
+        }
+    }
+    if (updates.categories !== undefined) {
+        master.removeAllProperties("categories");
+        if (updates.categories.length > 0) {
+            master.addPropertyWithValue("categories", updates.categories.join(","));
+        }
+    }
+    if (updates.availability === "free")
+        master.updatePropertyWithValue("transp", "TRANSPARENT");
+    else if (updates.availability === "busy")
+        master.updatePropertyWithValue("transp", "OPAQUE");
+    if (updates.alarms !== undefined) {
+        for (const valarm of master.getAllSubcomponents("valarm")) {
+            master.removeSubcomponent(valarm);
+        }
+        for (const alarm of updates.alarms) {
+            const valarm = new ICAL.Component("valarm");
+            valarm.updatePropertyWithValue("action", "DISPLAY");
+            const summary = master.getFirstPropertyValue("summary");
+            valarm.updatePropertyWithValue("description", typeof summary === "string" ? summary : "Reminder");
+            if (alarm.type === "relative" && typeof alarm.trigger === "number") {
+                valarm.updatePropertyWithValue("trigger", ICAL.Duration.fromSeconds(alarm.trigger));
+            }
+            else if (alarm.type === "absolute" && typeof alarm.trigger === "string") {
+                valarm.updatePropertyWithValue("trigger", ICAL.Time.fromJSDate(new Date(alarm.trigger), true));
+            }
+            master.addSubcomponent(valarm);
+        }
+    }
+    const seq = master.getFirstPropertyValue("sequence");
+    master.updatePropertyWithValue("sequence", (typeof seq === "number" ? seq : 0) + 1);
+    master.updatePropertyWithValue("dtstamp", ICAL.Time.now());
+    return root.toString();
+}
+// Removes any VEVENT/VTODO whose RECURRENCE-ID resolves to the same instant as
+// occurrenceDate. ical.js resolves RECURRENCE-ID;TZID=... to the correct
+// instant when the VTIMEZONE is present, so this epoch comparison (matching
+// addExdateToIcs's convention) handles both UTC (...Z) and TZID-qualified
+// forms — unlike a regex matching the literal UTC text.
+export function removeExceptionFromIcs(icsContent, occurrenceDate, allDay) {
+    const root = parseRoot(icsContent);
+    const target = ICAL.Time.fromJSDate(new Date(occurrenceDate), true);
+    const targetMs = target.toJSDate().getTime();
+    const targetYmd = `${target.year}-${String(target.month).padStart(2, "0")}-${String(target.day).padStart(2, "0")}`;
+    let removed = false;
+    for (const type of ["vevent", "vtodo"]) {
+        for (const comp of root.getAllSubcomponents(type)) {
+            const recurId = comp.getFirstPropertyValue("recurrence-id");
+            if (!(recurId instanceof ICAL.Time))
+                continue;
+            const matches = allDay && recurId.isDate
+                ? `${recurId.year}-${String(recurId.month).padStart(2, "0")}-${String(recurId.day).padStart(2, "0")}` ===
+                    targetYmd
+                : recurId.toJSDate().getTime() === targetMs;
+            if (matches) {
+                root.removeSubcomponent(comp);
+                removed = true;
+            }
+        }
+    }
+    return removed ? root.toString() : icsContent;
+}
+// Splits a multi-event ICS file into one VCALENDAR per unique UID. RFC 4791
+// §4.1 requires exactly one UID per calendar object; SabreDAV (Nextcloud)
+// rejects or corrupts PUTs that bundle multiple UIDs into a single object.
+// Each output group carries that UID's master event plus any RECURRENCE-ID
+// overrides for the same UID, and a copy of every VTIMEZONE subcomponent
+// from the source (so zoned DTSTART/DTEND still resolve after the split).
+export function splitIcsByUid(icsContent) {
+    const root = parseRoot(icsContent);
+    const timezones = root.getAllSubcomponents("vtimezone");
+    const byUid = new Map();
+    for (const type of ["vevent", "vtodo"]) {
+        for (const comp of root.getAllSubcomponents(type)) {
+            const uid = comp.getFirstPropertyValue("uid");
+            if (typeof uid !== "string" || !uid)
+                continue;
+            const list = byUid.get(uid) ?? [];
+            list.push(comp);
+            byUid.set(uid, list);
+        }
+    }
+    const results = [];
+    for (const [uid, comps] of byUid) {
+        const cal = new ICAL.Component(["vcalendar", [], []]);
+        cal.updatePropertyWithValue("prodid", "-//pim-core//import-split//EN");
+        cal.updatePropertyWithValue("version", "2.0");
+        for (const tz of timezones)
+            cal.addSubcomponent(ICAL.Component.fromString(tz.toString()));
+        for (const comp of comps)
+            cal.addSubcomponent(ICAL.Component.fromString(comp.toString()));
+        results.push({ uid, ics: cal.toString() });
+    }
+    return results;
+}
+//# sourceMappingURL=components.js.map