feat: Conversations

.github/PULL_REQUEST_TEMPLATE.md

@@ -4,13 +4,14 @@
 - [ ] Read the [CONTRIBUTING document](https://github.com/monicahq/monica/blob/master/CONTRIBUTING.md) before submitting your PR.
 - [ ] If the PR is related to an issue or fix one, don't forget to indicate it.
 - [ ] Make sure that the change you propose is the smallest possible.
+- [ ] If you change the UI, make sure to ask repositories administrators first about your changes.
 - [ ] Screenshots are included if the PR changes the UI.
-- [ ] If you change the UI, make sure the user experience is consistent with the current interface.
 
 #### Code-related tasks
 - [ ] Tests added for this feature/bug.
 - [ ] Impact on the seeders.
 - [ ] Impact on the API.
+- [ ] If API is impacted, maintain the API's documentation.
 
 #### If the code changes the SQL schema
 - [ ] Impact on account export.

app/Http/Controllers/Api/Contact/ApiConversationController.php

@@ -0,0 +1,139 @@
+<?php
+
+namespace App\Http\Controllers\Api\Contact;
+
+use Illuminate\Http\Request;
+use App\Models\Contact\Conversation;
+use Illuminate\Database\QueryException;
+use App\Http\Controllers\Api\ApiController;
+use Illuminate\Database\Eloquent\ModelNotFoundException;
+use App\Services\Contact\Conversation\CreateConversation;
+use App\Services\Contact\Conversation\UpdateConversation;
+use App\Services\Contact\Conversation\DestroyConversation;
+use App\Http\Resources\Conversation\Conversation as ConversationResource;
+
+class ApiConversationController extends ApiController
+{
+    /**
+     * Get the list of conversations.
+     *
+     * @return \Illuminate\Http\Response
+     */
+    public function index(Request $request)
+    {
+        try {
+            $conversations = auth()->user()->account->conversations()
+                ->orderBy($this->sort, $this->sortDirection)
+                ->paginate($this->getLimitPerPage());
+        } catch (QueryException $e) {
+            return $this->respondInvalidQuery();
+        }
+
+        return ConversationResource::collection($conversations);
+    }
+
+    /**
+     * Get the detail of a given conversation.
+     *
+     * @param  Request $request
+     * @return \Illuminate\Http\Response
+     */
+    public function show(Request $request, $conversationId)
+    {
+        try {
+            $conversation = Conversation::where('account_id', auth()->user()->account_id)
+                ->findOrFail($conversationId);
+        } catch (ModelNotFoundException $e) {
+            return $this->respondNotFound();
+        }
+
+        return new ConversationResource($conversation);
+    }
+
+    /**
+     * Store the conversation.
+     *
+     * @param  Request $request
+     * @return \Illuminate\Http\Response
+     */
+    public function store(Request $request)
+    {
+        try {
+            $conversation = (new CreateConversation)->execute(
+                $request->all()
+                +
+                [
+                    'account_id' => auth()->user()->account->id,
+                ]
+            );
+        } catch (ModelNotFoundException $e) {
+            return $this->respondNotFound();
+        } catch (\Exception $e) {
+            return $this->setHTTPStatusCode(500)
+                        ->setErrorCode(41)
+                        ->respondWithError(config('api.error_codes.41'));
+        } catch (QueryException $e) {
+            return $this->respondInvalidQuery();
+        }
+
+        return new ConversationResource($conversation);
+    }
+
+    /**
+     * Update the conversation.
+     *
+     * @param  Request $request
+     * @param  int $conversationId
+     * @return \Illuminate\Http\Response
+     */
+    public function update(Request $request, $conversationId)
+    {
+        try {
+            $conversation = (new UpdateConversation)->execute(
+                $request->all()
+                +
+                [
+                    'account_id' => auth()->user()->account->id,
+                    'conversation_id' => $conversationId,
+                ]
+            );
+        } catch (ModelNotFoundException $e) {
+            return $this->respondNotFound();
+        } catch (\Exception $e) {
+            return $this->setHTTPStatusCode(500)
+                        ->setErrorCode(41)
+                        ->respondWithError(config('api.error_codes.41'));
+        } catch (QueryException $e) {
+            return $this->respondInvalidQuery();
+        }
+
+        return new ConversationResource($conversation);
+    }
+
+    /**
+     * Destroy the conversation.
+     *
+     * @param  Request $request
+     * @param  int $conversationId
+     * @return \Illuminate\Http\Response
+     */
+    public function destroy(Request $request, $conversationId)
+    {
+        try {
+            $conversation = (new DestroyConversation)->execute([
+                'account_id' => auth()->user()->account->id,
+                'conversation_id' => $conversationId,
+            ]);
+        } catch (ModelNotFoundException $e) {
+            return $this->respondNotFound();
+        } catch (\Exception $e) {
+            return $this->setHTTPStatusCode(500)
+                ->setErrorCode(41)
+                ->respondWithError(config('api.error_codes.41'));
+        } catch (QueryException $e) {
+            return $this->respondInvalidQuery();
+        }
+
+        return $this->respondObjectDeleted((int) $conversationId);
+    }
+}

app/Http/Controllers/Api/Contact/ApiMessageController.php

@@ -0,0 +1,131 @@
+<?php
+
+namespace App\Http\Controllers\Api\Contact;
+
+use Illuminate\Http\Request;
+use App\Models\Contact\Message;
+use App\Models\Contact\Conversation;
+use Illuminate\Database\QueryException;
+use App\Http\Controllers\Api\ApiController;
+use App\Services\Contact\Conversation\UpdateMessage;
+use App\Services\Contact\Conversation\DestroyMessage;
+use Illuminate\Database\Eloquent\ModelNotFoundException;
+use App\Services\Contact\Conversation\AddMessageToConversation;
+use App\Http\Resources\Conversation\Conversation as ConversationResource;
+
+class ApiMessageController extends ApiController
+{
+    /**
+     * Store the message.
+     *
+     * @param  Request $request
+     * @return \Illuminate\Http\Response
+     */
+    public function store(Request $request, int $conversationId)
+    {
+        try {
+            $conversation = Conversation::findOrFail($conversationId);
+        } catch (ModelNotFoundException $e) {
+            return $this->respondNotFound();
+        }
+
+        try {
+            (new AddMessageToConversation)->execute(
+                $request->all()
+                +
+                [
+                    'account_id' => auth()->user()->account->id,
+                    'conversation_id' => $conversation->id,
+                    'contact_id' => $conversation->contact->id,
+                ]
+            );
+        } catch (ModelNotFoundException $e) {
+            return $this->respondNotFound();
+        } catch (\Exception $e) {
+            return $this->setHTTPStatusCode(500)
+                        ->setErrorCode(41)
+                        ->respondWithError(config('api.error_codes.41'));
+        } catch (QueryException $e) {
+            return $this->respondInvalidQuery();
+        }
+
+        return new ConversationResource($conversation);
+    }
+
+    /**
+     * Update the message.
+     *
+     * @param  Request $request
+     * @param  int $conversationId
+     * @param  int $messageId
+     * @return \Illuminate\Http\Response
+     */
+    public function update(Request $request, int $conversationId, int $messageId)
+    {
+        try {
+            $conversation = Conversation::findOrFail($conversationId);
+            $message = Message::findOrFail($messageId);
+        } catch (ModelNotFoundException $e) {
+            return $this->respondNotFound();
+        }
+
+        try {
+            (new UpdateMessage)->execute(
+                $request->all()
+                +
+                [
+                    'account_id' => auth()->user()->account->id,
+                    'conversation_id' => $conversationId,
+                    'message_id' => $messageId,
+                    'contact_id' => $conversation->contact->id,
+                ]
+            );
+        } catch (ModelNotFoundException $e) {
+            return $this->respondNotFound();
+        } catch (\Exception $e) {
+            return $this->setHTTPStatusCode(500)
+                        ->setErrorCode(41)
+                        ->respondWithError(config('api.error_codes.41'));
+        } catch (QueryException $e) {
+            return $this->respondInvalidQuery();
+        }
+
+        return new ConversationResource($conversation);
+    }
+
+    /**
+     * Destroy the message.
+     *
+     * @param  Request $request
+     * @param  int $conversationId
+     * @param  int $messageId
+     * @return \Illuminate\Http\Response
+     */
+    public function destroy(Request $request, int $conversationId, int $messageId)
+    {
+        try {
+            Conversation::findOrFail($conversationId);
+            Message::findOrFail($messageId);
+        } catch (ModelNotFoundException $e) {
+            return $this->respondNotFound();
+        }
+
+        try {
+            (new DestroyMessage)->execute([
+                'account_id' => auth()->user()->account->id,
+                'conversation_id' => $conversationId,
+                'message_id' => $messageId,
+            ]);
+        } catch (ModelNotFoundException $e) {
+            return $this->respondNotFound();
+        } catch (\Exception $e) {
+            return $this->setHTTPStatusCode(500)
+                ->setErrorCode(41)
+                ->respondWithError(config('api.error_codes.41'));
+        } catch (QueryException $e) {
+            return $this->respondInvalidQuery();
+        }
+
+        return $this->respondObjectDeleted((int) $messageId);
+    }
+}