Add outbox REST API stubs

Signed-off-by: Christoph Wurst <christoph@winzerhof-wurst.at>

2 files changed, 200 insertions, 1 deletions

diff --git a/appinfo/routes.php b/appinfo/routes.php
index 6242fe0e2..db642c8cd 100644
--- a/appinfo/routes.php
+++ b/appinfo/routes.php
@@ -308,7 +308,12 @@ return [
 			'name' => 'thread#move',
 			'url' => '/api/thread/{id}',
 			'verb' => 'POST'
-		]
+		],
+		[
+			'name' => 'outbox#send',
+			'url' => '/api/outbox/{id}',
+			'verb' => 'POST'
+		],
 	],
 	'resources' => [
 		'accounts' => ['url' => '/api/accounts'],
@@ -317,6 +322,7 @@ return [
 		'localAttachments' => ['url' => '/api/attachments'],
 		'mailboxes' => ['url' => '/api/mailboxes'],
 		'messages' => ['url' => '/api/messages'],
+		'outbox' => ['url' => '/api/outbox'],
 		'preferences' => ['url' => '/api/preferences'],
 	]
 ];
diff --git a/lib/Controller/OutboxController.php b/lib/Controller/OutboxController.php
new file mode 100644
index 000000000..5d1975a32
--- /dev/null
+++ b/lib/Controller/OutboxController.php
@@ -0,0 +1,193 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * Mail App
+ *
+ * @copyright 2022 Anna Larch <anna.larch@gmx.net>
+ *
+ * @author Anna Larch <anna.larch@gmx.net>
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU AFFERO GENERAL PUBLIC LICENSE
+ * License as published by the Free Software Foundation; either
+ * version 3 of the License, or any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU AFFERO GENERAL PUBLIC LICENSE for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public
+ * License along with this library.  If not, see <http://www.gnu.org/licenses/>.
+ *
+ */
+
+namespace OCA\Mail\Controller;
+
+use OCA\Mail\Http\JsonResponse;
+use OCP\AppFramework\Controller;
+use OCP\AppFramework\Http;
+use OCP\IRequest;
+
+class OutboxController extends Controller {
+	public function __construct(string $appName,
+								IRequest $request) {
+		parent::__construct($appName, $request);
+	}
+
+	private function stubbedMessage(int $id): array {
+		return [
+			'id' => $id,
+			'type' => 0,
+			'accountId' => 123,
+			'aliasId' => null,
+			'sendAt' => null,
+			'subject' => 'I am a stub',
+			'text' => 'bonjour',
+			'html' => false,
+			'inReplyToId' => null,
+			'draftId' => null,
+			'attachments' => [],
+			'to' => [
+				[
+					'id' => 1001,
+					'messageId' => $id,
+					'type' => 1,
+					'label' => 'Reci Pient One',
+					'email' => 'rep1@domain.tld',
+				],
+				[
+					'id' => 1002,
+					'messageId' => $id,
+					'type' => 1,
+					'label' => 'Recipient Two',
+					'email' => 'rep2@domain.tld',
+				],
+			],
+			'cc' => [],
+			'bcc' => [],
+		];
+	}
+
+	/**
+	 * @NoAdminRequired
+	 * @TrapError
+	 */
+	public function index(): JSONResponse {
+		return JsonResponse::success([
+			'messages' => [
+				$this->stubbedMessage(101),
+				$this->stubbedMessage(102),
+			],
+		]);
+	}
+
+	/**
+	 * @NoAdminRequired
+	 * @TrapError
+	 *
+	 * @param int $id
+	 */
+	public function show(int $id): JSONResponse {
+		if ($id === 101) {
+			return JsonResponse::success($this->stubbedMessage(101));
+		}
+
+		return JsonResponse::fail(null, Http::STATUS_NOT_FOUND);
+	}
+
+	/**
+	 * @NoAdminRequired
+	 * @TrapError
+	 *
+	 * @param int $accountId
+	 * @param string $subject
+	 * @param string $body
+	 * @param bool $isHtml
+	 * @param array $to i. e. [['label' => 'Lewis', 'email' => 'tent@stardewvalley.com'], ['label' => 'Pierre', 'email' => 'generalstore@stardewvalley.com']]
+	 * @param array $cc
+	 * @param array $bcc
+	 * @param array $attachmentIds
+	 * @param int|null $aliasId
+	 * @param int|null $inReplyToId
+	 * @param int|null $draftId
+	 */
+	public function create(
+		int $accountId,
+		string $subject,
+		string $body,
+		bool $isHtml,
+		array $to = [],
+		array $cc = [],
+		array $bcc = [],
+		array $attachmentIds = [],
+		?int $aliasId = null,
+		?int $inReplyToId = null,
+		?int $draftId = null
+	): JSONResponse {
+		if ($subject === 'error') {
+			return JsonResponse::error('the server errored');
+		}
+
+		if ($subject === 'invalid') {
+			return JsonResponse::fail('invalid message', Http::STATUS_UNPROCESSABLE_ENTITY);
+		}
+
+		return JsonResponse::success($this->stubbedMessage(103), Http::STATUS_CREATED);
+	}
+
+	/**
+	 * @NoAdminRequired
+	 * @TrapError
+	 *
+	 * @param int $id
+	 */
+	public function update(int $id,
+							int $accountId,
+							string $subject,
+							string $body,
+							bool $isHtml,
+							array $to = [],
+							array $cc = [],
+							array $bcc = [],
+							array $attachmentIds = [],
+							?int $aliasId = null,
+							?int $inReplyToId = null,
+							?int $draftId = null): JSONResponse {
+		if ($id === 101) {
+			return JsonResponse::success($this->stubbedMessage($id));
+		}
+
+		return JsonResponse::fail('message not found', Http::STATUS_NOT_FOUND);
+	}
+
+	/**
+	 * @NoAdminRequired
+	 * @TrapError
+	 *
+	 * @param int $id
+	 */
+	public function send(int $id): JSONResponse {
+		if ($id === 102) {
+			return JsonResponse::error('could not send message');
+		}
+
+		return JsonResponse::success($this->stubbedMessage($id));
+	}
+
+	/**
+	 * @NoAdminRequired
+	 * @TrapError
+	 *
+	 * @param int $id
+	 */
+	public function destroy(int $id): JSONResponse {
+		if ($id === 101) {
+			return JsonResponse::success($this->stubbedMessage($id));
+		}
+
+		return JsonResponse::fail('message not found', Http::STATUS_NOT_FOUND);
+	}
+}