import { resolveMicrosoftIntegration, type MicrosoftAccountParams } from './accounts.ts' import { graphItems, graphRequest, requireConfirmOrDryRun, type JsonObject } from './core.ts' import { boundedTop } from './validation.ts' export type CalendarListParams = MicrosoftAccountParams & { top?: number } export type CalendarEventsParams = MicrosoftAccountParams & { calendarId?: string startDateTime?: string endDateTime?: string top?: number filter?: string search?: string orderBy?: string select?: string } export type CalendarEventGetParams = MicrosoftAccountParams & { eventId: string calendarId?: string select?: string } export type CalendarEventMutationParams = MicrosoftAccountParams & { calendarId?: string event: JsonObject dryRun?: boolean confirm?: boolean } export type CalendarEventUpdateParams = CalendarEventMutationParams & { eventId: string } const EVENT_SELECT = 'id,subject,start,end,location,organizer,attendees,isAllDay,showAs,webLink,onlineMeeting,bodyPreview' function eventsPath(calendarId?: string): string { return calendarId ? '/me/calendars/' + encodeURIComponent(calendarId) + '/events' : '/me/events' } function calendarViewPath(calendarId?: string): string { return calendarId ? '/me/calendars/' + encodeURIComponent(calendarId) + '/calendarView' : '/me/calendarView' } /** List calendars the signed-in user can access. */ export async function listCalendars(params: CalendarListParams = {}) { const data = await graphRequest({ integration: resolveMicrosoftIntegration(params), path: '/me/calendars', query: { $top: boundedTop(params.top, 20, 100), $select: 'id,name,color,isDefaultCalendar,canEdit,owner', }, }) return graphItems(data) } /** List events. Pass startDateTime+endDateTime to use calendarView. */ export async function listEvents(params: CalendarEventsParams = {}) { const top = boundedTop(params.top, 10) const select = params.select ?? EVENT_SELECT const query: Record = { $top: top, $select: select, $orderby: params.orderBy, $filter: params.filter, } if (params.search) query.$search = '"' + params.search.replace(/"/g, '\\"') + '"' const ranged = Boolean(params.startDateTime && params.endDateTime) if (ranged) { query.startDateTime = params.startDateTime query.endDateTime = params.endDateTime } const data = await graphRequest({ integration: resolveMicrosoftIntegration(params), path: ranged ? calendarViewPath(params.calendarId) : eventsPath(params.calendarId), query, }) return graphItems(data) } /** Read one calendar event. */ export async function getEvent(params: CalendarEventGetParams) { const eventId = params.eventId?.trim() if (!eventId) throw new Error('getEvent requires eventId.') const path = params.calendarId ? '/me/calendars/' + encodeURIComponent(params.calendarId) + '/events/' + encodeURIComponent(eventId) : '/me/events/' + encodeURIComponent(eventId) return graphRequest({ integration: resolveMicrosoftIntegration(params), path, query: { $select: params.select ?? EVENT_SELECT + ',body' }, }) } /** Preview or create a calendar event. Creating requires confirm: true. */ export async function createEvent(params: CalendarEventMutationParams) { if (!params.event || typeof params.event !== 'object') { throw new Error('createEvent requires event.') } const path = eventsPath(params.calendarId) const mode = requireConfirmOrDryRun({ dryRun: params.dryRun, confirm: params.confirm, action: 'createEvent', }) if (mode.dryRun) { return { dryRun: true as const, method: 'POST', path, body: params.event } } return graphRequest({ integration: resolveMicrosoftIntegration(params), method: 'POST', path, body: params.event, }) } /** Preview or patch a calendar event. Updating requires confirm: true. */ export async function updateEvent(params: CalendarEventUpdateParams) { const eventId = params.eventId?.trim() if (!eventId) throw new Error('updateEvent requires eventId.') if (!params.event || typeof params.event !== 'object') { throw new Error('updateEvent requires event.') } const path = params.calendarId ? '/me/calendars/' + encodeURIComponent(params.calendarId) + '/events/' + encodeURIComponent(eventId) : '/me/events/' + encodeURIComponent(eventId) const mode = requireConfirmOrDryRun({ dryRun: params.dryRun, confirm: params.confirm, action: 'updateEvent', }) if (mode.dryRun) { return { dryRun: true as const, method: 'PATCH', path, body: params.event } } return graphRequest({ integration: resolveMicrosoftIntegration(params), method: 'PATCH', path, body: params.event, }) } /** * Outlook calendar helpers for Microsoft Graph. * @example * import calendar from 'kody:@kody/microsoft/calendar' * const { items } = await calendar().listEvents({ startDateTime: '2026-08-22T00:00:00Z', endDateTime: '2026-08-23T00:00:00Z' }) */ export default function calendar() { return { listCalendars, listEvents, getEvent, createEvent, updateEvent } }