chore: prepare v2.1.8 release

Author: natelindev

.eslintrc.json

@@ -19,6 +19,25 @@
     "sourceType": "module",
     "project": "./tsconfig.json"
   },
+  "overrides": [
+    {
+      "files": ["dist/**/*", "docs/**/*"],
+      "excludedFiles": ["dist/**/*.ts", "dist/**/*.d.ts", "docs/**/*.ts", "docs/**/*.tsx"],
+      "parserOptions": {
+        "project": null
+      },
+      "rules": {
+        "@typescript-eslint/no-implied-eval": "off",
+        "@typescript-eslint/dot-notation": "off"
+      }
+    },
+    {
+      "files": ["*.js", "src/__tests__/**/*", "src/util/__tests__/**/*"],
+      "parserOptions": {
+        "project": null
+      }
+    }
+  ],
   "rules": {
     "import/prefer-default-export": "off",
     "@typescript-eslint/no-explicit-any": "off",
@@ -40,6 +59,8 @@
         "peerDependencies": false
       }
     ],
-    "import/no-cycle": 0
+    "import/no-cycle": 0,
+    "@typescript-eslint/lines-between-class-members": "off",
+    "@typescript-eslint/no-throw-literal": "off"
   }
 }

AGENTS.md

@@ -1,38 +1,46 @@
 # AGENTS
 
 ## Project Snapshot
+
 - `tsdav` is a TypeScript WebDAV client that wraps CalDAV and CardDAV workflows for browsers and Node.js (`docs/docs/intro.md`).
 - Core entry points are `createDAVClient` and `DAVClient`; for the class-based API you must call `client.login()` before issuing DAV requests.
 - Source lives in `src/`, generated bundles ship from `dist/`, while human-readable references are kept under `docs/docs/`.
 - Install dependencies with `pnpm install`; build with `pnpm build`. Jest integration targets expect provider credentials (`package.json` scripts).
 - Debug HTTP traffic by setting `DEBUG=tsdav:*` (`README.md`).
 
 ## WebDAV Building Blocks
+
 - `serviceDiscovery`, `fetchPrincipalUrl`, and `fetchHomeUrl` locate account roots via `/.well-known/` redirects (`docs/docs/webdav/account`).
 - `createAccount` enriches a `DAVAccount` with discovered URLs plus calendars/address books when supplied credentials.
 - `davRequest` is the low-level fetch wrapper shared by WebDAV, CalDAV, and CardDAV helpers (`docs/docs/webdav/davRequest.md`).
 - Object helpers map to HTTP verbs: `createObject`, `updateObject`, and `deleteObject` issue PUT/PATCH/DELETE with concurrency headers; `propfind` reads WebDAV metadata (`docs/docs/webdav`).
 
 ## CalDAV Workflow Highlights
+
 - Enumerate calendars with `fetchCalendars`; filter or retrieve objects via `fetchCalendarObjects`, `calendarMultiGet`, and `calendarQuery` (`docs/docs/caldav`).
 - Write data with `createCalendarObject`, `updateCalendarObject`, and `deleteCalendarObject`; the helpers enforce proper `If-Match`/`If-None-Match` usage.
 - `syncCalendars` and `smartCollectionSync` surface server-side `sync-token`/`ctag` deltas for incremental syncs.
 - `smart calendar sync.md` documents end-to-end two-way sync: recommended database schema, handling created/updated/deleted objects, and when to fall back to multi-get.
 
 ## CardDAV Workflow Highlights
+
 - `fetchAddressBooks` discovers address books; `fetchVCards`, `addressBookMultiGet`, and `addressBookQuery` return contact payloads (`docs/docs/carddav`).
 - CRUD mirrors CalDAV: `createVCard`, `updateVCard`, and `deleteVCard` manage `.vcf` resources while honoring provider-specific UID behavior.
 
 ## Helpers and Types
+
 - `docs/docs/helper.mdx` exposes the XML ⇄ JS converter to assemble ElementCompact request bodies without manual XML string building.
 - Typed shapes such as `DAVAccount`, `DAVCalendar`, `DAVCalendarObject`, `DAVAddressBook`, `ElementCompact`, and credential tokens are documented in `docs/docs/types/`.
 - Most high-level functions accept `headers`, `headersToExclude`, and `fetchOptions` overrides—ensure custom auth headers align with provider requirements.
+- You can override the underlying `fetch` implementation for custom transports (Electron, KaiOS, Workers); see `docs/docs/intro.md` and `docs/docs/cloud providers.md`.
 
 ## Cloud Provider Notes
+
 - Credential setup differs across providers (Apple app-specific passwords, Google OAuth refresh tokens, Fastmail app passwords) (`docs/docs/cloud providers.md`).
 - Expect quirks such as Google renaming objects to UID-based filenames, Zoho preventing duplicate UIDs, and Nextcloud renaming on delete; design agents to normalize URLs before diffing.
 
 ## Field Tips for Agents
+
 - Always normalize calendar object URLs using `URL.resolve` when combining parent collection URLs with relative paths (see smart sync example).
 - When overriding CalDAV/CardDAV `props`, keep required fields (`supported-calendar-component-set`, `resourcetype`) to prevent server errors.
 - Reuse helper predicates (`urlFilter`, `useMultiGet`) for providers that emit non-`.ics` or non-`.vcf` keys.

CHANGELOG.md

@@ -4,6 +4,12 @@
 
 - fixed [#272](https://github.com/natelindev/tsdav/issues/272) malformed expand request in fetchCalendarObjects
 - optimized fetchCalendarObjects to reduce redundant requests when expand is true
+- added Bearer auth support for token-based providers (e.g., Nextcloud OIDC)
+- added fetch overrides across account, request, and collection helpers for custom transports
+- prefer native fetch in Cloudflare Workers to avoid cross-fetch incompatibilities
+- collectionQuery now rejects on non-OK responses instead of returning empty arrays
+- fetchVCards filters out collection URLs to avoid empty/invalid entries (Radicale-compatible)
+- docs updates for iCal feed import, providers, and custom transport guidance
 
 ## v2.1.7
 

dist/index.d.ts

@@ -9,7 +9,7 @@ export { davRequest, propfind, createObject, updateObject, deleteObject } from '
 export { collectionQuery, supportedReportSet, isCollectionDirty, syncCollection, smartCollectionSync, } from './collection';
 export { calendarQuery, calendarMultiGet, makeCalendar, fetchCalendars, fetchCalendarUserAddresses, fetchCalendarObjects, createCalendarObject, updateCalendarObject, deleteCalendarObject, syncCalendars, freeBusyQuery, } from './calendar';
 export { addressBookQuery, addressBookMultiGet, fetchAddressBooks, fetchVCards, createVCard, updateVCard, deleteVCard, } from './addressBook';
-export { getBasicAuthHeaders, getOauthHeaders, fetchOauthTokens, refreshAccessToken, } from './util/authHelpers';
+export { getBasicAuthHeaders, getBearerAuthHeaders, getOauthHeaders, fetchOauthTokens, refreshAccessToken, } from './util/authHelpers';
 export { urlContains, urlEquals, getDAVAttribute, cleanupFalsy } from './util/requestHelpers';
 export { DAVNamespace, DAVAttributeMap, DAVNamespaceShort } from './consts';
 declare const _default: {

dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tsdav",
-  "version": "2.1.7",
+  "version": "2.1.8",
   "description": "WebDAV, CALDAV, and CARDDAV client for Nodejs and the Browser",
   "keywords": [
     "dav",
@@ -32,6 +32,7 @@
   ],
   "scripts": {
     "build": "pnpm -s clean && rollup -c rollup.config.mjs && copyfiles package.json LICENSE README.md ./dist && rimraf ./dist/ts",
+    "lint": "eslint --ext .ts,.tsx src --ignore-pattern src/__tests__ --ignore-pattern src/util/__tests__",
     "clean": "rimraf dist*",
     "prepublishOnly": "pnpm build",
     "test": "jest --testPathPatterns=src/__tests__/unit",
@@ -65,7 +66,7 @@
     "copyfiles": "2.4.1",
     "cross-env": "10.1.0",
     "dotenv": "17.2.3",
-    "eslint": "9.39.2",
+    "eslint": "8.57.0",
     "eslint-config-airbnb": "19.0.4",
     "eslint-config-airbnb-typescript": "18.0.0",
     "eslint-config-prettier": "10.1.8",

dist/tsdav.cjs

@@ -2111,6 +2111,7 @@ exports.fetchOauthTokens = fetchOauthTokens;
 exports.fetchVCards = fetchVCards;
 exports.freeBusyQuery = freeBusyQuery;
 exports.getBasicAuthHeaders = getBasicAuthHeaders;
+exports.getBearerAuthHeaders = getBearerAuthHeaders;
 exports.getDAVAttribute = getDAVAttribute;
 exports.getOauthHeaders = getOauthHeaders;
 exports.isCollectionDirty = isCollectionDirty;

dist/tsdav.cjs.js

@@ -2111,6 +2111,7 @@ exports.fetchOauthTokens = fetchOauthTokens;
 exports.fetchVCards = fetchVCards;
 exports.freeBusyQuery = freeBusyQuery;
 exports.getBasicAuthHeaders = getBasicAuthHeaders;
+exports.getBearerAuthHeaders = getBearerAuthHeaders;
 exports.getDAVAttribute = getDAVAttribute;
 exports.getOauthHeaders = getOauthHeaders;
 exports.isCollectionDirty = isCollectionDirty;

dist/tsdav.d.ts

@@ -804,6 +804,9 @@ declare const createAccount: (params: {
 declare const getBasicAuthHeaders: (credentials: DAVCredentials) => {
     authorization?: string;
 };
+declare const getBearerAuthHeaders: (credentials: DAVCredentials) => {
+    authorization?: string;
+};
 declare const fetchOauthTokens: (credentials: DAVCredentials, fetchOptions?: RequestInit, fetchOverride?: typeof fetch$1) => Promise<DAVTokens>;
 declare const refreshAccessToken: (credentials: DAVCredentials, fetchOptions?: RequestInit, fetchOverride?: typeof fetch$1) => Promise<{
     access_token?: string;
@@ -1397,5 +1400,5 @@ declare const _default: {
     };
 };
 
-export { DAVAttributeMap, DAVClient, DAVNamespace, DAVNamespaceShort, addressBookMultiGet, addressBookQuery, calendarMultiGet, calendarQuery, cleanupFalsy, collectionQuery, createAccount, createCalendarObject, createDAVClient, createObject, createVCard, davRequest, _default as default, deleteCalendarObject, deleteObject, deleteVCard, fetchAddressBooks, fetchCalendarObjects, fetchCalendarUserAddresses, fetchCalendars, fetchOauthTokens, fetchVCards, freeBusyQuery, getBasicAuthHeaders, getDAVAttribute, getOauthHeaders, isCollectionDirty, makeCalendar, propfind, refreshAccessToken, smartCollectionSync, supportedReportSet, syncCalendars, syncCollection, updateCalendarObject, updateObject, updateVCard, urlContains, urlEquals };
+export { DAVAttributeMap, DAVClient, DAVNamespace, DAVNamespaceShort, addressBookMultiGet, addressBookQuery, calendarMultiGet, calendarQuery, cleanupFalsy, collectionQuery, createAccount, createCalendarObject, createDAVClient, createObject, createVCard, davRequest, _default as default, deleteCalendarObject, deleteObject, deleteVCard, fetchAddressBooks, fetchCalendarObjects, fetchCalendarUserAddresses, fetchCalendars, fetchOauthTokens, fetchVCards, freeBusyQuery, getBasicAuthHeaders, getBearerAuthHeaders, getDAVAttribute, getOauthHeaders, isCollectionDirty, makeCalendar, propfind, refreshAccessToken, smartCollectionSync, supportedReportSet, syncCalendars, syncCollection, updateCalendarObject, updateObject, updateVCard, urlContains, urlEquals };
 export type { DAVAccount, DAVAddressBook, DAVCalendar, DAVCalendarObject, DAVCollection, DAVCredentials, DAVDepth, DAVMethods, DAVObject, DAVRequest, DAVResponse, DAVTokens, DAVVCard };

dist/tsdav.esm.js

@@ -2081,4 +2081,4 @@ var index = {
     ...requestHelpers,
 };
 
-export { DAVAttributeMap, DAVClient, DAVNamespace, DAVNamespaceShort, addressBookMultiGet, addressBookQuery, calendarMultiGet, calendarQuery, cleanupFalsy, collectionQuery, createAccount, createCalendarObject, createDAVClient, createObject, createVCard, davRequest, index as default, deleteCalendarObject, deleteObject, deleteVCard, fetchAddressBooks, fetchCalendarObjects, fetchCalendarUserAddresses, fetchCalendars, fetchOauthTokens, fetchVCards, freeBusyQuery, getBasicAuthHeaders, getDAVAttribute, getOauthHeaders, isCollectionDirty, makeCalendar, propfind, refreshAccessToken, smartCollectionSync, supportedReportSet, syncCalendars, syncCollection, updateCalendarObject, updateObject, updateVCard, urlContains, urlEquals };
+export { DAVAttributeMap, DAVClient, DAVNamespace, DAVNamespaceShort, addressBookMultiGet, addressBookQuery, calendarMultiGet, calendarQuery, cleanupFalsy, collectionQuery, createAccount, createCalendarObject, createDAVClient, createObject, createVCard, davRequest, index as default, deleteCalendarObject, deleteObject, deleteVCard, fetchAddressBooks, fetchCalendarObjects, fetchCalendarUserAddresses, fetchCalendars, fetchOauthTokens, fetchVCards, freeBusyQuery, getBasicAuthHeaders, getBearerAuthHeaders, getDAVAttribute, getOauthHeaders, isCollectionDirty, makeCalendar, propfind, refreshAccessToken, smartCollectionSync, supportedReportSet, syncCalendars, syncCollection, updateCalendarObject, updateObject, updateVCard, urlContains, urlEquals };

dist/tsdav.js

@@ -11447,4 +11447,4 @@ var index = {
     ...requestHelpers,
 };
 
-export { DAVAttributeMap, DAVClient, DAVNamespace, DAVNamespaceShort, addressBookMultiGet, addressBookQuery, calendarMultiGet, calendarQuery, cleanupFalsy, collectionQuery, createAccount, createCalendarObject, createDAVClient, createObject, createVCard, davRequest, index as default, deleteCalendarObject, deleteObject, deleteVCard, fetchAddressBooks, fetchCalendarObjects, fetchCalendarUserAddresses, fetchCalendars, fetchOauthTokens, fetchVCards, freeBusyQuery, getBasicAuthHeaders, getDAVAttribute, getOauthHeaders, isCollectionDirty, makeCalendar, propfind, refreshAccessToken, smartCollectionSync, supportedReportSet, syncCalendars, syncCollection, updateCalendarObject, updateObject, updateVCard, urlContains, urlEquals };
+export { DAVAttributeMap, DAVClient, DAVNamespace, DAVNamespaceShort, addressBookMultiGet, addressBookQuery, calendarMultiGet, calendarQuery, cleanupFalsy, collectionQuery, createAccount, createCalendarObject, createDAVClient, createObject, createVCard, davRequest, index as default, deleteCalendarObject, deleteObject, deleteVCard, fetchAddressBooks, fetchCalendarObjects, fetchCalendarUserAddresses, fetchCalendars, fetchOauthTokens, fetchVCards, freeBusyQuery, getBasicAuthHeaders, getBearerAuthHeaders, getDAVAttribute, getOauthHeaders, isCollectionDirty, makeCalendar, propfind, refreshAccessToken, smartCollectionSync, supportedReportSet, syncCalendars, syncCollection, updateCalendarObject, updateObject, updateVCard, urlContains, urlEquals };