# Changelog

All notable changes to this project will be documented in this file.

This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## Contents

- [Version 8.x.x](#version-8xx)
  - [8.3.0](#830)
  - [8.2.0](#820)
  - [8.1.0](#810)
  - [8.0.2](#802)
  - [8.0.1](#801)
  - [8.0.0](#800)
- [Version 7.x.x](#version-7xx)
  - [7.2.0](#720)
  - [7.1.0](#710)
  - [7.0.0](#700)
- [Version 6.x.x](#version-6xx)
  - [6.7.2](#672)
  - [6.7.1](#671)
  - [6.7.0](#670)
  - [6.6.1](#661)
  - [6.6.0](#660)
  - [6.5.0](#650)
  - [6.4.1](#641)
  - [6.4.0](#640)
  - [6.3.0](#630)
  - [6.2.0](#620)
  - [6.1.0](#610)
  - [6.0.0](#600)
- [Version 5.x.x](#version-5xx)
  - [5.5.0](#550)
  - [5.4.1](#541)
  - [5.4.0](#540)
  - [5.3.0](#530)
  - [5.2.0](#520)
  - [5.1.0](#510)
  - [5.0.0](#500)

# Version 8.x.x

Changelogs for the versions supporting Capacitor 8.

## 8.3.0

### Added

- `span` option on Android for `deleteEvent(...)`, `deleteEventsById(...)`, and `deleteEventWithPrompt(...)`
- Optional `instanceDate` on `DeleteEventOptions` and `DeleteEventWithPromptOptions` (Android; omit with `THIS_AND_FUTURE_EVENTS` to delete the whole series)
- `commit` option on iOS for `deleteEvent(...)`, `deleteEventsById(...)`, and `deleteEventWithPrompt(...)`

### Fixed

- Android recurring delete: `THIS_EVENT` cancels one occurrence; `THIS_AND_FUTURE_EVENTS` truncates the series or deletes it when `instanceDate` is omitted

## 8.2.0

### Added

- Method to delete reminders lists on iOS with `deleteRemindersList(...)`
- Method to update reminders lists on iOS with `updateRemindersList(...)`

## 8.1.0

### Added

- Method to create reminders lists on iOS with `createRemindersList(...)`

## 8.0.2

### Fixed

- `modifyEvent` on Android was not updating `location`

## 8.0.1

### Fixed

- Deprecated `proguard-android.txt`

## 8.0.0

### Added

- Support for recurring events on Android and iOS
- Recurrence rules for `createEvent` and `createEventWithPrompt`
- Recurrence support for `modifyEvent` and `modifyEventWithPrompt`
- Listing recurring event instances correctly using expanded event occurrences on Android

### Changed

- `listEventsInRange` on Android now returns all event occurrences within the given range, including recurring events
- Recurring events on Android now correctly use `DURATION` instead of `DTEND`
- Improved consistency between iOS and Android for recurring event behavior

# Version 7.x.x

Changelogs for the versions supporting Capacitor 7.

## 7.2.0

### Added

- `modifyCalendar` on Android and iOS
- `deleteReminderWithPrompt` on iOS

## 7.1.0

### Added

- `commit()` method to apply changes to the calendar at a later time
- `createCalendar` on Android
- `deleteCalendar` on Android
- `deleteReminder` on iOS to delete a single reminder
- `getReminderById` on iOS
- `deleteEvent` on Android and iOS
- `deleteEventWithPrompt` on Android and iOS

### Changed

- `checkPermission` takes `CalendarPermissionScope` as `scope` instead of `PluginPermission`
- `checkAllPermissions` returns `{ result: CheckAllPermissionsResult; }` instead of `PluginPermissionsMap`
- `requestPermission` takes `CalendarPermissionScope` as `scope` instead of `PluginPermission`
- `requestAllPermissions` returns `{ result: RequestAllPermissionsResult; }` instead of `PluginPermissionsMap`
- `requestAllPermissions` is marked as deprecated
- `requestPermission` is marked as deprecated
- Replaced `alertOffsetInMinutes`, `notes`, and `eventIdOptional` in `createEventWithPrompt`
- `createEventWithPrompt` on Android no longer returns an id (`eventIdOptional` removed)

### Removed

- `PluginPermissionsMap`
- `PluginPermission`

## 7.0.0

### Added

- Support for Capacitor 7
- SPM support on iOS

### Removed

- Angular example app

# Version 6.x.x

Changelogs for the versions supporting Capacitor 6.

## 6.7.2

### Fixed

- Android build error related to Kotlin version

## 6.7.1

### Added

- `eventIdOptional` property to `createEventWithPrompt` on Android

## 6.7.0

### Added

- Modifying reminders on iOS

### Fixed

- Return type of `modifyEvent` on iOS

## 6.6.1

### Fixed

- Serialization error for calendar events on iOS

## 6.6.0

### Added

- Color to calendar object
- Modify events programmatically
- Modify events with prompt
- Method for fetching available calendar sources on iOS

### Fixed

- Not being able to read event color
- Not being able to read events timezone
- Error when creating event

### Removed

- Support for Capacitor 5 (this plugin will no longer receive updates for it)

## 6.5.0

### Added

- URL and notes to create options in `createEvent` and `createEventWithPrompt`
- Ability to set multiple alarms when creating events in `createEvent` and `createEventWithPrompt`

### Fixed

- `requestFullCalendarAccess` on Android was not functional

## 6.4.1

### Changed

- `getDefaultCalendar` now returns null when there is no default calendar, instead of throwing an error
- `getDefaultRemindersList` now returns null when there is no default list, instead of throwing an error

## 6.4.0

### Added

- New methods to request runtime permissions, alongside the existing permission constants

### Fixed

- `createEventWithPrompt` throwing error because of undefined event id

## 6.3.0

### Added

- Fetch reminders from selected or all reminder lists (iOS)
- Delete reminders by id (iOS)

### Fixed

- Using `isAllDay` with `createEventWithPrompt` on Android was not functional

## 6.2.0

### Added

- Create calendars (iOS)
- Delete calendars (iOS)

### Fixed

- `listCalendars` on Android returning calendar id of type number instead of string
- `createEventWithPrompt` on Android was not using all options
- `createEventWithPrompt` and `selectCalendarsWithPrompt` were throwing an error instead of returning an empty array on cancel

## 6.1.0

### Added

- Alarm support for created events

### Changed

- `createEventWithPrompt` now accepts options

### Fixed

- Misplaced code in plugin iOS implementation
- Example app missing permissions for contact on iOS 16 and lower
- Permissions documentation on iOS incomplete for iOS 16 and lower

## 6.0.0

### Added

- Check permissions
- Check all permissions
- Request permissions
- Request all permissions
- Create event with prompt
- Create event programmatically
- Select calendars with prompt (iOS)
- List calendars
- Get default calendar
- Get all reminders lists (iOS)
- Get default reminders list (iOS)
- Create reminder (iOS)
- Open calendars app
- Open reminders app (iOS)
- List events in a specified date range
- Delete events by ID

# Version 5.x.x

Changelogs for the versions supporting Capacitor 5.

## 5.5.0

### Added

- URL and notes to create options in `createEvent` and `createEventWithPrompt`
- Ability to set multiple alarms when creating events in `createEvent` and `createEventWithPrompt`

### Fixed

- `requestFullCalendarAccess` on Android was not functional

## 5.4.1

### Changed

- `getDefaultCalendar` now returns null when there is no default calendar, instead of throwing an error
- `getDefaultRemindersList` now returns null when there is no default list, instead of throwing an error

## 5.4.0

### Added

- New methods to request runtime permissions, alongside the existing permission constants

### Fixed

- `createEventWithPrompt` throwing error because of undefined event id

## 5.3.0

### Added

- Fetch reminders from selected or all reminder lists (iOS)
- Delete reminders by id (iOS)

### Fixed

- Using `isAllDay` with `createEventWithPrompt` on Android was not functional

## 5.2.0

### Added

- Create calendars (iOS)
- Delete calendars (iOS)

### Fixed

- `listCalendars` on Android returning calendar id of type number instead of string
- `createEventWithPrompt` on Android was not using all options
- `createEventWithPrompt` and `selectCalendarsWithPrompt` were throwing an error instead of returning an empty array on cancel

## 5.1.0

### Added

- Alarm support for created events

### Changed

- `createEventWithPrompt` now accepts options

### Fixed

- Misplaced code in plugin iOS implementation
- Example app missing permissions for contact on iOS 16 and lower
- Permissions documentation on iOS incomplete for iOS 16 and lower

## 5.0.0

### Added

- Check permissions
- Check all permissions
- Request permissions
- Request all permissions
- Create event with prompt
- Create event programmatically
- Select calendars with prompt (iOS)
- List calendars
- Get default calendar
- Get all reminders lists (iOS)
- Get default reminders list (iOS)
- Create reminder (iOS)
- Open calendars app
- Open reminders app (iOS)
- List events in a specified date range
- Delete events by ID