<?php

class Thrive_Dash_Api_Mailchimp_Conversations {
	public function __construct( Thrive_Dash_Api_Mailchimp $master ) {
		$this->master = $master;
	}

	/**
	 * Retrieve conversation metadata, includes message data for the most recent message in the conversation
	 *
	 * @param string $list_id
	 * @param string $leid
	 * @param string $campaign_id
	 * @param int $start
	 * @param int $limit
	 *
	 * @return associative_array Conversation data and metadata
	 *     - count int Total number of conversations, irrespective of pagination.
	 *     - data array An array of structs representing individual conversations
	 *         - unique_id string A string identifying this particular conversation
	 *         - message_count int The total number of messages in this conversation
	 *         - campaign_id string The unique identifier of the campaign this conversation is associated with (will be null if the campaign has been deleted)
	 *         - list_id string The unique identifier of the list this conversation is associated with
	 *         - unread_messages int The number of messages in this conversation which have not yet been read.
	 *         - from_label string A label representing the sender of this message.
	 *         - from_email string The email address of the sender of this message.
	 *         - subject string The subject of the message.
	 *         - timestamp string Date the message was either sent or received.
	 *         - last_message associative_array The most recent message in the conversation
	 *             - from_label string A label representing the sender of this message.
	 *             - from_email string The email address of the sender of this message.
	 *             - subject string The subject of the message.
	 *             - message string The plain-text content of the message.
	 *             - read boolean Whether or not this message has been marked as read.
	 *             - timestamp string Date the message was either sent or received.
	 */
	public function getList( $list_id = null, $leid = null, $campaign_id = null, $start = 0, $limit = 25 ) {
		$_params = array( "list_id" => $list_id, "leid" => $leid, "campaign_id" => $campaign_id, "start" => $start, "limit" => $limit );

		return $this->master->call( 'conversations/list', $_params );
	}

	/**
	 * Retrieve conversation messages
	 *
	 * @param string $conversation_id
	 * @param boolean $mark_as_read
	 * @param int $start
	 * @param int $limit
	 *
	 * @return associative_array Message data and metadata
	 *     - count int The number of messages in this conversation, irrespective of paging.
	 *     - data array An array of structs representing each message in a conversation
	 *         - from_label string A label representing the sender of this message.
	 *         - from_email string The email address of the sender of this message.
	 *         - subject string The subject of the message.
	 *         - message string The plain-text content of the message.
	 *         - read boolean Whether or not this message has been marked as read.
	 *         - timestamp string Date the message was either sent or received.
	 */
	public function messages( $conversation_id, $mark_as_read = false, $start = 0, $limit = 25 ) {
		$_params = array( "conversation_id" => $conversation_id, "mark_as_read" => $mark_as_read, "start" => $start, "limit" => $limit );

		return $this->master->call( 'conversations/messages', $_params );
	}

	/**
	 * Reply to a conversation
	 *
	 * @param string $conversation_id
	 * @param string $message
	 *
	 * @return associative_array Message data from the created message
	 *     - from_label string A label representing the sender of this message.
	 *     - from_email string The email address of the sender of this message.
	 *     - subject string The subject of the message.
	 *     - message string The plain-text content of the message.
	 *     - read boolean Whether or not this message has been marked as read.
	 *     - timestamp string Date the message was either sent or received.
	 */
	public function reply( $conversation_id, $message ) {
		$_params = array( "conversation_id" => $conversation_id, "message" => $message );

		return $this->master->call( 'conversations/reply', $_params );
	}

}


