feat(install): dispatch InstallationCompletedEvent in Setup

Integrate event dispatching into Setup class:
- Inject IEventDispatcher dependency
- Dispatch InstallationCompletedEvent after successful installation
- Add Setup tests for event integration
- Update composer autoload for new class

Signed-off-by: Misha M.-Kupriyanov <kupriyanov@strato.de>

Author: printminion-co

lib/composer/composer/autoload_classmap.php

@@ -639,6 +639,7 @@
     'OCP\\IUserManager' => $baseDir . '/lib/public/IUserManager.php',
     'OCP\\IUserSession' => $baseDir . '/lib/public/IUserSession.php',
     'OCP\\Image' => $baseDir . '/lib/public/Image.php',
+    'OCP\\Install\\Events\\InstallationCompletedEvent' => $baseDir . '/lib/public/Install/Events/InstallationCompletedEvent.php',
     'OCP\\L10N\\IFactory' => $baseDir . '/lib/public/L10N/IFactory.php',
     'OCP\\L10N\\ILanguageIterator' => $baseDir . '/lib/public/L10N/ILanguageIterator.php',
     'OCP\\LDAP\\IDeletionFlagSupport' => $baseDir . '/lib/public/LDAP/IDeletionFlagSupport.php',

lib/composer/composer/autoload_static.php

@@ -680,6 +680,7 @@ class ComposerStaticInit749170dad3f5e7f9ca158f5a9f04f6a2
         'OCP\\IUserManager' => __DIR__ . '/../../..' . '/lib/public/IUserManager.php',
         'OCP\\IUserSession' => __DIR__ . '/../../..' . '/lib/public/IUserSession.php',
         'OCP\\Image' => __DIR__ . '/../../..' . '/lib/public/Image.php',
+        'OCP\\Install\\Events\\InstallationCompletedEvent' => __DIR__ . '/../../..' . '/lib/public/Install/Events/InstallationCompletedEvent.php',
         'OCP\\L10N\\IFactory' => __DIR__ . '/../../..' . '/lib/public/L10N/IFactory.php',
         'OCP\\L10N\\ILanguageIterator' => __DIR__ . '/../../..' . '/lib/public/L10N/ILanguageIterator.php',
         'OCP\\LDAP\\IDeletionFlagSupport' => __DIR__ . '/../../..' . '/lib/public/LDAP/IDeletionFlagSupport.php',

lib/private/Setup.php

@@ -22,12 +22,14 @@
 use OCP\AppFramework\Utility\ITimeFactory;
 use OCP\BackgroundJob\IJobList;
 use OCP\Defaults;
+use OCP\EventDispatcher\IEventDispatcher;
 use OCP\Http\Client\IClientService;
 use OCP\IAppConfig;
 use OCP\IConfig;
 use OCP\IGroup;
 use OCP\IGroupManager;
 use OCP\IL10N;
+use OCP\Install\Events\InstallationCompletedEvent;
 use OCP\IRequest;
 use OCP\IURLGenerator;
 use OCP\IUserManager;
@@ -50,6 +52,7 @@ public function __construct(
 		protected LoggerInterface $logger,
 		protected ISecureRandom $random,
 		protected Installer $installer,
+		protected IEventDispatcher $eventDispatcher,
 	) {
 		$this->l10n = $l10nFactory->get('lib');
 	}
@@ -494,6 +497,13 @@ public function install(array $options, ?IOutput $output = null): array {
 			}
 		}
 
+		// Dispatch installation completed event
+		$adminUsername = !$disableAdminUser ? ($options['adminlogin'] ?? null) : null;
+		$adminEmail = !empty($options['adminemail']) ? $options['adminemail'] : null;
+		$this->eventDispatcher->dispatchTyped(
+			new InstallationCompletedEvent($dataDir, $adminUsername, $adminEmail)
+		);
+
 		return $error;
 	}
 

lib/public/Install/Events/InstallationCompletedEvent.php

@@ -27,11 +27,11 @@
  * - Initializing app-specific data
  * - Setting up integrations
  *
- * @since 33.0.0
+ * @since 32.0.0
  */
 class InstallationCompletedEvent extends Event {
 	/**
-	 * @since 33.0.0
+	 * @since 32.0.0
 	 */
 	public function __construct(
 		private string $dataDirectory,
@@ -44,7 +44,7 @@ public function __construct(
 	/**
 	 * Get the configured data directory path
 	 *
-	 * @since 33.0.0
+	 * @since 32.0.0
 	 */
 	public function getDataDirectory(): string {
 		return $this->dataDirectory;
@@ -53,7 +53,7 @@ public function getDataDirectory(): string {
 	/**
 	 * Get the admin username if an admin user was created
 	 *
-	 * @since 33.0.0
+	 * @since 32.0.0
 	 */
 	public function getAdminUsername(): ?string {
 		return $this->adminUsername;
@@ -62,7 +62,7 @@ public function getAdminUsername(): ?string {
 	/**
 	 * Get the admin email if configured
 	 *
-	 * @since 33.0.0
+	 * @since 32.0.0
 	 */
 	public function getAdminEmail(): ?string {
 		return $this->adminEmail;
@@ -71,7 +71,7 @@ public function getAdminEmail(): ?string {
 	/**
 	 * Check if an admin user was created during installation
 	 *
-	 * @since 33.0.0
+	 * @since 32.0.0
 	 */
 	public function hasAdminUser(): bool {
 		return $this->adminUsername !== null;

tests/lib/SetupTest.php

@@ -13,6 +13,7 @@
 use OC\Setup;
 use OC\SystemConfig;
 use OCP\Defaults;
+use OCP\EventDispatcher\IEventDispatcher;
 use OCP\IL10N;
 use OCP\L10N\IFactory as IL10NFactory;
 use OCP\Security\ISecureRandom;
@@ -28,6 +29,7 @@ class SetupTest extends \Test\TestCase {
 	protected LoggerInterface $logger;
 	protected ISecureRandom $random;
 	protected Installer $installer;
+	protected IEventDispatcher $eventDispatcher;
 
 	protected function setUp(): void {
 		parent::setUp();
@@ -42,9 +44,10 @@ protected function setUp(): void {
 		$this->logger = $this->createMock(LoggerInterface::class);
 		$this->random = $this->createMock(ISecureRandom::class);
 		$this->installer = $this->createMock(Installer::class);
+		$this->eventDispatcher = $this->createMock(IEventDispatcher::class);
 		$this->setupClass = $this->getMockBuilder(Setup::class)
 			->onlyMethods(['class_exists', 'is_callable', 'getAvailableDbDriversForPdo'])
-			->setConstructorArgs([$this->config, $this->iniWrapper, $this->l10nFactory, $this->defaults, $this->logger, $this->random, $this->installer])
+			->setConstructorArgs([$this->config, $this->iniWrapper, $this->l10nFactory, $this->defaults, $this->logger, $this->random, $this->installer, $this->eventDispatcher])
 			->getMock();
 	}