feat(files_sharing): implement IShareProviderWithNotification and refactor sendMailNotification

Signed-off-by: skjnldsv <skjnldsv@protonmail.com>

1 files changed, 24 insertions, 0 deletions

diff --git a/lib/public/Share/IShareProviderWithNotification.php b/lib/public/Share/IShareProviderWithNotification.php
new file mode 100644
index 00000000000..8a595f46dfd
--- /dev/null
+++ b/lib/public/Share/IShareProviderWithNotification.php
@@ -0,0 +1,24 @@
+<?php
+
+/**
+ * SPDX-FileCopyrightText: 2016-2024 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-FileCopyrightText: 2016 ownCloud, Inc.
+ * SPDX-License-Identifier: AGPL-3.0-only
+ */
+namespace OCP\Share;
+
+/**
+ * Interface IShareProvider
+ *
+ * @since 30.0.0
+ */
+interface IShareProviderWithNotification extends IShareProvider {
+	/**
+	 * Send a mail notification to the recipient of a share
+	 * @param IShare $share
+	 * @return bool True if the mail was sent successfully
+	 * @throws Exception If the mail could not be sent
+	 * @since 30.0.0
+	 */
+	public function sendMailNotification(IShare $share): bool;
+}