familysync/apps/api/tests/broker/write.test.ts

/**
 * RED test scaffold: broker/write.ts — tsdav PUT/DELETE wrappers (CAL-04, CAL-05, CAL-06)
 *
 * Behaviors under test:
 *   1. createCalendarEvent calls client.createCalendarObject with `${uid}.ics` filename
 *   2. updateCalendarEvent passes etag into the calendarObject (If-Match for D-08)
 *   3. deleteCalendarEvent passes etag into the calendarObject (If-Match for D-08)
 *   4. Each returns the raw Response from the tsdav client mock
 *
 * These tests FAIL (RED) because broker/write.ts does not exist yet.
 * They will turn GREEN in Plan 03-02 when the implementation is added.
 */

import { describe, it, expect, vi } from 'vitest'

// This import fails (RED) — broker/write.ts does not exist yet.
// eslint-disable-next-line @typescript-eslint/ban-ts-comment
// @ts-ignore intentional RED import
import {
  createCalendarEvent,
  updateCalendarEvent,
  deleteCalendarEvent,
} from '../../src/broker/write.js'

const makeMockResponse = (status: number): Response =>
  ({ status, ok: status >= 200 && status < 300, headers: new Headers() }) as unknown as Response

describe('createCalendarEvent', () => {
  it('calls client.createCalendarObject with uid.ics filename', async () => {
    const mockClient = {
      createCalendarObject: vi.fn().mockResolvedValue(makeMockResponse(201)),
    }
    const mockCalendar = { url: 'https://caldav.fastmail.com/dav/calendars/user/test@fm.com/Default/' }
    const uid = 'abc-123@familysync'
    const icsString = 'BEGIN:VCALENDAR\r\nEND:VCALENDAR'

    const result = await createCalendarEvent(mockClient as never, mockCalendar as never, uid, icsString)

    expect(mockClient.createCalendarObject).toHaveBeenCalledWith({
      calendar: mockCalendar,
      filename: `${uid}.ics`,
      iCalString: icsString,
    })
    expect(result.status).toBe(201)
  })

  it('returns the raw Response from client', async () => {
    const mockClient = {
      createCalendarObject: vi.fn().mockResolvedValue(makeMockResponse(204)),
    }
    const mockCalendar = { url: 'https://caldav.fastmail.com/' }
    const result = await createCalendarEvent(mockClient as never, mockCalendar as never, 'uid@fs', 'ICS')
    expect(result).toBeDefined()
    expect(result.status).toBe(204)
  })
})

describe('updateCalendarEvent', () => {
  it('calls client.updateCalendarObject with etag in calendarObject (If-Match)', async () => {
    const mockClient = {
      updateCalendarObject: vi.fn().mockResolvedValue(makeMockResponse(204)),
    }
    const calendarObjectUrl = 'https://caldav.fastmail.com/dav/calendars/user/test/Default/uid.ics'
    const icsString = 'BEGIN:VCALENDAR\r\nEND:VCALENDAR'
    const etag = '"etag-123"'

    const result = await updateCalendarEvent(mockClient as never, calendarObjectUrl, icsString, etag)

    expect(mockClient.updateCalendarObject).toHaveBeenCalledWith({
      calendarObject: {
        url: calendarObjectUrl,
        data: icsString,
        etag,
      },
    })
    expect(result.status).toBe(204)
  })

  it('passes empty string as etag when etag is null (safe for If-Match)', async () => {
    const mockClient = {
      updateCalendarObject: vi.fn().mockResolvedValue(makeMockResponse(204)),
    }
    await updateCalendarEvent(mockClient as never, 'https://caldav.fastmail.com/uid.ics', 'ICS', null)

    const callArg = mockClient.updateCalendarObject.mock.calls[0][0]
    expect(callArg.calendarObject.etag).toBe('')
  })
})

describe('deleteCalendarEvent', () => {
  it('calls client.deleteCalendarObject with etag in calendarObject (If-Match)', async () => {
    const mockClient = {
      deleteCalendarObject: vi.fn().mockResolvedValue(makeMockResponse(204)),
    }
    const calendarObjectUrl = 'https://caldav.fastmail.com/dav/calendars/user/test/Default/uid.ics'
    const etag = '"etag-456"'

    const result = await deleteCalendarEvent(mockClient as never, calendarObjectUrl, etag)

    expect(mockClient.deleteCalendarObject).toHaveBeenCalledWith({
      calendarObject: {
        url: calendarObjectUrl,
        data: '',
        etag,
      },
    })
    expect(result.status).toBe(204)
  })

  it('passes empty string as etag when etag is null', async () => {
    const mockClient = {
      deleteCalendarObject: vi.fn().mockResolvedValue(makeMockResponse(204)),
    }
    await deleteCalendarEvent(mockClient as never, 'https://caldav.fastmail.com/uid.ics', null)

    const callArg = mockClient.deleteCalendarObject.mock.calls[0][0]
    expect(callArg.calendarObject.etag).toBe('')
  })
})