expo-calendar/src/ExpoCalendar.ts

Provides an API for interacting with the device's system calendars, events, reminders, and associated records.

import { isRunningInExpoGo, type PermissionResponse } from 'expo';
import { NativeModule, requireNativeModule } from 'expo-modules-core';
import type { ProcessedColorValue } from 'react-native';

import type {
  ExpoCalendar,
  ExpoCalendarAttendee,
  ExpoCalendarEvent,
  ExpoCalendarReminder,
} from './ExpoCalendar.types';
import ExpoGoCalendarNextStub from './ExpoGoCalendarNextStub';
import type { Calendar, EntityTypes, Source } from './legacy/Calendar';

declare class ExpoCalendarNextModule extends NativeModule {
  ExpoCalendar: typeof ExpoCalendar;
  ExpoCalendarEvent: typeof ExpoCalendarEvent;
  ExpoCalendarAttendee: typeof ExpoCalendarAttendee;
  ExpoCalendarReminder: typeof ExpoCalendarReminder;

  createCalendar(
    details: Omit<Partial<Calendar>, 'color'> & { color: ProcessedColorValue | undefined }
  ): Promise<ExpoCalendar>;

  getDefaultCalendar(): ExpoCalendar;
  getDefaultCalendarSync(): unknown;
  getCalendars(type?: EntityTypes): Promise<ExpoCalendar[]>;

  listEvents(
    calendars: string[],
    startDate: string | Date,
    endDate: string | Date
  ): Promise<ExpoCalendarEvent[]>;

  getCalendarById(calendarId: string): Promise<ExpoCalendar>;
  presentPicker(): Promise<ExpoCalendar | null>;
  getEventById(eventId: string): Promise<ExpoCalendarEvent>;
  getReminderById(reminderId: string): Promise<ExpoCalendarReminder>;

  requestCalendarPermissions(writeOnly?: boolean): Promise<PermissionResponse>;
  getCalendarPermissions(writeOnly?: boolean): Promise<PermissionResponse>;
  requestRemindersPermissions(): Promise<PermissionResponse>;
  getRemindersPermissions(): Promise<PermissionResponse>;

  getSourcesSync(): Source[];
}

export default isRunningInExpoGo()
  ? (ExpoGoCalendarNextStub as any as ExpoCalendarNextModule)
  : requireNativeModule<ExpoCalendarNextModule>('CalendarNext');