module Snoo
  # Methods for interacting with links and comments, such as leaving a comment, voting, etc
  #
  # @author (see Snoo)
  module LinksComments

    # Posts a comment to the site
    #
    # @param text [String] The comment text, formatted as markdown
    # @param id [String] The parent object id. Should be a comment or link
    # @return (see #clear_sessions)
    def comment text, id
      logged_in?
      post('/api/comment', body: { text: text, thing_id: id, uh: @modhash})
    end

    # Deletes a thing from the site
    #
    # @param id [String] The thing to target.
    # @return (see #clear_sessions)
    def delete id
      logged_in?
      post('/api/del', body: { id: id, uh: @modhash })
    end

    # Edits a thing.
    # Can be a self post body, or a comment
    #
    # @param (see #comment)
    # @return (see #clear_sessions)
    def edit text, id
      logged_in?
      post('/api/editusertext', body: {text: text, thing_id: id, uh: @modhash})
    end

    # Hides a thing
    #
    # @param (see #delete)
    # @return (see #clear_sessions)
    def hide id
      logged_in?
      post('/api/hide', body: {id: id, uh: @modhash})
    end

    # Get a listing of things which have the provided URL.
    # You can use a plain url, or a reddit link id to get reposts of said link
    # @note Using {Listings#search} is probably better for url lookups
    #
    # @param opts [Hash] An options hash
    # @option opts [String] :id The id of a reddit thing to look up. Specify either this or a url, not both
    # @option opts [String] :url The url to search for matching things. Specify either this or an id, not both
    # @option opts [Fixnum] :limit The number of things to return. Go too high and the API will ignore you
    # @return (see #clear_sessions)
    def info opts = {}
      query = { limit: 100 }
      query.merge! opts
      get('/api/info.json', query: query)
    end

    # Marks a post NSFW. Currently, this only works on links
    #
    # @param (see #delete)
    # @return (see #clear_sessions)
    def mark_nsfw id
      logged_in?
      post('/api/marknsfw', body: {id: id, uh: @modhash})
    end

    # Reports a comment or link
    #
    # @param (see #delete)
    # @reutrn (see #comment)
    def report id
      logged_in?
      post('/api/report', body: {id: id, uh: @modhash})
    end

    # Saves a link
    #
    # @param (see #delete)
    # @return (see #clear_sessions)
    def save id
      logged_in?
      post('/api/save', body: { id: id, uh: @modhash})
    end

    # Submit a link or self post
    #
    # @param title [String] Title of the post
    # @param subreddit [String] The subreddit in which we are posting
    # @param (see #info)
    # @option opts [String] :url The url for the post. If this is specified, it will not be a self post, and `text` will be ignored
    # @option opts [String] :text The self-post text. Can be formatted in markdown
    # @return (see #clear_sessions)
    def submit title, subreddit, opts = {}
      logged_in?
      post = {
        title: title,
        sr: subreddit,
        uh: @modhash,
        kind: (opts[:url] ? "link" : "self")
      }
      post.merge! opts
      post('/api/submit', body: post)
    end

    # Unhide a thing
    #
    # @param (see #delete)
    # @return (see #clear_sessions)
    def unhide id
      logged_in?
      post('/api/unhide', body: {id: id, uh: @modhash})
    end

    # Un-mark NSFW a thing.
    #
    # @param (see #delete)
    # @return (see #clear_sessions)
    def unmark_nsfw id
      logged_in?
      post('/api/unmarknsfw', body: {id: id, uh: @modhash})
    end
    alias_method :mark_sfw, :unmark_nsfw

    # Vote on a comment or link
    #
    # @param direction [-1, 0, 1] The direction to vote in. -1 is a downvote, 1 is an upvote, 0 cancels any vote
    # @param id [String] The thing to target.
    # @return (see #clear_sessions)
    def vote direction, id
      logged_in?
      post('/api/vote', body: {id: id, dir: direction, uh: @modhash})
    end

    # Upvote
    # An alias for `vote 1, id`
    #
    def upvote id
      vote 1, id
    end

    # Downvote
    # An alias for `vote -1, id`
    #
    def downvote id
      vote -1, id
    end

    # Sidevote (clear your vote)
    # An alias for `vote 0, id`
    #
    def sidevote id
      vote 0, id
    end

  end
end