/**
 * microsoft-graph-api.ts, the Microsoft Graph client over an access token and the
 * injected HttpFetch. Lists calendars (me/calendars), lists events over a window
 * (me/calendars/{id}/calendarView, which returns expanded instances), and creates
 * events (me/calendars/{id}/events). A Prefer: outlook.timezone="UTC" header makes
 * Graph return UTC wall times so normalization is honest. Paging follows
 * @odata.nextLink; failures are named degraded states via CalendarApiError.
 */
import type { HttpFetch, MergedCalendarEvent, NewCalendarEvent, ProviderCalendar } from './oauth-types.js';
/** List the user's calendars; write access comes from canEdit. */
export declare function listGraphCalendars(fetchImpl: HttpFetch, token: string): Promise<ProviderCalendar[]>;
export interface GraphEventsQuery {
    readonly calendarId: string;
    readonly calendarLabel: string;
    /** ISO lower bound, e.g. '2026-07-01T00:00:00Z'. */
    readonly start: string;
    /** ISO upper bound. */
    readonly end: string;
    readonly pageSize?: number;
}
/** List events over a window via calendarView, paging @odata.nextLink to exhaustion. */
export declare function listGraphEvents(fetchImpl: HttpFetch, token: string, query: GraphEventsQuery): Promise<MergedCalendarEvent[]>;
/** Create an event; returns it normalized into the merged model. */
export declare function createGraphEvent(fetchImpl: HttpFetch, token: string, calendarId: string, calendarLabel: string, event: NewCalendarEvent): Promise<MergedCalendarEvent>;
//# sourceMappingURL=microsoft-graph-api.d.ts.map