Version 5.0.13

applications/core/api/messages.php

@@ -15,16 +15,19 @@ namespace IPS\core\api;
 
 use IPS\Api\Controller;
 use IPS\Api\Exception;
+use IPS\Api\PaginatedResponse;
 use IPS\Api\Response;
 use IPS\core\Messenger\Conversation;
 use IPS\core\Messenger\Message;
 use IPS\DateTime;
+use IPS\Db;
 use IPS\Member;
 use IPS\Request;
 use IPS\Text\Parser;
 use OutOfRangeException;
 use function count;
 use function defined;
+use function in_array;
 use function is_array;
 
 if ( !defined( '\IPS\SUITE_UNIQUE_KEY' ) )
@@ -38,6 +41,129 @@ if ( !defined( '\IPS\SUITE_UNIQUE_KEY' ) )
  */
 class messages extends Controller
 {
+	/**
+	 * GET /core/messages
+	 * Get a list of conversations
+	 *
+	 * @apiparam	int	page	Page number
+	 * @apiparam	int	perPage	Number of results per page - defaults to 25
+	 * @apiparam	string	sortBy	What to sort by. Can be 'start_time', 'last_post_time' or leave unspecified for ID
+	 * @apiparam	string	sortDir	Sort direction. Can be 'asc' or 'desc' - defaults to 'asc'
+	 * @apireturn	PaginatedResponse<IPS\core\Messenger\Conversation>
+	 * @return		PaginatedResponse<Conversation>
+	 */
+	public function GETindex() : PaginatedResponse
+	{
+		$where = [];
+		if( $this->member instanceof Member )
+		{
+			$where = [
+				[ 'map_user_id=?', $this->member->member_id ],
+				[ 'map_user_active=?', 1 ]
+			];
+		}
+
+		/* Sort */
+		$sortBy = ( isset( Request::i()->sortBy ) and in_array( Request::i()->sortBy, array( 'start_time', 'last_post_time' ) ) ) ? Request::i()->sortBy : 'id';
+		$sortBy = 'mt_' . $sortBy;
+		$sortDir = ( isset( Request::i()->sortDir ) and in_array( mb_strtolower( Request::i()->sortDir ), array( 'asc', 'desc' ) ) ) ? Request::i()->sortDir : 'asc';
+
+		if( $this->member instanceof Member )
+		{
+			return new PaginatedResponse(
+				200,
+				Db::i()->select( '*', 'core_message_topic_user_map', $where, "{$sortBy} {$sortDir}" )
+					->join( 'core_message_topics', 'map_topic_id=mt_id' ),
+				Request::i()->page ?? 1,
+				'IPS\core\Messenger\Conversation',
+				Db::i()->select( 'COUNT(*)', 'core_message_topic_user_map', $where )->first(),
+				$this->member,
+				Request::i()->perPage ?? null
+			);
+		}
+
+		/* Return */
+		return new PaginatedResponse(
+			200,
+			Db::i()->select( '*', 'core_message_topics', $where, "{$sortBy} {$sortDir}" ),
+			Request::i()->page ?? 1,
+			'IPS\core\Messenger\Conversation',
+			Db::i()->select( 'COUNT(*)', 'core_message_topics', $where )->first(),
+			$this->member,
+			Request::i()->perPage ?? null
+		);
+	}
+
+	/**
+	 * GET /core/messages/{id}
+	 * Get a Conversation
+	 *
+	 * @param		int		$id			Conversation ID
+	 * @throws		1G100/3	INVALID_ID	The Conversation ID does not exist
+	 * @apireturn		\IPS\core\Messenger\Conversation
+	 * @return 	Response
+	 */
+	public function GETitem( int $id ) : Response
+	{
+		try
+		{
+			return new Response( 200, Conversation::load( $id )->apiOutput( $this->member ) );
+		}
+		catch ( OutOfRangeException $e )
+		{
+			throw new Exception( 'INVALID_ID', '1G100/3', 404 );
+		}
+	}
+
+
+	/**
+	 * GET /core/messages/{id}/replies
+	 * Get a list of messages for a Conversation
+	 *
+	 * @param 		int		$id			Conversation ID Number
+	 * @apiparam	int		page		Page number
+	 * @apiparam	int		perPage		Number of results per page - defaults to 25
+	 * @apireturn	PaginatedResponse<IPS\core\Messenger\Message>
+	 * @return	PaginatedResponse<Message>
+	 */
+	public function GETitem_replies( int $id ) : PaginatedResponse
+	{
+		$where = array('msg_topic_id=?', $id);
+
+		/* Return */
+		return new PaginatedResponse(
+			200,
+			Db::i()->select( '*', 'core_message_posts', $where ),
+			Request::i()->page ?? 1,
+			'IPS\core\Messenger\Message',
+			Db::i()->select( 'COUNT(*)', 'core_message_posts', $where )->first(),
+			$this->member,
+			Request::i()->perPage ?? null
+		);
+	}
+
+	/**
+	 * GET /core/messages/{id}/reply/{replyId}
+	 * Get a Message
+	 *
+	 * @param 		int		$id			Conversation ID Number
+	 * @param 		int		$replyId	Message ID number
+	 * @throws		1G100/4	INVALID_ID	The Message ID does not exist
+	 * @apireturn		\IPS\core\Messenger\Message
+	 * @return Response
+	 */
+	public function GETitem_reply( int $id, int $replyId ) : Response
+	{
+		try
+		{
+			return new Response( 200, Message::load( $replyId )->apiOutput( $this->member ) );
+		}
+		catch ( OutOfRangeException $e )
+		{
+			throw new Exception( 'INVALID_ID', '1G100/4', 404 );
+		}
+	}
+
 	/**
 	 * POST /core/messages
 	 * Create a new personal conversation