nextcloud / server

lib/public/Notification/InvalidValueException.php

Indentation +15 added lines, -15 removed lines

@@ -13,20 +13,20 @@
 
 #[Catchable(since: '30.0.0')]
 class InvalidValueException extends \InvalidArgumentException {
-	/**
-	 * @since 30.0.0
-	 */
-	public function __construct(
-		protected string $field,
-		?\Throwable $previous = null,
-	) {
-		parent::__construct('Value provided for ' . $field . ' is not valid', previous: $previous);
-	}
+    /**
+     * @since 30.0.0
+     */
+    public function __construct(
+        protected string $field,
+        ?\Throwable $previous = null,
+    ) {
+        parent::__construct('Value provided for ' . $field . ' is not valid', previous: $previous);
+    }
 
-	/**
-	 * @since 30.0.0
-	 */
-	public function getFieldIdentifier(): string {
-		return $this->field;
-	}
+    /**
+     * @since 30.0.0
+     */
+    public function getFieldIdentifier(): string {
+        return $this->field;
+    }
 }

lib/public/Notification/IApp.php

Indentation +18 added lines, -18 removed lines

@@ -12,24 +12,24 @@
 
 #[Implementable(since: '9.0.0')]
 interface IApp {
-	/**
-	 * @param INotification $notification
-	 * @throws IncompleteNotificationException When the notification does not have all required fields set
-	 * @since 9.0.0
-	 * @since 30.0.0 throws {@see IncompleteNotificationException} instead of \InvalidArgumentException
-	 */
-	public function notify(INotification $notification): void;
+    /**
+     * @param INotification $notification
+     * @throws IncompleteNotificationException When the notification does not have all required fields set
+     * @since 9.0.0
+     * @since 30.0.0 throws {@see IncompleteNotificationException} instead of \InvalidArgumentException
+     */
+    public function notify(INotification $notification): void;
 
-	/**
-	 * @param INotification $notification
-	 * @since 9.0.0
-	 */
-	public function markProcessed(INotification $notification): void;
+    /**
+     * @param INotification $notification
+     * @since 9.0.0
+     */
+    public function markProcessed(INotification $notification): void;
 
-	/**
-	 * @param INotification $notification
-	 * @return int
-	 * @since 9.0.0
-	 */
-	public function getCount(INotification $notification): int;
+    /**
+     * @param INotification $notification
+     * @return int
+     * @since 9.0.0
+     */
+    public function getCount(INotification $notification): int;
 }

lib/public/Notification/INotification.php

Indentation +316 added lines, -316 removed lines

@@ -12,320 +12,320 @@
 
 #[Consumable(since: '9.0.0')]
 interface INotification {
-	/**
-	 * @param string $app
-	 * @return $this
-	 * @throws InvalidValueException if the app id is invalid
-	 * @since 9.0.0
-	 * @since 30.0.0 throws {@see InvalidValueException} instead of \InvalidArgumentException
-	 */
-	public function setApp(string $app): INotification;
-
-	/**
-	 * @return string
-	 * @since 9.0.0
-	 */
-	public function getApp(): string;
-
-	/**
-	 * @param string $user
-	 * @return $this
-	 * @throws InvalidValueException if the user id is invalid
-	 * @since 9.0.0
-	 * @since 30.0.0 throws {@see InvalidValueException} instead of \InvalidArgumentException
-	 */
-	public function setUser(string $user): INotification;
-
-	/**
-	 * @return string
-	 * @since 9.0.0
-	 */
-	public function getUser(): string;
-
-	/**
-	 * @param \DateTime $dateTime
-	 * @return $this
-	 * @throws InvalidValueException if the $dateTime is invalid
-	 * @since 9.0.0
-	 * @since 30.0.0 throws {@see InvalidValueException} instead of \InvalidArgumentException
-	 */
-	public function setDateTime(\DateTime $dateTime): INotification;
-
-	/**
-	 * @return \DateTime
-	 * @since 9.0.0
-	 */
-	public function getDateTime(): \DateTime;
-
-	/**
-	 * @param string $type
-	 * @param string $id
-	 * @return $this
-	 * @throws InvalidValueException if the object type or id is invalid
-	 * @since 9.0.0
-	 * @since 30.0.0 throws {@see InvalidValueException} instead of \InvalidArgumentException
-	 */
-	public function setObject(string $type, string $id): INotification;
-
-	/**
-	 * @return string
-	 * @since 9.0.0
-	 */
-	public function getObjectType(): string;
-
-	/**
-	 * @return string
-	 * @since 9.0.0
-	 */
-	public function getObjectId(): string;
-
-	/**
-	 * @param string $subject
-	 * @param array $parameters
-	 * @return $this
-	 * @throws InvalidValueException if the subject or parameters are invalid
-	 * @since 9.0.0
-	 * @since 30.0.0 throws {@see InvalidValueException} instead of \InvalidArgumentException
-	 */
-	public function setSubject(string $subject, array $parameters = []): INotification;
-
-	/**
-	 * @return string
-	 * @since 9.0.0
-	 */
-	public function getSubject(): string;
-
-	/**
-	 * @return array
-	 * @since 9.0.0
-	 */
-	public function getSubjectParameters(): array;
-
-	/**
-	 * Set a parsed subject
-	 *
-	 * HTML is not allowed in the parsed subject and will be escaped
-	 * automatically by the clients. You can use the RichObjectString system
-	 * provided by the Nextcloud server to highlight important parameters via
-	 * the setRichSubject method.
-	 *
-	 * See https://github.com/nextcloud/server/issues/1706 for more information.
-	 *
-	 * @param string $subject
-	 * @return $this
-	 * @throws InvalidValueException if the subject is invalid
-	 * @since 9.0.0
-	 * @since 30.0.0 throws {@see InvalidValueException} instead of \InvalidArgumentException
-	 */
-	public function setParsedSubject(string $subject): INotification;
-
-	/**
-	 * @return string
-	 * @since 9.0.0
-	 */
-	public function getParsedSubject(): string;
-
-	/**
-	 * Set a RichObjectString subject
-	 *
-	 * HTML is not allowed in the rich subject and will be escaped automatically
-	 * by the clients, but you can use the RichObjectString system provided by
-	 * the Nextcloud server to highlight important parameters.
-	 *
-	 * See https://github.com/nextcloud/server/issues/1706 for more information.
-	 *
-	 * @param string $subject
-	 * @param array<string, array<string, string>> $parameters
-	 * @return $this
-	 * @throws InvalidValueException if the subject or parameters are invalid
-	 * @since 11.0.0
-	 * @since 30.0.0 throws {@see InvalidValueException} instead of \InvalidArgumentException
-	 */
-	public function setRichSubject(string $subject, array $parameters = []): INotification;
-
-	/**
-	 * @return string
-	 * @since 11.0.0
-	 */
-	public function getRichSubject(): string;
-
-	/**
-	 * @return array[]
-	 * @since 11.0.0
-	 */
-	public function getRichSubjectParameters(): array;
-
-	/**
-	 * @param string $message
-	 * @param array $parameters
-	 * @return $this
-	 * @throws InvalidValueException if the message or parameters are invalid
-	 * @since 9.0.0
-	 * @since 30.0.0 throws {@see InvalidValueException} instead of \InvalidArgumentException
-	 */
-	public function setMessage(string $message, array $parameters = []): INotification;
-
-	/**
-	 * @return string
-	 * @since 9.0.0
-	 */
-	public function getMessage(): string;
-
-	/**
-	 * @return array
-	 * @since 9.0.0
-	 */
-	public function getMessageParameters(): array;
-
-	/**
-	 * Set a parsed message
-	 *
-	 * HTML is not allowed in the parsed message and will be escaped
-	 * automatically by the clients. You can use the RichObjectString system
-	 * provided by the Nextcloud server to highlight important parameters via
-	 * the setRichMessage method.
-	 *
-	 * See https://github.com/nextcloud/server/issues/1706 for more information.
-	 *
-	 * @param string $message
-	 * @return $this
-	 * @throws InvalidValueException if the message is invalid
-	 * @since 9.0.0
-	 * @since 30.0.0 throws {@see InvalidValueException} instead of \InvalidArgumentException
-	 */
-	public function setParsedMessage(string $message): INotification;
-
-	/**
-	 * @return string
-	 * @since 9.0.0
-	 */
-	public function getParsedMessage(): string;
-
-	/**
-	 * Set a RichObjectString message
-	 *
-	 * HTML is not allowed in the rich message and will be escaped automatically
-	 * by the clients, but you can use the RichObjectString system provided by
-	 * the Nextcloud server to highlight important parameters.
-	 *
-	 * See https://github.com/nextcloud/server/issues/1706 for more information.
-	 *
-	 * @param string $message
-	 * @param array<string, array<string, string>> $parameters
-	 * @return $this
-	 * @throws InvalidValueException if the message or parameters are invalid
-	 * @since 11.0.0
-	 * @since 30.0.0 throws {@see InvalidValueException} instead of \InvalidArgumentException
-	 */
-	public function setRichMessage(string $message, array $parameters = []): INotification;
-
-	/**
-	 * @return string
-	 * @since 11.0.0
-	 */
-	public function getRichMessage(): string;
-
-	/**
-	 * @return array[]
-	 * @since 11.0.0
-	 */
-	public function getRichMessageParameters(): array;
-
-	/**
-	 * @param string $link
-	 * @return $this
-	 * @throws InvalidValueException if the link is invalid
-	 * @since 9.0.0
-	 * @since 30.0.0 throws {@see InvalidValueException} instead of \InvalidArgumentException
-	 */
-	public function setLink(string $link): INotification;
-
-	/**
-	 * @return string
-	 * @since 9.0.0
-	 */
-	public function getLink(): string;
-
-	/**
-	 * Set the absolute url for the icon (should be colored black or not have a color)
-	 *
-	 * It's automatically color inverted by clients when needed
-	 *
-	 * @param string $icon
-	 * @return $this
-	 * @throws InvalidValueException if the icon is invalid
-	 * @since 11.0.0
-	 * @since 30.0.0 throws {@see InvalidValueException} instead of \InvalidArgumentException
-	 */
-	public function setIcon(string $icon): INotification;
-
-	/**
-	 * Get the absolute url for the icon (should be colored black or not have a color)
-	 *
-	 * It's automatically color inverted by clients when needed
-	 *
-	 * @return string
-	 * @since 11.0.0
-	 */
-	public function getIcon(): string;
-
-	/**
-	 * @return $this
-	 * @throws InvalidValueException if the app is not allowed to send priority notifications
-	 * @since 31.0.0
-	 */
-	public function setPriorityNotification(bool $priorityNotification): INotification;
-
-	/**
-	 * @since 31.0.0
-	 */
-	public function isPriorityNotification(): bool;
-
-	/**
-	 * @return IAction
-	 * @since 9.0.0
-	 */
-	public function createAction(): IAction;
-
-	/**
-	 * @param IAction $action
-	 * @return $this
-	 * @throws InvalidValueException if the action is invalid
-	 * @since 9.0.0
-	 * @since 30.0.0 throws {@see InvalidValueException} instead of \InvalidArgumentException
-	 */
-	public function addAction(IAction $action): INotification;
-
-	/**
-	 * @return IAction[]
-	 * @since 9.0.0
-	 */
-	public function getActions(): array;
-
-	/**
-	 * @param IAction $action
-	 * @return $this
-	 * @throws InvalidValueException if the action is invalid
-	 * @since 9.0.0
-	 * @since 30.0.0 throws {@see InvalidValueException} instead of \InvalidArgumentException
-	 */
-	public function addParsedAction(IAction $action): INotification;
-
-	/**
-	 * @return IAction[]
-	 * @since 9.0.0
-	 */
-	public function getParsedActions(): array;
-
-	/**
-	 * @return bool
-	 * @since 9.0.0
-	 */
-	public function isValid(): bool;
-
-	/**
-	 * @return bool
-	 * @since 9.0.0
-	 */
-	public function isValidParsed(): bool;
+    /**
+     * @param string $app
+     * @return $this
+     * @throws InvalidValueException if the app id is invalid
+     * @since 9.0.0
+     * @since 30.0.0 throws {@see InvalidValueException} instead of \InvalidArgumentException
+     */
+    public function setApp(string $app): INotification;
+
+    /**
+     * @return string
+     * @since 9.0.0
+     */
+    public function getApp(): string;
+
+    /**
+     * @param string $user
+     * @return $this
+     * @throws InvalidValueException if the user id is invalid
+     * @since 9.0.0
+     * @since 30.0.0 throws {@see InvalidValueException} instead of \InvalidArgumentException
+     */
+    public function setUser(string $user): INotification;
+
+    /**
+     * @return string
+     * @since 9.0.0
+     */
+    public function getUser(): string;
+
+    /**
+     * @param \DateTime $dateTime
+     * @return $this
+     * @throws InvalidValueException if the $dateTime is invalid
+     * @since 9.0.0
+     * @since 30.0.0 throws {@see InvalidValueException} instead of \InvalidArgumentException
+     */
+    public function setDateTime(\DateTime $dateTime): INotification;
+
+    /**
+     * @return \DateTime
+     * @since 9.0.0
+     */
+    public function getDateTime(): \DateTime;
+
+    /**
+     * @param string $type
+     * @param string $id
+     * @return $this
+     * @throws InvalidValueException if the object type or id is invalid
+     * @since 9.0.0
+     * @since 30.0.0 throws {@see InvalidValueException} instead of \InvalidArgumentException
+     */
+    public function setObject(string $type, string $id): INotification;
+
+    /**
+     * @return string
+     * @since 9.0.0
+     */
+    public function getObjectType(): string;
+
+    /**
+     * @return string
+     * @since 9.0.0
+     */
+    public function getObjectId(): string;
+
+    /**
+     * @param string $subject
+     * @param array $parameters
+     * @return $this
+     * @throws InvalidValueException if the subject or parameters are invalid
+     * @since 9.0.0
+     * @since 30.0.0 throws {@see InvalidValueException} instead of \InvalidArgumentException
+     */
+    public function setSubject(string $subject, array $parameters = []): INotification;
+
+    /**
+     * @return string
+     * @since 9.0.0
+     */
+    public function getSubject(): string;
+
+    /**
+     * @return array
+     * @since 9.0.0
+     */
+    public function getSubjectParameters(): array;
+
+    /**
+     * Set a parsed subject
+     *
+     * HTML is not allowed in the parsed subject and will be escaped
+     * automatically by the clients. You can use the RichObjectString system
+     * provided by the Nextcloud server to highlight important parameters via
+     * the setRichSubject method.
+     *
+     * See https://github.com/nextcloud/server/issues/1706 for more information.
+     *
+     * @param string $subject
+     * @return $this
+     * @throws InvalidValueException if the subject is invalid
+     * @since 9.0.0
+     * @since 30.0.0 throws {@see InvalidValueException} instead of \InvalidArgumentException
+     */
+    public function setParsedSubject(string $subject): INotification;
+
+    /**
+     * @return string
+     * @since 9.0.0
+     */
+    public function getParsedSubject(): string;
+
+    /**
+     * Set a RichObjectString subject
+     *
+     * HTML is not allowed in the rich subject and will be escaped automatically
+     * by the clients, but you can use the RichObjectString system provided by
+     * the Nextcloud server to highlight important parameters.
+     *
+     * See https://github.com/nextcloud/server/issues/1706 for more information.
+     *
+     * @param string $subject
+     * @param array<string, array<string, string>> $parameters
+     * @return $this
+     * @throws InvalidValueException if the subject or parameters are invalid
+     * @since 11.0.0
+     * @since 30.0.0 throws {@see InvalidValueException} instead of \InvalidArgumentException
+     */
+    public function setRichSubject(string $subject, array $parameters = []): INotification;
+
+    /**
+     * @return string
+     * @since 11.0.0
+     */
+    public function getRichSubject(): string;
+
+    /**
+     * @return array[]
+     * @since 11.0.0
+     */
+    public function getRichSubjectParameters(): array;
+
+    /**
+     * @param string $message
+     * @param array $parameters
+     * @return $this
+     * @throws InvalidValueException if the message or parameters are invalid
+     * @since 9.0.0
+     * @since 30.0.0 throws {@see InvalidValueException} instead of \InvalidArgumentException
+     */
+    public function setMessage(string $message, array $parameters = []): INotification;
+
+    /**
+     * @return string
+     * @since 9.0.0
+     */
+    public function getMessage(): string;
+
+    /**
+     * @return array
+     * @since 9.0.0
+     */
+    public function getMessageParameters(): array;
+
+    /**
+     * Set a parsed message
+     *
+     * HTML is not allowed in the parsed message and will be escaped
+     * automatically by the clients. You can use the RichObjectString system
+     * provided by the Nextcloud server to highlight important parameters via
+     * the setRichMessage method.
+     *
+     * See https://github.com/nextcloud/server/issues/1706 for more information.
+     *
+     * @param string $message
+     * @return $this
+     * @throws InvalidValueException if the message is invalid
+     * @since 9.0.0
+     * @since 30.0.0 throws {@see InvalidValueException} instead of \InvalidArgumentException
+     */
+    public function setParsedMessage(string $message): INotification;
+
+    /**
+     * @return string
+     * @since 9.0.0
+     */
+    public function getParsedMessage(): string;
+
+    /**
+     * Set a RichObjectString message
+     *
+     * HTML is not allowed in the rich message and will be escaped automatically
+     * by the clients, but you can use the RichObjectString system provided by
+     * the Nextcloud server to highlight important parameters.
+     *
+     * See https://github.com/nextcloud/server/issues/1706 for more information.
+     *
+     * @param string $message
+     * @param array<string, array<string, string>> $parameters
+     * @return $this
+     * @throws InvalidValueException if the message or parameters are invalid
+     * @since 11.0.0
+     * @since 30.0.0 throws {@see InvalidValueException} instead of \InvalidArgumentException
+     */
+    public function setRichMessage(string $message, array $parameters = []): INotification;
+
+    /**
+     * @return string
+     * @since 11.0.0
+     */
+    public function getRichMessage(): string;
+
+    /**
+     * @return array[]
+     * @since 11.0.0
+     */
+    public function getRichMessageParameters(): array;
+
+    /**
+     * @param string $link
+     * @return $this
+     * @throws InvalidValueException if the link is invalid
+     * @since 9.0.0
+     * @since 30.0.0 throws {@see InvalidValueException} instead of \InvalidArgumentException
+     */
+    public function setLink(string $link): INotification;
+
+    /**
+     * @return string
+     * @since 9.0.0
+     */
+    public function getLink(): string;
+
+    /**
+     * Set the absolute url for the icon (should be colored black or not have a color)
+     *
+     * It's automatically color inverted by clients when needed
+     *
+     * @param string $icon
+     * @return $this
+     * @throws InvalidValueException if the icon is invalid
+     * @since 11.0.0
+     * @since 30.0.0 throws {@see InvalidValueException} instead of \InvalidArgumentException
+     */
+    public function setIcon(string $icon): INotification;
+
+    /**
+     * Get the absolute url for the icon (should be colored black or not have a color)
+     *
+     * It's automatically color inverted by clients when needed
+     *
+     * @return string
+     * @since 11.0.0
+     */
+    public function getIcon(): string;
+
+    /**
+     * @return $this
+     * @throws InvalidValueException if the app is not allowed to send priority notifications
+     * @since 31.0.0
+     */
+    public function setPriorityNotification(bool $priorityNotification): INotification;
+
+    /**
+     * @since 31.0.0
+     */
+    public function isPriorityNotification(): bool;
+
+    /**
+     * @return IAction
+     * @since 9.0.0
+     */
+    public function createAction(): IAction;
+
+    /**
+     * @param IAction $action
+     * @return $this
+     * @throws InvalidValueException if the action is invalid
+     * @since 9.0.0
+     * @since 30.0.0 throws {@see InvalidValueException} instead of \InvalidArgumentException
+     */
+    public function addAction(IAction $action): INotification;
+
+    /**
+     * @return IAction[]
+     * @since 9.0.0
+     */
+    public function getActions(): array;
+
+    /**
+     * @param IAction $action
+     * @return $this
+     * @throws InvalidValueException if the action is invalid
+     * @since 9.0.0
+     * @since 30.0.0 throws {@see InvalidValueException} instead of \InvalidArgumentException
+     */
+    public function addParsedAction(IAction $action): INotification;
+
+    /**
+     * @return IAction[]
+     * @since 9.0.0
+     */
+    public function getParsedActions(): array;
+
+    /**
+     * @return bool
+     * @since 9.0.0
+     */
+    public function isValid(): bool;
+
+    /**
+     * @return bool
+     * @since 9.0.0
+     */
+    public function isValidParsed(): bool;
 }

lib/public/Notification/IManager.php

Indentation +76 added lines, -76 removed lines

@@ -12,91 +12,91 @@
 
 #[Consumable(since: '9.0.0')]
 interface IManager extends IApp, INotifier {
-	/**
-	 * @param string $appClass The service must implement IApp, otherwise a
-	 *                         \InvalidArgumentException is thrown later
-	 * @since 17.0.0
-	 */
-	public function registerApp(string $appClass): void;
+    /**
+     * @param string $appClass The service must implement IApp, otherwise a
+     *                         \InvalidArgumentException is thrown later
+     * @since 17.0.0
+     */
+    public function registerApp(string $appClass): void;
 
-	/**
-	 * @param \Closure $service The service must implement INotifier, otherwise a
-	 *                          \InvalidArgumentException is thrown later
-	 * @param \Closure $info An array with the keys 'id' and 'name' containing
-	 *                       the app id and the app name
-	 * @deprecated 17.0.0 use registerNotifierService instead.
-	 * @since 8.2.0 - Parameter $info was added in 9.0.0
-	 */
-	public function registerNotifier(\Closure $service, \Closure $info);
+    /**
+     * @param \Closure $service The service must implement INotifier, otherwise a
+     *                          \InvalidArgumentException is thrown later
+     * @param \Closure $info An array with the keys 'id' and 'name' containing
+     *                       the app id and the app name
+     * @deprecated 17.0.0 use registerNotifierService instead.
+     * @since 8.2.0 - Parameter $info was added in 9.0.0
+     */
+    public function registerNotifier(\Closure $service, \Closure $info);
 
-	/**
-	 * @param string $notifierService The service must implement INotifier, otherwise a
-	 *                                \InvalidArgumentException is thrown later
-	 * @since 17.0.0
-	 * @deprecated 22.0.0 use the IBootStrap registration context
-	 */
-	public function registerNotifierService(string $notifierService): void;
+    /**
+     * @param string $notifierService The service must implement INotifier, otherwise a
+     *                                \InvalidArgumentException is thrown later
+     * @since 17.0.0
+     * @deprecated 22.0.0 use the IBootStrap registration context
+     */
+    public function registerNotifierService(string $notifierService): void;
 
-	/**
-	 * @return INotifier[]
-	 * @since 9.0.0
-	 */
-	public function getNotifiers(): array;
+    /**
+     * @return INotifier[]
+     * @since 9.0.0
+     */
+    public function getNotifiers(): array;
 
-	/**
-	 * @return INotification
-	 * @since 9.0.0
-	 */
-	public function createNotification(): INotification;
+    /**
+     * @return INotification
+     * @since 9.0.0
+     */
+    public function createNotification(): INotification;
 
-	/**
-	 * @return bool
-	 * @since 9.0.0
-	 */
-	public function hasNotifiers(): bool;
+    /**
+     * @return bool
+     * @since 9.0.0
+     */
+    public function hasNotifiers(): bool;
 
-	/**
-	 * @param bool $preparingPushNotification
-	 * @since 14.0.0
-	 */
-	public function setPreparingPushNotification(bool $preparingPushNotification): void;
+    /**
+     * @param bool $preparingPushNotification
+     * @since 14.0.0
+     */
+    public function setPreparingPushNotification(bool $preparingPushNotification): void;
 
-	/**
-	 * @return bool
-	 * @since 14.0.0
-	 */
-	public function isPreparingPushNotification(): bool;
+    /**
+     * @return bool
+     * @since 14.0.0
+     */
+    public function isPreparingPushNotification(): bool;
 
-	/**
-	 * @since 18.0.0
-	 */
-	public function dismissNotification(INotification $notification): void;
+    /**
+     * @since 18.0.0
+     */
+    public function dismissNotification(INotification $notification): void;
 
-	/**
-	 * Start deferring notifications until `flush()` is called
-	 *
-	 * The calling app should only "flush" when it got returned true on the defer call,
-	 * otherwise another app is deferring the sending already.
-	 * @return bool
-	 * @since 20.0.0
-	 */
-	public function defer(): bool;
+    /**
+     * Start deferring notifications until `flush()` is called
+     *
+     * The calling app should only "flush" when it got returned true on the defer call,
+     * otherwise another app is deferring the sending already.
+     * @return bool
+     * @since 20.0.0
+     */
+    public function defer(): bool;
 
-	/**
-	 * Send all deferred notifications that have been stored since `defer()` was called
-	 *
-	 * @since 20.0.0
-	 */
-	public function flush(): void;
+    /**
+     * Send all deferred notifications that have been stored since `defer()` was called
+     *
+     * @since 20.0.0
+     */
+    public function flush(): void;
 
-	/**
-	 * Whether the server can use the hosted push notification service
-	 *
-	 * We want to keep offering our push notification service for free, but large
-	 * users overload our infrastructure. For this reason we have to rate-limit the
-	 * use of push notifications. If you need this feature, consider using Nextcloud Enterprise.
-	 *
-	 * @since 23.0.0
-	 */
-	public function isFairUseOfFreePushService(): bool;
+    /**
+     * Whether the server can use the hosted push notification service
+     *
+     * We want to keep offering our push notification service for free, but large
+     * users overload our infrastructure. For this reason we have to rate-limit the
+     * use of push notifications. If you need this feature, consider using Nextcloud Enterprise.
+     *
+     * @since 23.0.0
+     */
+    public function isFairUseOfFreePushService(): bool;
 }

lib/public/Notification/IDismissableNotifier.php

Indentation +10 added lines, -10 removed lines

@@ -19,14 +19,14 @@
  */
 #[Implementable(since: '18.0.0')]
 interface IDismissableNotifier extends INotifier {
-	/**
-	 * @param INotification $notification
-	 * @throws UnknownNotificationException when the notifier is not in charge of the notification
-	 *
-	 * @since 18.0.0
-	 * @since 30.0.0 Notifiers should throw {@see UnknownNotificationException} instead of \InvalidArgumentException
-	 *  when they did not handle the notification. Throwing \InvalidArgumentException directly is deprecated and will
-	 *  be logged as an error in Nextcloud 39.
-	 */
-	public function dismissNotification(INotification $notification): void;
+    /**
+     * @param INotification $notification
+     * @throws UnknownNotificationException when the notifier is not in charge of the notification
+     *
+     * @since 18.0.0
+     * @since 30.0.0 Notifiers should throw {@see UnknownNotificationException} instead of \InvalidArgumentException
+     *  when they did not handle the notification. Throwing \InvalidArgumentException directly is deprecated and will
+     *  be logged as an error in Nextcloud 39.
+     */
+    public function dismissNotification(INotification $notification): void;
 }

lib/public/Notification/AlreadyProcessedException.php

Indentation +6 added lines, -6 removed lines

@@ -12,10 +12,10 @@
 
 #[Throwable(since: '17.0.0')]
 class AlreadyProcessedException extends \RuntimeException {
-	/**
-	 * @since 17.0.0
-	 */
-	public function __construct() {
-		parent::__construct('Notification is processed already');
-	}
+    /**
+     * @since 17.0.0
+     */
+    public function __construct() {
+        parent::__construct('Notification is processed already');
+    }
 }

lib/public/Notification/IDeferrableApp.php

Indentation +12 added lines, -12 removed lines

@@ -12,17 +12,17 @@
 
 #[Implementable(since: '20.0.0')]
 interface IDeferrableApp extends IApp {
-	/**
-	 * Start deferring notifications until `flush()` is called
-	 *
-	 * @since 20.0.0
-	 */
-	public function defer(): void;
+    /**
+     * Start deferring notifications until `flush()` is called
+     *
+     * @since 20.0.0
+     */
+    public function defer(): void;
 
-	/**
-	 * Send all deferred notifications that have been stored since `defer()` was called
-	 *
-	 * @since 20.0.0
-	 */
-	public function flush(): void;
+    /**
+     * Send all deferred notifications that have been stored since `defer()` was called
+     *
+     * @since 20.0.0
+     */
+    public function flush(): void;
 }

lib/public/Notification/IAction.php

Indentation +86 added lines, -86 removed lines

@@ -12,101 +12,101 @@
 
 #[Consumable(since: '9.0.0')]
 interface IAction {
-	/**
-	 * @since 17.0.0
-	 */
-	public const TYPE_GET = 'GET';
-	/**
-	 * @since 17.0.0
-	 */
-	public const TYPE_POST = 'POST';
-	/**
-	 * @since 17.0.0
-	 */
-	public const TYPE_PUT = 'PUT';
-	/**
-	 * @since 17.0.0
-	 */
-	public const TYPE_DELETE = 'DELETE';
-	/**
-	 * @since 17.0.0
-	 */
-	public const TYPE_WEB = 'WEB';
+    /**
+     * @since 17.0.0
+     */
+    public const TYPE_GET = 'GET';
+    /**
+     * @since 17.0.0
+     */
+    public const TYPE_POST = 'POST';
+    /**
+     * @since 17.0.0
+     */
+    public const TYPE_PUT = 'PUT';
+    /**
+     * @since 17.0.0
+     */
+    public const TYPE_DELETE = 'DELETE';
+    /**
+     * @since 17.0.0
+     */
+    public const TYPE_WEB = 'WEB';
 
-	/**
-	 * @param string $label
-	 * @return $this
-	 * @throws InvalidValueException if the label is invalid
-	 * @since 9.0.0
-	 * @since 30.0.0 throws {@see InvalidValueException} instead of \InvalidArgumentException
-	 */
-	public function setLabel(string $label): IAction;
+    /**
+     * @param string $label
+     * @return $this
+     * @throws InvalidValueException if the label is invalid
+     * @since 9.0.0
+     * @since 30.0.0 throws {@see InvalidValueException} instead of \InvalidArgumentException
+     */
+    public function setLabel(string $label): IAction;
 
-	/**
-	 * @return string
-	 * @since 9.0.0
-	 */
-	public function getLabel(): string;
+    /**
+     * @return string
+     * @since 9.0.0
+     */
+    public function getLabel(): string;
 
-	/**
-	 * @param string $label
-	 * @return $this
-	 * @throws InvalidValueException if the label is invalid
-	 * @since 9.0.0
-	 * @since 30.0.0 throws {@see InvalidValueException} instead of \InvalidArgumentException
-	 */
-	public function setParsedLabel(string $label): IAction;
+    /**
+     * @param string $label
+     * @return $this
+     * @throws InvalidValueException if the label is invalid
+     * @since 9.0.0
+     * @since 30.0.0 throws {@see InvalidValueException} instead of \InvalidArgumentException
+     */
+    public function setParsedLabel(string $label): IAction;
 
-	/**
-	 * @return string
-	 * @since 9.0.0
-	 */
-	public function getParsedLabel(): string;
+    /**
+     * @return string
+     * @since 9.0.0
+     */
+    public function getParsedLabel(): string;
 
-	/**
-	 * @param bool $primary
-	 * @return $this
-	 * @since 9.0.0
-	 */
-	public function setPrimary(bool $primary): IAction;
+    /**
+     * @param bool $primary
+     * @return $this
+     * @since 9.0.0
+     */
+    public function setPrimary(bool $primary): IAction;
 
-	/**
-	 * @return bool
-	 * @since 9.0.0
-	 */
-	public function isPrimary(): bool;
+    /**
+     * @return bool
+     * @since 9.0.0
+     */
+    public function isPrimary(): bool;
 
-	/**
-	 * @param string $link
-	 * @param string $requestType
-	 * @return $this
-	 * @throws InvalidValueException if the link is invalid
-	 * @since 9.0.0
-	 * @since 30.0.0 throws {@see InvalidValueException} instead of \InvalidArgumentException
-	 */
-	public function setLink(string $link, string $requestType): IAction;
+    /**
+     * @param string $link
+     * @param string $requestType
+     * @return $this
+     * @throws InvalidValueException if the link is invalid
+     * @since 9.0.0
+     * @since 30.0.0 throws {@see InvalidValueException} instead of \InvalidArgumentException
+     */
+    public function setLink(string $link, string $requestType): IAction;
 
-	/**
-	 * @return string
-	 * @since 9.0.0
-	 */
-	public function getLink(): string;
+    /**
+     * @return string
+     * @since 9.0.0
+     */
+    public function getLink(): string;
 
-	/**
-	 * @return string
-	 * @since 9.0.0
-	 */
-	public function getRequestType(): string;
+    /**
+     * @return string
+     * @since 9.0.0
+     */
+    public function getRequestType(): string;
 
-	/**
-	 * @return bool
-	 * @since 9.0.0
-	 */
-	public function isValid(): bool;
+    /**
+     * @return bool
+     * @since 9.0.0
+     */
+    public function isValid(): bool;
 
-	/**
-	 * @return bool
-	 * @since 9.0.0
-	 */
-	public function isValidParsed(): bool;
+    /**
+     * @return bool
+     * @since 9.0.0
+     */
+    public function isValidParsed(): bool;
 }

lib/public/Notification/INotifier.php

Indentation +29 added lines, -29 removed lines

@@ -12,35 +12,35 @@
 
 #[Implementable(since: '9.0.0')]
 interface INotifier {
-	/**
-	 * Identifier of the notifier, only use [a-z0-9_]
-	 *
-	 * @return string
-	 * @since 17.0.0
-	 */
-	public function getID(): string;
+    /**
+     * Identifier of the notifier, only use [a-z0-9_]
+     *
+     * @return string
+     * @since 17.0.0
+     */
+    public function getID(): string;
 
-	/**
-	 * Human-readable name describing the notifier
-	 *
-	 * @return string
-	 * @since 17.0.0
-	 */
-	public function getName(): string;
+    /**
+     * Human-readable name describing the notifier
+     *
+     * @return string
+     * @since 17.0.0
+     */
+    public function getName(): string;
 
-	/**
-	 * @param INotification $notification
-	 * @param string $languageCode The code of the language that should be used to prepare the notification
-	 * @return INotification
-	 * @throws UnknownNotificationException When the notification was not prepared by a notifier
-	 * @throws AlreadyProcessedException When the notification is not needed anymore and should be deleted
-	 * @throws IncompleteParsedNotificationException Only to be thrown by the {@see IManager}
-	 * @since 9.0.0
-	 * @since 30.0.0 Notifiers should throw {@see UnknownNotificationException} instead of \InvalidArgumentException
-	 *  when they did not handle the notification. Throwing \InvalidArgumentException directly is deprecated and will
-	 *  be logged as an error in Nextcloud 39.
-	 * @since 30.0.0 Throws {@see IncompleteParsedNotificationException} when not all required fields
-	 *  are set at the end of the manager or after a INotifier that claimed to have parsed the notification.
-	 */
-	public function prepare(INotification $notification, string $languageCode): INotification;
+    /**
+     * @param INotification $notification
+     * @param string $languageCode The code of the language that should be used to prepare the notification
+     * @return INotification
+     * @throws UnknownNotificationException When the notification was not prepared by a notifier
+     * @throws AlreadyProcessedException When the notification is not needed anymore and should be deleted
+     * @throws IncompleteParsedNotificationException Only to be thrown by the {@see IManager}
+     * @since 9.0.0
+     * @since 30.0.0 Notifiers should throw {@see UnknownNotificationException} instead of \InvalidArgumentException
+     *  when they did not handle the notification. Throwing \InvalidArgumentException directly is deprecated and will
+     *  be logged as an error in Nextcloud 39.
+     * @since 30.0.0 Throws {@see IncompleteParsedNotificationException} when not all required fields
+     *  are set at the end of the manager or after a INotifier that claimed to have parsed the notification.
+     */
+    public function prepare(INotification $notification, string $languageCode): INotification;
 }