From c1a408e8e0bc9df791c5a066bd1e44f8408417e6 Mon Sep 17 00:00:00 2001
From: Anna Larch <anna@nextcloud.com>
Date: Tue, 16 Jul 2024 00:43:01 +0200
Subject: [PATCH] parent 7e436be6975dacd96f718f67dd61818190e85a3c author Anna
 Larch <anna@nextcloud.com> 1721083381 +0200 committer Anna Larch
 <anna@nextcloud.com> 1721726554 +0200

feat: allow calendar-wide transparency settings

Signed-off-by: Anna Larch <anna@nextcloud.com>
---
 .../AppNavigation/EditCalendarModal.vue       | 36 +++++++++++++++++--
 src/models/calendar.js                        |  7 ++++
 src/store/calendars.js                        | 19 ++++++++++
 tests/javascript/unit/models/calendar.test.js | 21 +++++++++--
 4 files changed, 77 insertions(+), 6 deletions(-)

diff --git a/src/components/AppNavigation/EditCalendarModal.vue b/src/components/AppNavigation/EditCalendarModal.vue
index 7372b5e52..8fecd482c 100644
--- a/src/components/AppNavigation/EditCalendarModal.vue
+++ b/src/components/AppNavigation/EditCalendarModal.vue
@@ -24,7 +24,11 @@
 					:placeholder="$t('calendar', 'Calendar name …')"
 					@input="calendarNameChanged = true">
 			</div>
-
+			<template v-if="canBeShared">
+				<NcCheckboxRadioSwitch :checked.sync="isTransparent">
+					{{ $t('calendar', 'Never show me as busy (set this calendar to transparent)') }}
+				</NcCheckboxRadioSwitch>
+			</template>
 			<template v-if="canBeShared">
 				<h2 class="edit-calendar-modal__sharing-header">
 					{{ $t('calendar', 'Share calendar') }}
@@ -72,7 +76,7 @@
 </template>
 
 <script>
-import { NcModal, NcColorPicker, NcButton, NcAppNavigationSpacer } from '@nextcloud/vue'
+import { NcModal, NcColorPicker, NcButton, NcCheckboxRadioSwitch, NcAppNavigationSpacer } from '@nextcloud/vue'
 import PublishCalendar from './EditCalendarModal/PublishCalendar.vue'
 import SharingSearch from './EditCalendarModal/SharingSearch.vue'
 import ShareItem from './EditCalendarModal/ShareItem.vue'
@@ -101,11 +105,13 @@ export default {
 		CheckIcon,
 		InternalLink,
 		NcAppNavigationSpacer,
+		NcCheckboxRadioSwitch,
 	},
 	data() {
 		return {
 			calendarColor: undefined,
 			calendarColorChanged: false,
+			isTransparent: false,
 			calendarName: undefined,
 			calendarNameChanged: false,
 		}
@@ -164,6 +170,7 @@ export default {
 			this.calendarColor = calendar.color
 			this.calendarNameChanged = false
 			this.calendarColorChanged = false
+			this.isTransparent = calendar.transparency === 'transparent'
 		},
 	},
 	methods: {
@@ -192,6 +199,24 @@ export default {
 			}
 		},
 
+		/**
+		 * Save the calendar transparency.
+		 */
+		async saveTransparency() {
+			try {
+				await this.calendarsStore.changeCalendarTransparency({
+					calendar: this.calendar,
+					transparency: this.isTransparent ? 'transparent' : 'opaque',
+				})
+			} catch (error) {
+				logger.error('Failed to save calendar transparency', {
+					calendar: this.calendar,
+					transparency: this.isTransparent ? 'transparent' : 'opaque',
+				})
+				throw error
+			}
+		},
+
 		/**
 		 * Save the calendar name.
 		 */
@@ -220,6 +245,7 @@ export default {
 				if (this.calendarColorChanged) {
 					await this.saveColor()
 				}
+				await this.saveTransparency()
 				if (this.calendarNameChanged) {
 					await this.saveName()
 				}
@@ -243,7 +269,7 @@ export default {
 }
 </script>
 
-<style lang="scss" scoped>
+<style lang="scss">
 .edit-calendar-modal {
 	padding: 20px;
 	display: flex;
@@ -287,6 +313,10 @@ export default {
 		flex-direction: column;
 		gap: 5px;
 	}
+
+	.checkbox-content {
+		margin-left: 25px;
+	}
 }
 
 .app-navigation-spacer {
diff --git a/src/models/calendar.js b/src/models/calendar.js
index 8e57fafd6..80f5bf0ef 100644
--- a/src/models/calendar.js
+++ b/src/models/calendar.js
@@ -54,6 +54,8 @@ const getDefaultCalendarObject = (props = {}) => Object.assign({}, {
 	calendarObjects: [],
 	// Time-ranges that have already been fetched for this calendar
 	fetchedTimeRanges: [],
+	// Scheduling transparency
+	transparency: 'opaque',
 }, props)
 
 /**
@@ -86,6 +88,10 @@ const mapDavCollectionToCalendar = (calendar, currentUserPrincipal) => {
 	const url = calendar.url
 	const publishURL = calendar.publishURL || null
 	const timezone = calendar.timezone || null
+	// If this property is not present on a calendar collection,
+	// then the default value CALDAV:opaque MUST be assumed.
+	// https://datatracker.ietf.org/doc/html/rfc6638#section-9.1
+	const transparency = calendar.transparency || 'opaque'
 
 	let isSharedWithMe = false
 	if (!currentUserPrincipal) {
@@ -140,6 +146,7 @@ const mapDavCollectionToCalendar = (calendar, currentUserPrincipal) => {
 		canBePublished,
 		shares,
 		timezone,
+		transparency,
 		dav: calendar,
 	})
 }
diff --git a/src/store/calendars.js b/src/store/calendars.js
index 2027ad235..b8b860081 100644
--- a/src/store/calendars.js
+++ b/src/store/calendars.js
@@ -537,6 +537,25 @@ export default defineStore('calendars', {
 			this.calendarsById[calendar.id].color = newColor
 		},
 
+		/**
+		 * Change a calendars transparency
+		 *
+		 * @param {object} data destructuring object
+		 * @param {object} data.calendar the calendar to modify
+		 * @param {string} data.transparency the new transparency
+		 * @return {Promise}
+		 */
+		async changeCalendarTransparency({ calendar, transparency }) {
+			if (calendar.dav.transparency === transparency) {
+				return
+			}
+
+			calendar.dav.transparency = transparency
+
+			await calendar.dav.update()
+			this.calendarsById[calendar.id].transparency = transparency
+		},
+
 		/**
 		 * Share calendar with User or Group
 		 *
diff --git a/tests/javascript/unit/models/calendar.test.js b/tests/javascript/unit/models/calendar.test.js
index 720c41a2c..2121c08c7 100644
--- a/tests/javascript/unit/models/calendar.test.js
+++ b/tests/javascript/unit/models/calendar.test.js
@@ -37,7 +37,8 @@ describe('Test suite: Calendar model (models/calendar.js)', () => {
 			canBePublished: false,
 			dav: false,
 			calendarObjects: [],
-			fetchedTimeRanges: []
+			fetchedTimeRanges: [],
+			transparency: 'opaque',
 		})
 	})
 
@@ -67,7 +68,8 @@ describe('Test suite: Calendar model (models/calendar.js)', () => {
 			canBePublished: false,
 			dav: false,
 			calendarObjects: [],
-			fetchedTimeRanges: []
+			fetchedTimeRanges: [],
+			transparency: 'opaque',
 		})
 	})
 
@@ -85,6 +87,7 @@ describe('Test suite: Calendar model (models/calendar.js)', () => {
 			publishURL: undefined,
 			enabled: true,
 			timezone: 'BEGIN:VCALENDAR...END:VCALENDAR',
+			transparency: 'opaque',
 		}
 
 		expect(mapDavCollectionToCalendar(cdavObject, {
@@ -107,6 +110,7 @@ describe('Test suite: Calendar model (models/calendar.js)', () => {
 			supportsTasks: false,
 			isSharedWithMe: false,
 			timezone: 'BEGIN:VCALENDAR...END:VCALENDAR',
+			transparency: 'opaque',
 			url: '/foo/bar',
 			calendarObjects: [],
 			fetchedTimeRanges: [],
@@ -129,7 +133,8 @@ describe('Test suite: Calendar model (models/calendar.js)', () => {
 			order: undefined,
 			publishURL: undefined,
 			timezone: 'BEGIN:VCALENDAR...END:VCALENDAR',
-			enabled: false
+			transparency: 'transparent',
+			enabled: false,
 		}
 
 		expect(mapDavCollectionToCalendar(cdavObject, {
@@ -152,6 +157,7 @@ describe('Test suite: Calendar model (models/calendar.js)', () => {
 			supportsTasks: false,
 			isSharedWithMe: false,
 			timezone: 'BEGIN:VCALENDAR...END:VCALENDAR',
+			transparency: 'transparent',
 			url: '/foo/bar',
 			calendarObjects: [],
 			fetchedTimeRanges: [],
@@ -196,6 +202,7 @@ describe('Test suite: Calendar model (models/calendar.js)', () => {
 			supportsTasks: false,
 			isSharedWithMe: false,
 			timezone: null,
+			transparency: 'opaque',
 			url: '/foo/bar',
 			calendarObjects: [],
 			fetchedTimeRanges: [],
@@ -240,6 +247,7 @@ describe('Test suite: Calendar model (models/calendar.js)', () => {
 			supportsTasks: false,
 			isSharedWithMe: true,
 			timezone: null,
+			transparency: 'opaque',
 			url: '/foo/bar',
 			calendarObjects: [],
 			fetchedTimeRanges: [],
@@ -284,6 +292,7 @@ describe('Test suite: Calendar model (models/calendar.js)', () => {
 			supportsTasks: false,
 			isSharedWithMe: false,
 			timezone: null,
+			transparency: 'opaque',
 			url: '/foo/bar',
 			calendarObjects: [],
 			fetchedTimeRanges: [],
@@ -328,6 +337,7 @@ describe('Test suite: Calendar model (models/calendar.js)', () => {
 			supportsTasks: false,
 			isSharedWithMe: false,
 			timezone: null,
+			transparency: 'opaque',
 			url: '/foo/bar',
 			calendarObjects: [],
 			fetchedTimeRanges: [],
@@ -372,6 +382,7 @@ describe('Test suite: Calendar model (models/calendar.js)', () => {
 			supportsTasks: false,
 			isSharedWithMe: false,
 			timezone: null,
+			transparency: 'opaque',
 			url: '/foo/bar',
 			calendarObjects: [],
 			fetchedTimeRanges: [],
@@ -416,6 +427,7 @@ describe('Test suite: Calendar model (models/calendar.js)', () => {
 			supportsTasks: false,
 			isSharedWithMe: false,
 			timezone: null,
+			transparency: 'opaque',
 			url: '/foo/bar',
 			calendarObjects: [],
 			fetchedTimeRanges: [],
@@ -516,6 +528,7 @@ describe('Test suite: Calendar model (models/calendar.js)', () => {
 			supportsTasks: false,
 			isSharedWithMe: false,
 			timezone: null,
+			transparency: 'opaque',
 			url: '/foo/bar',
 			calendarObjects: [],
 			fetchedTimeRanges: [],
@@ -632,6 +645,7 @@ describe('Test suite: Calendar model (models/calendar.js)', () => {
 			supportsTasks: false,
 			isSharedWithMe: true,
 			timezone: null,
+			transparency: 'opaque',
 			url: '/foo/bar',
 			calendarObjects: [],
 			fetchedTimeRanges: [],
@@ -677,6 +691,7 @@ describe('Test suite: Calendar model (models/calendar.js)', () => {
 			supportsTasks: false,
 			isSharedWithMe: false,
 			timezone: 'BEGIN:VCALENDAR...END:VCALENDAR',
+			transparency: 'opaque',
 			url: '/remote.php/dav/calendars/admin/personal/',
 			calendarObjects: [],
 			fetchedTimeRanges: [],