module ChatWork
  module Task
    extend EntityMethods

    # Get the list of tasks associated with the specified chat
    #
    # (*This method returns up to 100 entries. We are planning to implement pagination to support larger number of data retrieval)
    #
    # @see http://developer.chatwork.com/ja/endpoint_rooms.html#GET-rooms-room_id-tasks
    # @see http://download.chatwork.com/ChatWork_API_Documentation.pdf
    #
    # @param room_id [Integer]
    # @param account_id [Integer]
    # @param assigned_by_account_id [Integer] Account ID of the person who assigned task
    # @param status [String] Task status (open, done)
    #
    # @return [Array<Hashie::Mash>]
    #
    # @example response format
    #   [
    #     {
    #       "task_id": 3,
    #       "account": {
    #         "account_id": 123,
    #         "name": "Bob",
    #         "avatar_image_url": "https://example.com/abc.png"
    #       },
    #       "assigned_by_account": {
    #         "account_id": 456,
    #         "name": "Anna",
    #         "avatar_image_url": "https://example.com/def.png"
    #       },
    #       "message_id": "13",
    #       "body": "buy milk",
    #       "limit_time": 1384354799,
    #       "status": "open"
    #     }
    #   ]
    def self.get(room_id:, account_id:, assigned_by_account_id: nil, status: nil)
      _get("/rooms/#{room_id}/tasks", account_id: account_id, assigned_by_account_id: assigned_by_account_id, status: status)
    end

    # Add a new task to the chat
    #
    # @see http://developer.chatwork.com/ja/endpoint_rooms.html#POST-rooms-room_id-tasks
    # @see http://download.chatwork.com/ChatWork_API_Documentation.pdf
    #
    # @param room_id [Integer]
    # @param body    [String] Task description
    # @param to_ids [Array<Integer>, String] Account ID of the person/people responsible to complete the task
    # @param limit  [Time, Integer] When the task is due
    #
    # @return [Hashie::Mash]
    #
    # @example response format
    #   {
    #     "task_ids": [123,124]
    #   }
    def self.create(room_id:, body:, to_ids:, limit: nil)
      params = {
        body:   body,
        to_ids: Array(to_ids).join(","),
      }
      params[:limit] = limit.to_i if limit

      _post("/rooms/#{room_id}/tasks", params)
    end

    # Get information about the specified task
    #
    # @see http://developer.chatwork.com/ja/endpoint_rooms.html#GET-rooms-room_id-tasks-task_id
    # @see http://download.chatwork.com/ChatWork_API_Documentation.pdf
    #
    # @param room_id [Integer]
    # @param task_id [Integer]
    #
    # @return [Hashie::Mash]
    #
    # @example response format
    #   {
    #     "task_id": 3,
    #     "account": {
    #       "account_id": 123,
    #       "name": "Bob",
    #       "avatar_image_url": "https://example.com/abc.png"
    #     },
    #     "assigned_by_account": {
    #       "account_id": 456,
    #       "name": "Anna",
    #       "avatar_image_url": "https://example.com/def.png"
    #     },
    #     "message_id": "13",
    #     "body": "buy milk",
    #     "limit_time": 1384354799,
    #     "status": "open"
    #   }
    def self.find(room_id:, task_id:)
      _get("/rooms/#{room_id}/tasks/#{task_id}")
    end
  end
end