From d4ebe5d5f5e988693d7f991039b79fb78334e1ee Mon Sep 17 00:00:00 2001
From: Ferdinand Thiessen <opensource@fthiessen.de>
Date: Sat, 14 Nov 2026 09:20:54 +0100
Subject: [PATCH] feat: add event for deleted resources

Apps owning a resource dispatch it after deleting the resource, so that apps
that stored restrictions or labels for it can remove them.

Assisted-by: ClaudeCode:claude-fable-5-2
Signed-off-by: Ferdinand Thiessen <opensource@fthiessen.de>
---
 lib/composer/composer/autoload_classmap.php   |  1 +
 lib/composer/composer/autoload_static.php     |  1 +
 .../Resource/Events/ResourceDeletedEvent.php  | 34 +++++++++++++++++++
 3 files changed, 36 insertions(+)
 create mode 100644 lib/unstable/Resource/Events/ResourceDeletedEvent.php

diff --git a/lib/composer/composer/autoload_classmap.php b/lib/composer/composer/autoload_classmap.php
index 1872528333937..37ff5989613a6 100644
--- a/lib/composer/composer/autoload_classmap.php
+++ b/lib/composer/composer/autoload_classmap.php
@@ -29,6 +29,7 @@
     'NCU\\Governance\\LabelModification' => $baseDir . '/lib/unstable/Governance/LabelModification.php',
     'NCU\\Governance\\LabelType' => $baseDir . '/lib/unstable/Governance/LabelType.php',
     'NCU\\Governance\\ResourceLabel' => $baseDir . '/lib/unstable/Governance/ResourceLabel.php',
+    'NCU\\Resource\\Events\\ResourceDeletedEvent' => $baseDir . '/lib/unstable/Resource/Events/ResourceDeletedEvent.php',
     'NCU\\Resource\\IResourceType' => $baseDir . '/lib/unstable/Resource/IResourceType.php',
     'NCU\\Resource\\Permission\\APermission' => $baseDir . '/lib/unstable/Resource/Permission/APermission.php',
     'NCU\\Resource\\Permission\\AccessEntry' => $baseDir . '/lib/unstable/Resource/Permission/AccessEntry.php',
diff --git a/lib/composer/composer/autoload_static.php b/lib/composer/composer/autoload_static.php
index 8d1635270d1fd..4ca14daa1fc6e 100644
--- a/lib/composer/composer/autoload_static.php
+++ b/lib/composer/composer/autoload_static.php
@@ -70,6 +70,7 @@ class ComposerStaticInit749170dad3f5e7f9ca158f5a9f04f6a2
         'NCU\\Governance\\LabelModification' => __DIR__ . '/../../..' . '/lib/unstable/Governance/LabelModification.php',
         'NCU\\Governance\\LabelType' => __DIR__ . '/../../..' . '/lib/unstable/Governance/LabelType.php',
         'NCU\\Governance\\ResourceLabel' => __DIR__ . '/../../..' . '/lib/unstable/Governance/ResourceLabel.php',
+        'NCU\\Resource\\Events\\ResourceDeletedEvent' => __DIR__ . '/../../..' . '/lib/unstable/Resource/Events/ResourceDeletedEvent.php',
         'NCU\\Resource\\IResourceType' => __DIR__ . '/../../..' . '/lib/unstable/Resource/IResourceType.php',
         'NCU\\Resource\\Permission\\APermission' => __DIR__ . '/../../..' . '/lib/unstable/Resource/Permission/APermission.php',
         'NCU\\Resource\\Permission\\AccessEntry' => __DIR__ . '/../../..' . '/lib/unstable/Resource/Permission/AccessEntry.php',
diff --git a/lib/unstable/Resource/Events/ResourceDeletedEvent.php b/lib/unstable/Resource/Events/ResourceDeletedEvent.php
new file mode 100644
index 0000000000000..076b0ca1f097c
--- /dev/null
+++ b/lib/unstable/Resource/Events/ResourceDeletedEvent.php
@@ -0,0 +1,34 @@
+<?php
+
+/**
+ * SPDX-FileCopyrightText: 2026 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+declare(strict_types=1);
+
+namespace NCU\Resource\Events;
+
+use NCU\Resource\ResourceReference;
+use OCP\AppFramework\Attribute\Dispatchable;
+use OCP\AppFramework\Attribute\Listenable;
+use OCP\EventDispatcher\Event;
+
+/**
+ * Dispatched by the app owning a resource after the resource was deleted for good,
+ * so that other apps can remove what they stored for it, e.g. restrictions or labels.
+ *
+ * @experimental 36.0.0
+ */
+#[Dispatchable(since: '36.0.0')]
+#[Listenable(since: '36.0.0')]
+final class ResourceDeletedEvent extends Event {
+	/**
+	 * @experimental 36.0.0
+	 */
+	public function __construct(
+		public readonly ResourceReference $resource,
+	) {
+		parent::__construct();
+	}
+}