nextcloud / server

lib/private/Authentication/Listeners/RemoteWipeEmailListener.php

Indentation +126 added lines, -126 removed lines

@@ -45,130 +45,130 @@
  */
 class RemoteWipeEmailListener implements IEventListener {
 
-	/** @var IMailer */
-	private $mailer;
-
-	/** @var IUserManager */
-	private $userManager;
-
-	/** @var IL10N */
-	private $l10n;
-
-	/** @var LoggerInterface */
-	private $logger;
-
-	public function __construct(IMailer $mailer,
-								IUserManager $userManager,
-								IL10nFactory $l10nFactory,
-								LoggerInterface $logger) {
-		$this->mailer = $mailer;
-		$this->userManager = $userManager;
-		$this->l10n = $l10nFactory->get('core');
-		$this->logger = $logger;
-	}
-
-	/**
-	 * @param Event $event
-	 */
-	public function handle(Event $event): void {
-		if ($event instanceof RemoteWipeStarted) {
-			$uid = $event->getToken()->getUID();
-			$user = $this->userManager->get($uid);
-			if ($user === null) {
-				$this->logger->warning("not sending a wipe started email because user <$uid> does not exist (anymore)");
-				return;
-			}
-			if ($user->getEMailAddress() === null) {
-				$this->logger->info("not sending a wipe started email because user <$uid> has no email set");
-				return;
-			}
-
-			try {
-				$this->mailer->send(
-					$this->getWipingStartedMessage($event, $user)
-				);
-			} catch (Exception $e) {
-				$this->logger->error("Could not send remote wipe started email to <$uid>", [
-					'exception' => $e,
-				]);
-			}
-		} elseif ($event instanceof RemoteWipeFinished) {
-			$uid = $event->getToken()->getUID();
-			$user = $this->userManager->get($uid);
-			if ($user === null) {
-				$this->logger->warning("not sending a wipe finished email because user <$uid> does not exist (anymore)");
-				return;
-			}
-			if ($user->getEMailAddress() === null) {
-				$this->logger->info("not sending a wipe finished email because user <$uid> has no email set");
-				return;
-			}
-
-			try {
-				$this->mailer->send(
-					$this->getWipingFinishedMessage($event, $user)
-				);
-			} catch (Exception $e) {
-				$this->logger->error("Could not send remote wipe finished email to <$uid>", [
-					'exception' => $e,
-				]);
-			}
-		}
-	}
-
-	private function getWipingStartedMessage(RemoteWipeStarted $event, IUser $user): IMessage {
-		$message = $this->mailer->createMessage();
-		$emailTemplate = $this->mailer->createEMailTemplate('auth.RemoteWipeStarted');
-		$plainHeading = $this->l10n->t('Wiping of device %s has started', [$event->getToken()->getName()]);
-		$htmlHeading = $this->l10n->t('Wiping of device »%s« has started', [$event->getToken()->getName()]);
-		$emailTemplate->setSubject(
-			$this->l10n->t(
-				'»%s« started remote wipe',
-				[
-					substr($event->getToken()->getName(), 0, 15)
-				]
-			)
-		);
-		$emailTemplate->addHeader();
-		$emailTemplate->addHeading(
-			$htmlHeading,
-			$plainHeading
-		);
-		$emailTemplate->addBodyText(
-			$this->l10n->t('Device or application »%s« has started the remote wipe process. You will receive another email once the process has finished', [$event->getToken()->getName()])
-		);
-		$emailTemplate->addFooter();
-		$message->setTo([$user->getEMailAddress()]);
-		$message->useTemplate($emailTemplate);
-
-		return $message;
-	}
-
-	private function getWipingFinishedMessage(RemoteWipeFinished $event, IUser $user): IMessage {
-		$message = $this->mailer->createMessage();
-		$emailTemplate = $this->mailer->createEMailTemplate('auth.RemoteWipeFinished');
-		$plainHeading = $this->l10n->t('Wiping of device %s has finished', [$event->getToken()->getName()]);
-		$htmlHeading = $this->l10n->t('Wiping of device »%s« has finished', [$event->getToken()->getName()]);
-		$emailTemplate->setSubject(
-			$this->l10n->t(
-				'»%s« finished remote wipe',
-				[
-					substr($event->getToken()->getName(), 0, 15)
-				]
-			)
-		);
-		$emailTemplate->addHeader();
-		$emailTemplate->addHeading(
-			$htmlHeading,
-			$plainHeading
-		);
-		$emailTemplate->addBodyText(
-			$this->l10n->t('Device or application »%s« has finished the remote wipe process.', [$event->getToken()->getName()])
-		);
-		$emailTemplate->addFooter();
-		$message->setTo([$user->getEMailAddress()]);
-		$message->useTemplate($emailTemplate);
-
-		return $message;
-	}
+    /** @var IMailer */
+    private $mailer;
+
+    /** @var IUserManager */
+    private $userManager;
+
+    /** @var IL10N */
+    private $l10n;
+
+    /** @var LoggerInterface */
+    private $logger;
+
+    public function __construct(IMailer $mailer,
+                                IUserManager $userManager,
+                                IL10nFactory $l10nFactory,
+                                LoggerInterface $logger) {
+        $this->mailer = $mailer;
+        $this->userManager = $userManager;
+        $this->l10n = $l10nFactory->get('core');
+        $this->logger = $logger;
+    }
+
+    /**
+     * @param Event $event
+     */
+    public function handle(Event $event): void {
+        if ($event instanceof RemoteWipeStarted) {
+            $uid = $event->getToken()->getUID();
+            $user = $this->userManager->get($uid);
+            if ($user === null) {
+                $this->logger->warning("not sending a wipe started email because user <$uid> does not exist (anymore)");
+                return;
+            }
+            if ($user->getEMailAddress() === null) {
+                $this->logger->info("not sending a wipe started email because user <$uid> has no email set");
+                return;
+            }
+
+            try {
+                $this->mailer->send(
+                    $this->getWipingStartedMessage($event, $user)
+                );
+            } catch (Exception $e) {
+                $this->logger->error("Could not send remote wipe started email to <$uid>", [
+                    'exception' => $e,
+                ]);
+            }
+        } elseif ($event instanceof RemoteWipeFinished) {
+            $uid = $event->getToken()->getUID();
+            $user = $this->userManager->get($uid);
+            if ($user === null) {
+                $this->logger->warning("not sending a wipe finished email because user <$uid> does not exist (anymore)");
+                return;
+            }
+            if ($user->getEMailAddress() === null) {
+                $this->logger->info("not sending a wipe finished email because user <$uid> has no email set");
+                return;
+            }
+
+            try {
+                $this->mailer->send(
+                    $this->getWipingFinishedMessage($event, $user)
+                );
+            } catch (Exception $e) {
+                $this->logger->error("Could not send remote wipe finished email to <$uid>", [
+                    'exception' => $e,
+                ]);
+            }
+        }
+    }
+
+    private function getWipingStartedMessage(RemoteWipeStarted $event, IUser $user): IMessage {
+        $message = $this->mailer->createMessage();
+        $emailTemplate = $this->mailer->createEMailTemplate('auth.RemoteWipeStarted');
+        $plainHeading = $this->l10n->t('Wiping of device %s has started', [$event->getToken()->getName()]);
+        $htmlHeading = $this->l10n->t('Wiping of device »%s« has started', [$event->getToken()->getName()]);
+        $emailTemplate->setSubject(
+            $this->l10n->t(
+                '»%s« started remote wipe',
+                [
+                    substr($event->getToken()->getName(), 0, 15)
+                ]
+            )
+        );
+        $emailTemplate->addHeader();
+        $emailTemplate->addHeading(
+            $htmlHeading,
+            $plainHeading
+        );
+        $emailTemplate->addBodyText(
+            $this->l10n->t('Device or application »%s« has started the remote wipe process. You will receive another email once the process has finished', [$event->getToken()->getName()])
+        );
+        $emailTemplate->addFooter();
+        $message->setTo([$user->getEMailAddress()]);
+        $message->useTemplate($emailTemplate);
+
+        return $message;
+    }
+
+    private function getWipingFinishedMessage(RemoteWipeFinished $event, IUser $user): IMessage {
+        $message = $this->mailer->createMessage();
+        $emailTemplate = $this->mailer->createEMailTemplate('auth.RemoteWipeFinished');
+        $plainHeading = $this->l10n->t('Wiping of device %s has finished', [$event->getToken()->getName()]);
+        $htmlHeading = $this->l10n->t('Wiping of device »%s« has finished', [$event->getToken()->getName()]);
+        $emailTemplate->setSubject(
+            $this->l10n->t(
+                '»%s« finished remote wipe',
+                [
+                    substr($event->getToken()->getName(), 0, 15)
+                ]
+            )
+        );
+        $emailTemplate->addHeader();
+        $emailTemplate->addHeading(
+            $htmlHeading,
+            $plainHeading
+        );
+        $emailTemplate->addBodyText(
+            $this->l10n->t('Device or application »%s« has finished the remote wipe process.', [$event->getToken()->getName()])
+        );
+        $emailTemplate->addFooter();
+        $message->setTo([$user->getEMailAddress()]);
+        $message->useTemplate($emailTemplate);
+
+        return $message;
+    }
 }

lib/private/Authentication/Listeners/UserDeletedTokenCleanupListener.php

Indentation +30 added lines, -30 removed lines

@@ -38,38 +38,38 @@
  */
 class UserDeletedTokenCleanupListener implements IEventListener {
 
-	/** @var Manager */
-	private $manager;
+    /** @var Manager */
+    private $manager;
 
-	/** @var LoggerInterface */
-	private $logger;
+    /** @var LoggerInterface */
+    private $logger;
 
-	public function __construct(Manager $manager,
-								LoggerInterface $logger) {
-		$this->manager = $manager;
-		$this->logger = $logger;
-	}
+    public function __construct(Manager $manager,
+                                LoggerInterface $logger) {
+        $this->manager = $manager;
+        $this->logger = $logger;
+    }
 
-	public function handle(Event $event): void {
-		if (!($event instanceof UserDeletedEvent)) {
-			// Unrelated
-			return;
-		}
+    public function handle(Event $event): void {
+        if (!($event instanceof UserDeletedEvent)) {
+            // Unrelated
+            return;
+        }
 
-		/**
-		 * Catch any exception during this process as any failure here shouldn't block the
-		 * user deletion.
-		 */
-		try {
-			$uid = $event->getUser()->getUID();
-			$tokens = $this->manager->getTokenByUser($uid);
-			foreach ($tokens as $token) {
-				$this->manager->invalidateTokenById($uid, $token->getId());
-			}
-		} catch (Throwable $e) {
-			$this->logger->error('Could not clean up auth tokens after user deletion: ' . $e->getMessage(), [
-				'exception' => $e,
-			]);
-		}
-	}
+        /**
+         * Catch any exception during this process as any failure here shouldn't block the
+         * user deletion.
+         */
+        try {
+            $uid = $event->getUser()->getUID();
+            $tokens = $this->manager->getTokenByUser($uid);
+            foreach ($tokens as $token) {
+                $this->manager->invalidateTokenById($uid, $token->getId());
+            }
+        } catch (Throwable $e) {
+            $this->logger->error('Could not clean up auth tokens after user deletion: ' . $e->getMessage(), [
+                'exception' => $e,
+            ]);
+        }
+    }
 }

lib/private/Authentication/Listeners/RemoteWipeNotificationsListener.php

Indentation +27 added lines, -27 removed lines

@@ -40,35 +40,35 @@
  */
 class RemoteWipeNotificationsListener implements IEventListener {
 
-	/** @var INotificationManager */
-	private $notificationManager;
+    /** @var INotificationManager */
+    private $notificationManager;
 
-	/** @var ITimeFactory */
-	private $timeFactory;
+    /** @var ITimeFactory */
+    private $timeFactory;
 
-	public function __construct(INotificationManager $notificationManager,
-								ITimeFactory $timeFactory) {
-		$this->notificationManager = $notificationManager;
-		$this->timeFactory = $timeFactory;
-	}
+    public function __construct(INotificationManager $notificationManager,
+                                ITimeFactory $timeFactory) {
+        $this->notificationManager = $notificationManager;
+        $this->timeFactory = $timeFactory;
+    }
 
-	public function handle(Event $event): void {
-		if ($event instanceof RemoteWipeStarted) {
-			$this->sendNotification('remote_wipe_start', $event->getToken());
-		} elseif ($event instanceof RemoteWipeFinished) {
-			$this->sendNotification('remote_wipe_finish', $event->getToken());
-		}
-	}
+    public function handle(Event $event): void {
+        if ($event instanceof RemoteWipeStarted) {
+            $this->sendNotification('remote_wipe_start', $event->getToken());
+        } elseif ($event instanceof RemoteWipeFinished) {
+            $this->sendNotification('remote_wipe_finish', $event->getToken());
+        }
+    }
 
-	private function sendNotification(string $event, IToken $token): void {
-		$notification = $this->notificationManager->createNotification();
-		$notification->setApp('auth')
-			->setUser($token->getUID())
-			->setDateTime($this->timeFactory->getDateTime())
-			->setObject('token', (string) $token->getId())
-			->setSubject($event, [
-				'name' => $token->getName(),
-			]);
-		$this->notificationManager->notify($notification);
-	}
+    private function sendNotification(string $event, IToken $token): void {
+        $notification = $this->notificationManager->createNotification();
+        $notification->setApp('auth')
+            ->setUser($token->getUID())
+            ->setDateTime($this->timeFactory->getDateTime())
+            ->setObject('token', (string) $token->getId())
+            ->setSubject($event, [
+                'name' => $token->getName(),
+            ]);
+        $this->notificationManager->notify($notification);
+    }
 }

lib/private/Authentication/Listeners/LoginFailedListener.php

Indentation +22 added lines, -22 removed lines

@@ -40,30 +40,30 @@
  */
 class LoginFailedListener implements IEventListener {
 
-	/** @var IEventDispatcher */
-	private $dispatcher;
+    /** @var IEventDispatcher */
+    private $dispatcher;
 
-	/** @var IUserManager */
-	private $userManager;
+    /** @var IUserManager */
+    private $userManager;
 
-	public function __construct(IEventDispatcher $dispatcher, IUserManager $userManager) {
-		$this->dispatcher = $dispatcher;
-		$this->userManager = $userManager;
-	}
+    public function __construct(IEventDispatcher $dispatcher, IUserManager $userManager) {
+        $this->dispatcher = $dispatcher;
+        $this->userManager = $userManager;
+    }
 
-	public function handle(Event $event): void {
-		if (!($event instanceof LoginFailed)) {
-			return;
-		}
+    public function handle(Event $event): void {
+        if (!($event instanceof LoginFailed)) {
+            return;
+        }
 
-		$uid = $event->getLoginName();
-		Util::emitHook(
-			'\OCA\Files_Sharing\API\Server2Server',
-			'preLoginNameUsedAsUserName',
-			['uid' => &$uid]
-		);
-		if ($this->userManager->userExists($uid)) {
-			$this->dispatcher->dispatchTyped(new LoginFailedEvent($uid));
-		}
-	}
+        $uid = $event->getLoginName();
+        Util::emitHook(
+            '\OCA\Files_Sharing\API\Server2Server',
+            'preLoginNameUsedAsUserName',
+            ['uid' => &$uid]
+        );
+        if ($this->userManager->userExists($uid)) {
+            $this->dispatcher->dispatchTyped(new LoginFailedEvent($uid));
+        }
+    }
 }

lib/private/Authentication/Listeners/UserLoggedInListener.php

Indentation +15 added lines, -15 removed lines

@@ -36,23 +36,23 @@
  */
 class UserLoggedInListener implements IEventListener {
 
-	/** @var Manager */
-	private $manager;
+    /** @var Manager */
+    private $manager;
 
-	public function __construct(Manager $manager) {
-		$this->manager = $manager;
-	}
+    public function __construct(Manager $manager) {
+        $this->manager = $manager;
+    }
 
-	public function handle(Event $event): void {
-		if (!($event instanceof PostLoginEvent)) {
-			return;
-		}
+    public function handle(Event $event): void {
+        if (!($event instanceof PostLoginEvent)) {
+            return;
+        }
 
-		// If this is already a token login there is nothing to do
-		if ($event->isTokenLogin()) {
-			return;
-		}
+        // If this is already a token login there is nothing to do
+        if ($event->isTokenLogin()) {
+            return;
+        }
 
-		$this->manager->updatePasswords($event->getUser()->getUID(), $event->getPassword());
-	}
+        $this->manager->updatePasswords($event->getUser()->getUID(), $event->getPassword());
+    }
 }

lib/private/Authentication/Listeners/UserDeletedStoreCleanupListener.php

Indentation +11 added lines, -11 removed lines

@@ -36,18 +36,18 @@
  */
 class UserDeletedStoreCleanupListener implements IEventListener {
 
-	/** @var Registry */
-	private $registry;
+    /** @var Registry */
+    private $registry;
 
-	public function __construct(Registry $registry) {
-		$this->registry = $registry;
-	}
+    public function __construct(Registry $registry) {
+        $this->registry = $registry;
+    }
 
-	public function handle(Event $event): void {
-		if (!($event instanceof UserDeletedEvent)) {
-			return;
-		}
+    public function handle(Event $event): void {
+        if (!($event instanceof UserDeletedEvent)) {
+            return;
+        }
 
-		$this->registry->deleteUserData($event->getUser());
-	}
+        $this->registry->deleteUserData($event->getUser());
+    }
 }

lib/private/Authentication/Listeners/RemoteWipeActivityListener.php

Indentation +34 added lines, -34 removed lines

@@ -40,42 +40,42 @@
  */
 class RemoteWipeActivityListener implements IEventListener {
 
-	/** @var IActvityManager */
-	private $activityManager;
+    /** @var IActvityManager */
+    private $activityManager;
 
-	/** @var LoggerInterface */
-	private $logger;
+    /** @var LoggerInterface */
+    private $logger;
 
-	public function __construct(IActvityManager $activityManager,
-								LoggerInterface $logger) {
-		$this->activityManager = $activityManager;
-		$this->logger = $logger;
-	}
+    public function __construct(IActvityManager $activityManager,
+                                LoggerInterface $logger) {
+        $this->activityManager = $activityManager;
+        $this->logger = $logger;
+    }
 
-	public function handle(Event $event): void {
-		if ($event instanceof RemoteWipeStarted) {
-			$this->publishActivity('remote_wipe_start', $event->getToken());
-		} elseif ($event instanceof RemoteWipeFinished) {
-			$this->publishActivity('remote_wipe_finish', $event->getToken());
-		}
-	}
+    public function handle(Event $event): void {
+        if ($event instanceof RemoteWipeStarted) {
+            $this->publishActivity('remote_wipe_start', $event->getToken());
+        } elseif ($event instanceof RemoteWipeFinished) {
+            $this->publishActivity('remote_wipe_finish', $event->getToken());
+        }
+    }
 
-	private function publishActivity(string $event, IToken $token): void {
-		$activity = $this->activityManager->generateEvent();
-		$activity->setApp('core')
-			->setType('security')
-			->setAuthor($token->getUID())
-			->setAffectedUser($token->getUID())
-			->setSubject($event, [
-				'name' => $token->getName(),
-			]);
-		try {
-			$this->activityManager->publish($activity);
-		} catch (BadMethodCallException $e) {
-			$this->logger->warning('could not publish activity', [
-				'app' => 'core',
-				'exception' => $e,
-			]);
-		}
-	}
+    private function publishActivity(string $event, IToken $token): void {
+        $activity = $this->activityManager->generateEvent();
+        $activity->setApp('core')
+            ->setType('security')
+            ->setAuthor($token->getUID())
+            ->setAffectedUser($token->getUID())
+            ->setSubject($event, [
+                'name' => $token->getName(),
+            ]);
+        try {
+            $this->activityManager->publish($activity);
+        } catch (BadMethodCallException $e) {
+            $this->logger->warning('could not publish activity', [
+                'app' => 'core',
+                'exception' => $e,
+            ]);
+        }
+    }
 }

lib/public/EventDispatcher/IEventListener.php

Indentation +7 added lines, -7 removed lines

@@ -33,11 +33,11 @@
  */
 interface IEventListener {
 
-	/**
-	 * @param Event $event
-	 * @psalm-param T $event
-	 *
-	 * @since 17.0.0
-	 */
-	public function handle(Event $event): void;
+    /**
+     * @param Event $event
+     * @psalm-param T $event
+     *
+     * @since 17.0.0
+     */
+    public function handle(Event $event): void;
 }

lib/public/EventDispatcher/IEventDispatcher.php

Indentation +51 added lines, -51 removed lines

@@ -34,59 +34,59 @@
  */
 interface IEventDispatcher {
 
-	/**
-	 * @template T of \OCP\EventDispatcher\Event
-	 * @param string $eventName preferably the fully-qualified class name of the Event sub class
-	 * @psalm-param string|class-string<T> $eventName preferably the fully-qualified class name of the Event sub class
-	 * @param callable $listener the object that is invoked when a matching event is dispatched
-	 * @param int $priority
-	 *
-	 * @since 17.0.0
-	 */
-	public function addListener(string $eventName, callable $listener, int $priority = 0): void;
+    /**
+     * @template T of \OCP\EventDispatcher\Event
+     * @param string $eventName preferably the fully-qualified class name of the Event sub class
+     * @psalm-param string|class-string<T> $eventName preferably the fully-qualified class name of the Event sub class
+     * @param callable $listener the object that is invoked when a matching event is dispatched
+     * @param int $priority
+     *
+     * @since 17.0.0
+     */
+    public function addListener(string $eventName, callable $listener, int $priority = 0): void;
 
-	/**
-	 * @template T of \OCP\EventDispatcher\Event
-	 * @param string $eventName preferably the fully-qualified class name of the Event sub class
-	 * @psalm-param string|class-string<T> $eventName preferably the fully-qualified class name of the Event sub class
-	 * @param callable $listener the object that is invoked when a matching event is dispatched
-	 *
-	 * @since 19.0.0
-	 */
-	public function removeListener(string $eventName, callable $listener): void;
+    /**
+     * @template T of \OCP\EventDispatcher\Event
+     * @param string $eventName preferably the fully-qualified class name of the Event sub class
+     * @psalm-param string|class-string<T> $eventName preferably the fully-qualified class name of the Event sub class
+     * @param callable $listener the object that is invoked when a matching event is dispatched
+     *
+     * @since 19.0.0
+     */
+    public function removeListener(string $eventName, callable $listener): void;
 
-	/**
-	 * @template T of \OCP\EventDispatcher\Event
-	 * @param string $eventName preferably the fully-qualified class name of the Event sub class to listen for
-	 * @psalm-param string|class-string<T> $eventName preferably the fully-qualified class name of the Event sub class to listen for
-	 * @param string $className fully qualified class name (or ::class notation) of a \OCP\EventDispatcher\IEventListener that can be built by the DI container
-	 * @psalm-param class-string<\OCP\EventDispatcher\IEventListener<T>> $className fully qualified class name that can be built by the DI container
-	 * @param int $priority
-	 *
-	 * @since 17.0.0
-	 */
-	public function addServiceListener(string $eventName, string $className, int $priority = 0): void;
+    /**
+     * @template T of \OCP\EventDispatcher\Event
+     * @param string $eventName preferably the fully-qualified class name of the Event sub class to listen for
+     * @psalm-param string|class-string<T> $eventName preferably the fully-qualified class name of the Event sub class to listen for
+     * @param string $className fully qualified class name (or ::class notation) of a \OCP\EventDispatcher\IEventListener that can be built by the DI container
+     * @psalm-param class-string<\OCP\EventDispatcher\IEventListener<T>> $className fully qualified class name that can be built by the DI container
+     * @param int $priority
+     *
+     * @since 17.0.0
+     */
+    public function addServiceListener(string $eventName, string $className, int $priority = 0): void;
 
-	/**
-	 * @template T of \OCP\EventDispatcher\Event
-	 * @param string $eventName
-	 * @psalm-param string|class-string<T> $eventName
-	 * @param Event $event
-	 * @psalm-param T $event
-	 *
-	 * @since 17.0.0
-	 */
-	public function dispatch(string $eventName, Event $event): void;
+    /**
+     * @template T of \OCP\EventDispatcher\Event
+     * @param string $eventName
+     * @psalm-param string|class-string<T> $eventName
+     * @param Event $event
+     * @psalm-param T $event
+     *
+     * @since 17.0.0
+     */
+    public function dispatch(string $eventName, Event $event): void;
 
-	/**
-	 * Dispatch a typed event
-	 *
-	 * Only use this with subclasses of ``\OCP\EventDispatcher\Event``.
-	 * The object's class will determine the event name.
-	 *
-	 * @param Event $event
-	 *
-	 * @since 18.0.0
-	 */
-	public function dispatchTyped(Event $event): void;
+    /**
+     * Dispatch a typed event
+     *
+     * Only use this with subclasses of ``\OCP\EventDispatcher\Event``.
+     * The object's class will determine the event name.
+     *
+     * @param Event $event
+     *
+     * @since 18.0.0
+     */
+    public function dispatchTyped(Event $event): void;
 }