Feature: create ionos mail

appinfo/routes.php

@@ -120,6 +120,11 @@
 			'url' => '/api/tags',
 			'verb' => 'POST'
 		],
+		[
+			'name' => 'ionosAccounts#create',
+			'url' => '/api/ionos/accounts',
+			'verb' => 'POST'
+		],
 		[
 			'name' => 'tags#update',
 			'url' => '/api/tags/{id}',

composer.json

@@ -30,6 +30,7 @@
 		"glenscott/url-normalizer": "^1.4",
 		"gravatarphp/gravatar": "dev-master#6b9f6a45477ce48285738d9d0c3f0dbf97abe263",
 		"hamza221/html2text": "^1.0",
+		"ionos-productivity/ionos-mail-configuration-api-client": "2.0.0",
 		"jeremykendall/php-domain-parser": "^6.4.0",
 		"nextcloud/horde-managesieve": "^1.0",
 		"nextcloud/horde-smtp": "^1.0.2",
@@ -44,6 +45,25 @@
 		"wamania/php-stemmer": "4.0 as 3.0",
 		"youthweb/urllinker": "^2.1.0"
 	},
+	"repositories": [
+		{
+			"type": "package",
+			"package": {
+				"name": "ionos-productivity/ionos-mail-configuration-api-client",
+				"version": "2.0.0",
+				"source": {
+					"type": "git",
+					"url": "https://github.com/ionos-productivity/ionos-mail-configuration-api-client.git",
+					"reference": "2.0.0-6ebd22a"
+				},
+				"autoload": {
+					"psr-4": {
+						"IONOS\\MailConfigurationAPI\\Client\\" : "lib/"
+					}
+				}
+			}
+		}
+	],
 	"provide": {
 		"psr/log": "^1.0.4|^2|^3"
 	},

lib/Controller/IonosAccountsController.php

@@ -0,0 +1,95 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: 2025 STRATO GmbH
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+namespace OCA\Mail\Controller;
+
+use OCA\Mail\Exception\ServiceException;
+use OCA\Mail\Http\JsonResponse as MailJsonResponse;
+use OCA\Mail\Http\TrapError;
+use OCA\Mail\Service\IONOS\Dto\MailAccountConfig;
+use OCA\Mail\Service\IONOS\IonosMailService;
+use OCP\AppFramework\Controller;
+use OCP\AppFramework\Http\Attribute\OpenAPI;
+use OCP\AppFramework\Http\JSONResponse;
+use OCP\IRequest;
+use Psr\Log\LoggerInterface;
+
+#[OpenAPI(scope: OpenAPI::SCOPE_IGNORE)]
+class IonosAccountsController extends Controller {
+
+	// Error message constants
+	private const ERR_ALL_FIELDS_REQUIRED = 'All fields are required';
+	private const ERR_CREATE_EMAIL_FAILED = 'Failed to create email account';
+	private const ERR_IONOS_API_ERROR = 'IONOS_API_ERROR';
+
+	public function __construct(
+		string $appName,
+		IRequest $request,
+		private IonosMailService $ionosMailService,
+		private AccountsController $accountsController,
+		private LoggerInterface $logger,
+	) {
+		parent::__construct($appName, $request);
+	}
+
+	// Helper: input validation
+	private function validateInput(string $accountName, string $emailUser): ?JSONResponse {
+		if ($accountName === '' || $emailUser === '') {
+			return new JSONResponse(['success' => false, 'message' => self::ERR_ALL_FIELDS_REQUIRED, 'error' => self::ERR_IONOS_API_ERROR], 400);
+		}
+		return null;
+	}
+
+	/**
+	 * @NoAdminRequired
+	 */
+	#[TrapError]
+	public function create(string $accountName, string $emailUser): JSONResponse {
+		if ($error = $this->validateInput($accountName, $emailUser)) {
+			return $error;
+		}
+
+		try {
+			$this->logger->info('Starting IONOS email account creation', [ 'emailAddress' => $emailUser, 'accountName' => $accountName ]);
+			$ionosResponse = $this->ionosMailService->createEmailAccount($emailUser);
+
+			$this->logger->info('IONOS email account created successfully', [ 'emailAddress' => $ionosResponse->getEmail() ]);
+			return $this->createNextcloudMailAccount($accountName, $ionosResponse);
+		} catch (ServiceException $e) {
+			$data = [
+				'error' => self::ERR_IONOS_API_ERROR,
+				'statusCode' => $e->getCode(),
+			];
+			$this->logger->error('IONOS service error: ' . $e->getMessage(), $data);
+
+			return MailJsonResponse::fail($data);
+		} catch (\Exception $e) {
+			return MailJsonResponse::error('Could not create account');
+		}
+	}
+
+	private function createNextcloudMailAccount(string $accountName, MailAccountConfig $mailConfig): JSONResponse {
+		$imap = $mailConfig->getImap();
+		$smtp = $mailConfig->getSmtp();
+
+		return $this->accountsController->create(
+			$accountName,
+			$mailConfig->getEmail(),
+			$imap->getHost(),
+			$imap->getPort(),
+			$imap->getSecurity(),
+			$imap->getUsername(),
+			$imap->getPassword(),
+			$smtp->getHost(),
+			$smtp->getPort(),
+			$smtp->getSecurity(),
+			$smtp->getUsername(),
+			$smtp->getPassword(),
+		);
+	}
+}

lib/Controller/PageController.php

@@ -21,6 +21,7 @@
 use OCA\Mail\Service\AliasesService;
 use OCA\Mail\Service\Classification\ClassificationSettingsService;
 use OCA\Mail\Service\InternalAddressService;
+use OCA\Mail\Service\IONOS\IonosConfigService;
 use OCA\Mail\Service\OutboxService;
 use OCA\Mail\Service\QuickActionsService;
 use OCA\Mail\Service\SmimeService;
@@ -74,7 +75,8 @@ class PageController extends Controller {
 	private InternalAddressService $internalAddressService;
 	private QuickActionsService $quickActionsService;
 
-	public function __construct(string $appName,
+	public function __construct(
+		string $appName,
 		IRequest $request,
 		IURLGenerator $urlGenerator,
 		IConfig $config,
@@ -97,6 +99,7 @@ public function __construct(string $appName,
 		InternalAddressService $internalAddressService,
 		IAvailabilityCoordinator $availabilityCoordinator,
 		QuickActionsService $quickActionsService,
+		private IonosConfigService $ionosConfigService,
 	) {
 		parent::__construct($appName, $request);
 
@@ -208,8 +211,12 @@ public function index(): TemplateResponse {
 
 		$user = $this->userSession->getUser();
 		$response = new TemplateResponse($this->appName, 'index');
+
+
 		$this->initialStateService->provideInitialState('preferences', [
 			'attachment-size-limit' => $this->config->getSystemValue('app.mail.attachment-size-limit', 0),
+			'ionos-mailconfig-enabled' => $this->config->getAppValue('mail', 'ionos-mailconfig-enabled', 'no') === 'yes',
+			'ionos-mailconfig-domain' => $this->ionosConfigService->getMailDomain(),
 			'app-version' => $this->config->getAppValue('mail', 'installed_version'),
 			'external-avatars' => $this->preferences->getPreference($this->currentUserId, 'external-avatars', 'true'),
 			'layout-mode' => $this->preferences->getPreference($this->currentUserId, 'layout-mode', 'vertical-split'),

lib/Service/IONOS/ApiMailConfigClientService.php

@@ -0,0 +1,47 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: 2025 STRATO GmbH
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+namespace OCA\Mail\Service\IONOS;
+
+use GuzzleHttp\ClientInterface;
+use IONOS\MailConfigurationAPI\Client\Api\MailConfigurationAPIApi;
+
+class ApiMailConfigClientService {
+
+	/**
+	 * Create a new client
+	 *
+	 * @param array $config
+	 * @return ClientInterface
+	 */
+	public function newClient(array $config): ClientInterface {
+		return new \GuzzleHttp\Client($config);
+	}
+
+	/**
+	 * Create a new EventAPIApi
+	 *
+	 * @param ClientInterface $client
+	 * @param string $apiBaseUrl
+	 * @return MailConfigurationAPIApi
+	 */
+	public function newEventAPIApi(ClientInterface $client, string $apiBaseUrl): MailConfigurationAPIApi {
+
+		if (empty($apiBaseUrl)) {
+			throw new \InvalidArgumentException('API base URL is required');
+		}
+
+		$apiClient = new MailConfigurationAPIApi(
+			$client,
+		);
+
+		$apiClient->getConfig()->setHost($apiBaseUrl);
+
+		return $apiClient;
+	}
+}

lib/Service/IONOS/Dto/MailAccountConfig.php

@@ -0,0 +1,47 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: 2025 STRATO GmbH
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace OCA\Mail\Service\IONOS\Dto;
+
+/**
+ * Data transfer object for complete mail account configuration
+ */
+class MailAccountConfig {
+	public function __construct(
+		private readonly string $email,
+		private readonly MailServerConfig $imap,
+		private readonly MailServerConfig $smtp,
+	) {
+	}
+
+	public function getEmail(): string {
+		return $this->email;
+	}
+
+	public function getImap(): MailServerConfig {
+		return $this->imap;
+	}
+
+	public function getSmtp(): MailServerConfig {
+		return $this->smtp;
+	}
+
+	/**
+	 * Convert to array format for backwards compatibility
+	 *
+	 * @return array{email: string, imap: array, smtp: array}
+	 */
+	public function toArray(): array {
+		return [
+			'email' => $this->email,
+			'imap' => $this->imap->toArray(),
+			'smtp' => $this->smtp->toArray(),
+		];
+	}
+}

lib/Service/IONOS/Dto/MailServerConfig.php

@@ -0,0 +1,59 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: 2025 STRATO GmbH
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace OCA\Mail\Service\IONOS\Dto;
+
+/**
+ * Data transfer object for mail server configuration (IMAP/SMTP)
+ */
+class MailServerConfig {
+	public function __construct(
+		private readonly string $host,
+		private readonly int $port,
+		private readonly string $security,
+		private readonly string $username,
+		private readonly string $password,
+	) {
+	}
+
+	public function getHost(): string {
+		return $this->host;
+	}
+
+	public function getPort(): int {
+		return $this->port;
+	}
+
+	public function getSecurity(): string {
+		return $this->security;
+	}
+
+	public function getUsername(): string {
+		return $this->username;
+	}
+
+	public function getPassword(): string {
+		return $this->password;
+	}
+
+	/**
+	 * Convert to array format for backwards compatibility
+	 *
+	 * @return array{host: string, port: int, security: string, username: string, password: string}
+	 */
+	public function toArray(): array {
+		return [
+			'host' => $this->host,
+			'port' => $this->port,
+			'security' => $this->security,
+			'username' => $this->username,
+			'password' => $this->password,
+		];
+	}
+}