feat: allow calendar-wide only-availability share setting

src/components/AppNavigation/EditCalendarModal.vue

@@ -34,6 +34,11 @@
 					{{ $t('calendar', 'Never show me as busy (set this calendar to transparent)') }}
 				</NcCheckboxRadioSwitch>
 			</template>
+			<template v-if="canBeShared">
+				<NcCheckboxRadioSwitch :checked.sync="isOnlyAvailability">
+					{{ $t('calendar', 'Don’t show event details to others') }}
+				</NcCheckboxRadioSwitch>
+			</template>
 			<template v-if="canBeShared">
 				<h3 class="edit-calendar-modal__sharing-header">
 					{{ $t('calendar', 'Share calendar') }}
@@ -119,6 +124,7 @@ export default {
 			calendarColor: undefined,
 			calendarColorChanged: false,
 			isTransparent: false,
+			isOnlyAvailability: false,
 			calendarName: undefined,
 			calendarNameChanged: false,
 		}
@@ -180,6 +186,7 @@ export default {
 			this.calendarNameChanged = false
 			this.calendarColorChanged = false
 			this.isTransparent = calendar.transparency === 'transparent'
+			this.isOnlyAvailability = calendar.onlyAvailability
 		},
 	},
 
@@ -227,6 +234,24 @@ export default {
 			}
 		},
 
+		/**
+		 * Save the calendar share property of only showing availability
+		 */
+		async saveShareOnlyAvailability() {
+			try {
+				await this.calendarsStore.changeCalendarShareOnlyAvailability({
+					calendar: this.calendar,
+					onlyAvailability: this.isOnlyAvailability,
+				})
+			} catch (error) {
+				logger.error('Failed to save calendar transparency', {
+					calendar: this.calendar,
+					onlyAvailability: this.isOnlyAvailability,
+				})
+				throw error
+			}
+		},
+
 		/**
 		 * Save the calendar name.
 		 */
@@ -256,6 +281,7 @@ export default {
 					await this.saveColor()
 				}
 				await this.saveTransparency()
+				await this.saveShareOnlyAvailability()
 				if (this.calendarNameChanged) {
 					await this.saveName()
 				}

src/models/calendar.js

@@ -56,6 +56,8 @@ function getDefaultCalendarObject(props = {}) {
 		fetchedTimeRanges: [],
 		// Scheduling transparency
 		transparency: 'opaque',
+		// Shared option to only show free/busy
+		onlyAvailability: false,
 		...props,
 	}
 }
@@ -130,6 +132,8 @@ function mapDavCollectionToCalendar(calendar, currentUserPrincipal) {
 		}
 	}
 
+	const onlyAvailability = false
+
 	return getDefaultCalendarObject({
 		id,
 		displayName,
@@ -149,6 +153,7 @@ function mapDavCollectionToCalendar(calendar, currentUserPrincipal) {
 		shares,
 		timezone,
 		transparency,
+		onlyAvailability,
 		dav: calendar,
 	})
 }

src/store/calendars.js

@@ -591,6 +591,25 @@ export default defineStore('calendars', {
 			this.calendarsById[calendar.id].transparency = transparency
 		},
 
+		/**
+		 * Change if a calendar share only shows availability (instead of full event details)
+		 *
+		 * @param {object} data destructuring object
+		 * @param {object} data.calendar the calendar to modify
+		 * @param {string} data.shareOnlyAvailability the new value for sharing only avaliability
+		 * @return {Promise}
+		 */
+		async changeCalendarShareOnlyAvailability({ calendar, shareOnlyAvailability }) {
+			if (calendar.dav.onlyAvailability === shareOnlyAvailability) {
+				return
+			}
+
+			calendar.dav.onlyAvailability = shareOnlyAvailability
+
+			await calendar.dav.update()
+			this.calendarsById[calendar.id].onlyAvailability = shareOnlyAvailability
+		},
+
 		/**
 		 * Share calendar with User or Group
 		 *

tests/javascript/unit/models/calendar.test.js

@@ -39,6 +39,7 @@ describe('Test suite: Calendar model (models/calendar.js)', () => {
 			calendarObjects: [],
 			fetchedTimeRanges: [],
 			transparency: 'opaque',
+			onlyAvailability: false,
 		})
 	})
 
@@ -70,6 +71,7 @@ describe('Test suite: Calendar model (models/calendar.js)', () => {
 			calendarObjects: [],
 			fetchedTimeRanges: [],
 			transparency: 'opaque',
+			onlyAvailability: false,
 		})
 	})
 
@@ -88,6 +90,7 @@ describe('Test suite: Calendar model (models/calendar.js)', () => {
 			enabled: true,
 			timezone: 'BEGIN:VCALENDAR...END:VCALENDAR',
 			transparency: 'opaque',
+			onlyAvailability: false,
 		}
 
 		expect(mapDavCollectionToCalendar(cdavObject, {
@@ -111,6 +114,7 @@ describe('Test suite: Calendar model (models/calendar.js)', () => {
 			isSharedWithMe: false,
 			timezone: 'BEGIN:VCALENDAR...END:VCALENDAR',
 			transparency: 'opaque',
+			onlyAvailability: false,
 			url: '/foo/bar',
 			calendarObjects: [],
 			fetchedTimeRanges: [],
@@ -134,6 +138,7 @@ describe('Test suite: Calendar model (models/calendar.js)', () => {
 			publishURL: undefined,
 			timezone: 'BEGIN:VCALENDAR...END:VCALENDAR',
 			transparency: 'transparent',
+			onlyAvailability: false,
 			enabled: false,
 		}
 
@@ -158,6 +163,7 @@ describe('Test suite: Calendar model (models/calendar.js)', () => {
 			isSharedWithMe: false,
 			timezone: 'BEGIN:VCALENDAR...END:VCALENDAR',
 			transparency: 'transparent',
+			onlyAvailability: false,
 			url: '/foo/bar',
 			calendarObjects: [],
 			fetchedTimeRanges: [],
@@ -203,6 +209,7 @@ describe('Test suite: Calendar model (models/calendar.js)', () => {
 			isSharedWithMe: false,
 			timezone: null,
 			transparency: 'opaque',
+			onlyAvailability: false,
 			url: '/foo/bar',
 			calendarObjects: [],
 			fetchedTimeRanges: [],
@@ -248,6 +255,7 @@ describe('Test suite: Calendar model (models/calendar.js)', () => {
 			isSharedWithMe: true,
 			timezone: null,
 			transparency: 'opaque',
+			onlyAvailability: false,
 			url: '/foo/bar',
 			calendarObjects: [],
 			fetchedTimeRanges: [],
@@ -293,6 +301,7 @@ describe('Test suite: Calendar model (models/calendar.js)', () => {
 			isSharedWithMe: false,
 			timezone: null,
 			transparency: 'opaque',
+			onlyAvailability: false,
 			url: '/foo/bar',
 			calendarObjects: [],
 			fetchedTimeRanges: [],
@@ -338,6 +347,7 @@ describe('Test suite: Calendar model (models/calendar.js)', () => {
 			isSharedWithMe: false,
 			timezone: null,
 			transparency: 'opaque',
+			onlyAvailability: false,
 			url: '/foo/bar',
 			calendarObjects: [],
 			fetchedTimeRanges: [],
@@ -383,6 +393,7 @@ describe('Test suite: Calendar model (models/calendar.js)', () => {
 			isSharedWithMe: false,
 			timezone: null,
 			transparency: 'opaque',
+			onlyAvailability: false,
 			url: '/foo/bar',
 			calendarObjects: [],
 			fetchedTimeRanges: [],
@@ -428,6 +439,7 @@ describe('Test suite: Calendar model (models/calendar.js)', () => {
 			isSharedWithMe: false,
 			timezone: null,
 			transparency: 'opaque',
+			onlyAvailability: false,
 			url: '/foo/bar',
 			calendarObjects: [],
 			fetchedTimeRanges: [],
@@ -529,6 +541,7 @@ describe('Test suite: Calendar model (models/calendar.js)', () => {
 			isSharedWithMe: false,
 			timezone: null,
 			transparency: 'opaque',
+			onlyAvailability: false,
 			url: '/foo/bar',
 			calendarObjects: [],
 			fetchedTimeRanges: [],
@@ -646,6 +659,7 @@ describe('Test suite: Calendar model (models/calendar.js)', () => {
 			isSharedWithMe: true,
 			timezone: null,
 			transparency: 'opaque',
+			onlyAvailability: false,
 			url: '/foo/bar',
 			calendarObjects: [],
 			fetchedTimeRanges: [],
@@ -692,6 +706,7 @@ describe('Test suite: Calendar model (models/calendar.js)', () => {
 			isSharedWithMe: false,
 			timezone: 'BEGIN:VCALENDAR...END:VCALENDAR',
 			transparency: 'opaque',
+			onlyAvailability: false,
 			url: '/remote.php/dav/calendars/admin/personal/',
 			calendarObjects: [],
 			fetchedTimeRanges: [],