webmail/lib/__tests__/calendar-event-normalization.test.ts

import { describe, expect, it } from 'vitest';
import type { CalendarEvent } from '@/lib/jmap/types';
import {
  isAllDayEventLike,
  normalizeCalendarEventLike,
  sanitizeOutgoingCalendarEventData,
} from '../calendar-event-normalization';

function makeEvent(overrides: Partial<CalendarEvent> = {}): Partial<CalendarEvent> {
  return {
    start: '2026-03-16T00:00:00',
    duration: 'PT24H',
    showWithoutTime: false,
    timeZone: null,
    ...overrides,
  };
}

describe('calendar event normalization', () => {
  it('infers all-day events from midnight-to-midnight spans without the flag', () => {
    expect(isAllDayEventLike(makeEvent())).toBe(true);
  });

  it('does not infer all-day for midnight events with non-day durations', () => {
    expect(isAllDayEventLike(makeEvent({ duration: 'PT12H' }))).toBe(false);
  });

  it('normalizes inferred all-day durations to day units', () => {
    expect(normalizeCalendarEventLike(makeEvent({ duration: 'PT48H' }))).toMatchObject({
      showWithoutTime: true,
      duration: 'P2D',
    });
  });

  it('sanitizes outgoing all-day starts to date-only values', () => {
    expect(sanitizeOutgoingCalendarEventData(makeEvent({
      showWithoutTime: true,
      start: '2026-03-16T00:00:00',
      duration: 'PT24H',
      timeZone: 'UTC',
    }))).toMatchObject({
      start: '2026-03-16T00:00:00',
      duration: 'P1D',
      timeZone: null,
      showWithoutTime: true,
    });
  });

  describe('recurrenceRule normalization (JSCalendar 2.0 singular→plural)', () => {
    it('wraps a single recurrenceRule object in an array', () => {
      const raw = {
        ...makeEvent({ showWithoutTime: false, duration: 'PT1H', start: '2026-03-16T09:00:00' }),
        recurrenceRule: { '@type': 'RecurrenceRule', frequency: 'weekly' },
      } as Record<string, unknown>;
      const result = normalizeCalendarEventLike(raw as Partial<CalendarEvent>);
      expect(result.recurrenceRules).toEqual([{ '@type': 'RecurrenceRule', frequency: 'weekly' }]);
      expect((result as Record<string, unknown>).recurrenceRule).toBeUndefined();
    });

    it('passes through recurrenceRule when already an array', () => {
      const raw = {
        ...makeEvent({ showWithoutTime: false, duration: 'PT1H', start: '2026-03-16T09:00:00' }),
        recurrenceRule: [{ '@type': 'RecurrenceRule', frequency: 'daily' }],
      } as Record<string, unknown>;
      const result = normalizeCalendarEventLike(raw as Partial<CalendarEvent>);
      expect(result.recurrenceRules).toEqual([{ '@type': 'RecurrenceRule', frequency: 'daily' }]);
    });

    it('passes through null recurrenceRule as-is', () => {
      const raw = {
        ...makeEvent({ showWithoutTime: false, duration: 'PT1H', start: '2026-03-16T09:00:00' }),
        recurrenceRule: null,
      } as Record<string, unknown>;
      const result = normalizeCalendarEventLike(raw as Partial<CalendarEvent>);
      expect(result.recurrenceRules).toBeNull();
    });

    it('wraps a single excludedRecurrenceRule object in an array', () => {
      const raw = {
        ...makeEvent({ showWithoutTime: false, duration: 'PT1H', start: '2026-03-16T09:00:00' }),
        excludedRecurrenceRule: { '@type': 'RecurrenceRule', frequency: 'daily' },
      } as Record<string, unknown>;
      const result = normalizeCalendarEventLike(raw as Partial<CalendarEvent>);
      expect(result.excludedRecurrenceRules).toEqual([{ '@type': 'RecurrenceRule', frequency: 'daily' }]);
    });
  });

  describe('zero-duration timed events (#837)', () => {
    // Stalwart drops a DTEND equal to DTSTART and returns no duration, but a
    // utcEnd at 23:59:59 of the start day.
    const fromServer = {
      start: '2026-09-30T10:00:00',
      timeZone: 'Etc/UTC',
      showWithoutTime: false,
      utcStart: '2026-09-30T10:00:00Z',
      utcEnd: '2026-09-30T23:59:59Z',
    } as Partial<CalendarEvent>;

    it('ends a server event without a duration at its start', () => {
      expect(normalizeCalendarEventLike(fromServer)).toMatchObject({
        duration: 'PT0S',
        utcEnd: '2026-09-30T10:00:00Z',
      });
    });

    it('keeps the end of a server event that has a duration', () => {
      const event = { ...fromServer, duration: 'PT8H', utcEnd: '2026-09-30T18:00:00Z' };
      expect(normalizeCalendarEventLike(event)).toMatchObject({
        duration: 'PT8H',
        utcEnd: '2026-09-30T18:00:00Z',
      });
    });

    it('leaves update patches without a duration alone', () => {
      const patch = { start: '2026-09-30T11:00:00' } as Partial<CalendarEvent>;
      expect(sanitizeOutgoingCalendarEventData(patch)).not.toHaveProperty('duration');
    });
  });
});