cdav-library

:date: 📇 CalDAV and CardDAV client library for JavaScript

Build the library

# install dependencies
npm install

# build for dev and watch changes
npm run watch

# build for dev
npm run dev

# build for production with minification
npm run build

Running tests

You can use the provided npm command to run all tests by using:

npm run test

:v: Code of conduct

The Nextcloud community has core values that are shared between all members during conferences, hackweeks and on all interactions in online platforms including Github and Forums. If you contribute, participate or interact with this community, please respect our shared values. :relieved:

:heart: How to create a pull request

This guide will help you get started:

• :dancer: :smile: Opening a pull request

Changelog

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

v2.1.1 - 2025-07-22

Fixed

• Update vulnerable dependencies

v2.1.0 - 2025-05-30

Added

• Send custom default headers with each request

  Fixed

• Send OPTIONS request to acquire advertised DAV features

v2.0.0 - 2025-05-07

Breaking changes

• Removed the ability to pass a custom xhrProvider
• Removed beforeRequestHandler and afterRequestHandler callbacks from the Request class

  Added

• Pass custom abort signals to instances of the Request class
• Use @nextcloud/axios for requests (instead of raw XHR code)
• Migrate testing code to vitest

  Fixed

• Serialize namespaced attributes consistently across browsers
• Update vulnerable dependencies

v1.5.3 - 2025-03-22

Fixed

• Update vulnerable dependencies

v1.5.2 - 2024-10-14

Fixed

• Update vulnerable dependencies

v1.5.1 - 2024-07-17

Fixed

• Fix serialization of schedule-calendar-transp property

v1.5.0 - 2024-07-16

Added

• Expose scheduling transparency property

  Changed

• Dependency updates

v1.4.0 - 2024-06-10

Added

• Find principal collections
• Ship an additional ESM bundle

  Changed

• Bundle with vite instead of webpack
• Dependency updates

v1.3.0 - 2024-02-29

Added

• Implement updating a principal's schedule-default-calendar-URL

  Changed

• Update node engines to next LTS (node 20 / npm 9)
• Dependency updates

v1.2.0

Changed

• Dependency updates

  Fixed

• Type annotations

v1.1.0

Changed

• Dependency updates
• Resource search against display name and email. Now only the email is searched.