feat(internal-link): event on request

Signed-off-by: Maxence Lange <maxence@artificial-owl.com>

Author: ArtificialOwl

apps/files/lib/Controller/ViewController.php

@@ -28,6 +28,7 @@
 use OCP\AppFramework\Services\IInitialState;
 use OCP\Collaboration\Resources\LoadAdditionalScriptsEvent as ResourcesLoadAdditionalScriptsEvent;
 use OCP\EventDispatcher\IEventDispatcher;
+use OCP\Files\Events\InternalLinkRequestEvent;
 use OCP\Files\Folder;
 use OCP\Files\IRootFolder;
 use OCP\Files\NotFoundException;
@@ -89,7 +90,10 @@ public function showFile(?string $fileid = null, ?string $opendetails = null, ?s
 
 		// This is the entry point from the `/f/{fileid}` URL which is hardcoded in the server.
 		try {
-			return $this->redirectToFile((int)$fileid, $opendetails, $openfile);
+			$event = new InternalLinkRequestEvent($fileid);
+			$this->eventDispatcher->dispatchTyped($event);
+			
+			return $event->getResponse() ?? $this->redirectToFile((int)$fileid, $opendetails, $openfile);
 		} catch (NotFoundException $e) {
 			// Keep the fileid even if not found, it will be used
 			// to detect the file could not be found and warn the user

lib/public/Files/Events/InternalLinkRequestEvent.php

@@ -0,0 +1,55 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: 2025 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+namespace OCP\Files\Events;
+
+use OCP\AppFramework\Http\Response;
+use OCP\EventDispatcher\Event;
+
+/**
+ * @since 32.0.0
+ */
+class InternalLinkRequestEvent extends Event {
+	private ?Response $response = null;
+	/**
+	 * @since 32.0.0
+	 */
+	public function __construct(
+		private string &$fileId,
+	) {
+		parent::__construct();
+	}
+
+	/**
+	 * @since 32.0.0
+	 */
+	public function setFileId(string $fileId): void {
+		$this->fileId = $fileId;
+	}
+
+	/**
+	 * @since 32.0.0
+	 */
+	public function getFileId(): string {
+		return $this->fileId;
+	}
+
+	/**
+	 * @since 32.0.0
+	 */
+	public function setResponse(Response $response): void {
+		$this->response = $response;
+	}
+
+	/**
+	 * @since 32.0.0
+	 */
+	public function getResponse(): ?Response {
+		return $this->response;
+	}
+}