Calendar event filtering and timezone improvements

[CR0CKER]

Motivation

This PR addresses several long-standing issues with calendar event handling:

1. User pain point: Users see declined invitations cluttering their daily notes, even though they're not attending
2. Bug: Cancelled/deleted events still appear in the calendar import
3. Bug: When a recurring meeting is rescheduled, it appears on BOTH the old and new dates
4. Bug: Events from different timezones (e.g., US-based meetings) display incorrect times in other timezones (e.g., Europe)
5. Bug: Events don't sort chronologically, making daily notes hard to read

Summary

This PR includes multiple related improvements for calendar event handling, timezone display, and event filtering:

• Filter declined events: Add optional filtering to hide events where user has declined the invitation
• Filter deleted events: Properly handle cancelled events (STATUS:CANCELLED) and excluded recurring instances (EXDATE)
• Fix rescheduled events: Prevent recurring events from appearing on both original and rescheduled dates
• Fix timezone display: Correct timezone handling for recurring events from different timezones
• Fix event sorting: Sort events by UTC time to match displayed chronological order

Changes

1. Declined Event Filtering (89cc0d6)

New Settings:

• userEmail (string, optional): Your email address to identify declined events
• hideDeclinedEvents (boolean, default: true): Enable/disable filtering

Implementation:

• Add shouldFilterDeclinedEvent() helper that checks attendee PARTSTAT property
• Filter applied to: non-recurring events, recurring instances, and rescheduled instances
• Feature is opt-in and backward compatible (disabled if no email configured)

Example usage:

Settings → userEmail: "user@example.com"
Settings → hideDeclinedEvents: true (default)

Result: Events where you've clicked "Decline" in your calendar app won't appear in Logseq.

2. Deleted Event Filtering (39aae4a)

Bug fix: node-ical returns exdate (excluded dates) as an object, not an array

Implementation:

• Add isCancelledEvent() to filter events with STATUS:CANCELLED (iCalendar spec)
• Fix EXDATE handling: Use Object.values() to extract dates regardless of structure
• Properly exclude single deleted instances from recurring events

Example: If you delete "June 15th" from a recurring weekly meeting, that date no longer appears.

3. Rescheduled Event Handling (0ac10e3)

Bug fix: Recurring events appeared on both original and rescheduled dates

Implementation:

• Check event.recurrences property for modified instances
• Skip original occurrence when rescheduled version exists
• Add rescheduled instances to events array with correct date/time

Example: If you reschedule Monday's 2pm meeting to Tuesday 3pm, it only appears on Tuesday at 3pm (not both days).

4. Timezone Display Fix (1086e0b)

Bug fix: Recurring events from different timezones displayed incorrect times

Root cause: Previous code parsed dtstart without specifying timezone, causing time extraction in wrong timezone.

Implementation:

• Fix recurring event time parsing using moment.tz() with event's timezone (index.ts:336)
• Display times in user's local timezone instead of event timezone (index.ts:568-569)
• Fix sorting to match displayed times (index.ts:169-177)

Example: An "8:30 AM America/New_York" meeting now correctly displays as "2:30 PM" in Europe/Amsterdam, not "8:30 AM".

5. Event Sorting Fix (2e5962b)

Bug fix: Events didn't sort chronologically

Implementation:

• Sort by UTC timestamps instead of timezone-aware times
• Filter out events with invalid dates before sorting
• Events now appear in correct chronological order as displayed

Backward Compatibility

✅ No breaking changes:

• Declined event filtering is disabled by default (requires userEmail to be configured)
• All existing calendars continue to work without modification
• New settings have sensible defaults

⚠️ Note: If users configure userEmail, hideDeclinedEvents defaults to true. Users who want to see declined events should set this to false.

Testing

Manual Test Plan

• Declined events: Configure userEmail in settings, decline a calendar event in your calendar app, run import → verify event doesn't appear
• Cancelled events: Cancel an event in your calendar app, run import → verify it doesn't appear
• Deleted recurring instances: Delete one instance of a recurring event, run import → verify that date is skipped
• Rescheduled recurring events: Reschedule one instance of a recurring meeting to a different date/time, run import → verify it appears only on the new date/time
• Timezone display: Import a calendar with events in a different timezone (e.g., US events viewed from Europe), verify times display in your local timezone
• Event sorting: Import multiple events throughout the day, verify they appear in chronological order

Test Setup

For testing timezone issues, you can use this public test calendar with US/Eastern events:

webcal://example-ical-url-with-timezone-events

Documentation Impact

Settings documentation needed:
The plugin settings UI now includes two new fields that should be documented:

• userEmail: User's email address (optional, used for declined event filtering)
• hideDeclinedEvents: Toggle for declined event filtering (default: true)

Related Issues

This PR supersedes PR #62 (event sorting fix) by including that fix plus additional improvements.

Potentially related to issue #53 (expanding RRule to include 2024) - this PR generates recurring events from 1 year ago to 2 years in the future.

🤖 Generated with Claude Code

[CR0CKER]

Superseded — see https://github.com/CR0CKER/logseq-calendars-plugin (logseq-ical-sync).