module Lumberg
  module Whm
    # Some WHM functions require different params for the same 'thing'
    # e.g. some accept 'username' while others accept 'user'
    # Be sure to keep our API consistent and work around those inconsistencies internally
    class Account < Base

      # Creates a hosting account and sets up its associated domain information
      #
      # ==== Required
      #  * <tt>:username</tt> - PENDING
      #  * <tt>:domain</tt> - PENDING
      #  * <tt>:password</tt> - PENDING
      #
      # ==== Optional
      #  * <tt>:plan</tt> - PENDING
      #  * <tt>:pkgname</tt> - PENDING
      #  * <tt>:savepkg</tt> - PENDING
      #  * <tt>:featurelist</tt> - PENDING
      #  * <tt>:quota</tt> - PENDING
      #  * <tt>:ip</tt> - PENDING
      #  * <tt>:cgi</tt> - PENDING
      #  * <tt>:</tt> - PENDING
      def create(options = {})
        server.perform_request('createacct', options)
      end

      # Permanently removes a cPanel account
      #
      # ==== Required
      #  * <tt>:username</tt> - PENDING
      def remove(options = {})
        options[:user] = options.delete(:username)
        server.perform_request('removeacct', options)
      end

      # Changes the password of a domain owner (cPanel) or reseller (WHM) account
      #
      # ==== Required
      #  * <tt>:username</tt> - PENDING
      #  * <tt>:password</tt> - PENDING
      def change_password(options = {})
        options[:user] = options.delete(:username)
        options[:pass] = options.delete(:password)
        server.perform_request('passwd', options.merge(response_key: 'passwd'))
      end

      # Displays pertinent information about a specific account
      #
      # ==== Required
      #  * <tt>:username</tt> - PENDING
      def summary(options = {})
        options[:user] = options.delete(:username)
        server.perform_request('accountsummary', options)
      end

      # Modifies the bandwidth usage (transfer) limit for a specific account
      #
      # ==== Required
      #  * <tt>:username</tt> - PENDING
      #  * <tt>:bwlimit</tt> - PENDING
      def limit_bandwidth(options = {})
        verify_user(options[:username]) do
          options[:user] = options.delete(:username)
          server.perform_request('limitbw', options) do |s|
            s.boolean_params = :unlimited, :bwlimitenable
          end
        end
      end

      # Lists all accounts on the server, and also allows you to search for a specific account or set of accounts

      #
      # ==== Optional
      #  * <tt>:searchtype</tt> - PENDING
      #  * <tt>:search</tt> - PENDING
      def list(options = {})
        server.perform_request('listaccts', options) do |s|
          s.boolean_params = :suspended
        end
      end

      # Modifies settings for an account
      #
      # ==== Required
      #  * <tt>:username</tt> - PENDING
      #
      # ==== Optional
      #  * <tt>:domain</tt> - PENDING
      #  * <tt>:newuser</tt> - PENDING
      #  * <tt>:owner</tt> - PENDING
      #  * <tt>:CPTHEME</tt> - PENDING
      #  * <tt>:HASCGI</tt> - PENDING
      #  * <tt>:LANG</tt> - PENDING
      #  * <tt>:LOCALE</tt> - PENDING
      #  * <tt>:MAXFTP</tt> - PENDING
      #  * <tt>:MAXSQL</tt> - PENDING
      #  * <tt>:MAXPOP</tt> - PENDING
      #  * <tt>:MAXLST</tt> - PENDING
      #  * <tt>:MAXSUB</tt> - PENDING
      #  * <tt>:MAXPARK</tt> - PENDING
      #  * <tt>:MAXADDON</tt> - PENDING
      #  * <tt>:shell</tt> - PENDING
      def modify(options = {})
        options[:user] = options.delete(:username)
        server.perform_request('modifyacct', options) do |s|
          s.boolean_params = :DEMO
        end
      end

      # Changes an account's disk space usage quota
      #
      # ==== Required
      #  * <tt>:username</tt> - PENDING
      #  * <tt>:quota</tt> - PENDING
      def edit_quota(options = {})
        options[:user] = options.delete(:username)
        server.perform_request('editquota', options)
      end

      # Adds a new hosting package
      #
      # ==== Required
      #  * <tt>:name</tt> - PENDING
      #
      # ==== Optional
      #  * <tt>:featurelist</tt> - PENDING
      #  * <tt>:quota</tt> - PENDING
      #  * <tt>:ip</tt> - PENDING
      #  * <tt>:cgi</tt> - PENDING
      #  * <tt>:frontpage</tt> - PENDING
      #  * <tt>:cpmod</tt> - PENDING
      #  * <tt>:language</tt> - PENDING
      #  * <tt>:maxftp</tt> - PENDING
      #  * <tt>:maxsql</tt> - PENDING
      #  * <tt>:maxpop</tt> - PENDING
      #  * <tt>:maxlists</tt> - PENDING
      #  * <tt>:maxsub</tt> - PENDING
      #  * <tt>:maxpark</tt> - PENDING
      #  * <tt>:maxaddon</tt> - PENDING
      #  * <tt>:hasshell</tt> - PENDING
      #  * <tt>:bwlimit</tt> - PENDING
      def add_package(options = {})
        server.perform_request('addpkg', options)
      end

      # Changes the hosting package associated with a cPanel account
      #
      # ==== Required
      #  * <tt>:username</tt> - PENDING
      #  * <tt>:pkg</tt> - PENDING
      def change_package(options = {})
        options[:user] = options.delete(:username)
        server.perform_request('changepackage', options)
      end

      # Obtains user data for a specific domain
      #
      # ==== Required
      #  * <tt>:domain</tt> - PENDING
      def domain_user_data(options = {})
        server.perform_request('domainuserdata', options.merge(response_key: 'userdata')) do |s|
          s.boolean_params = :hascgi
        end
      end

      # Prevents a cPanel user from accessing his or her account. Once an account is suspended, it can be un-suspended to allow a user to access the account again
      #
      # ==== Required
      #  * <tt>:username</tt> - PENDING
      #
      # ==== Optional
      #  * <tt>:reason</tt> - PENDING
      def suspend(options ={})
        options[:user] = options.delete(:username)
        server.perform_request('suspendacct', options)
      end

      # Unsuspend a suspended account. When a user's account is unsuspended, he or she will be able to access cPanel again
      #
      # ==== Required
      #  * <tt>:username</tt> - PENDING
      def unsuspend(options ={})
        options[:user] = options.delete(:username)
        server.perform_request('unsuspendacct', options)
      end

      # Generates a list of suspended accounts
      def list_suspended(options = {})
        server.perform_request('listsuspended', options)
      end

      # Generates a list of features you are allowed to use in WHM. Each feature will display either a 1 or 0. You are only able to use features with a corresponding 1
      #
      # ==== Required
      #  * <tt>:username</tt> - PENDING
      def privs(options ={})
        verify_user(options[:username]) do
          resp = server.perform_request('myprivs', options.merge(response_key: 'privs')) do |s|
            s.boolean_params = :all
          end
          # if you get this far, it's successful
          resp[:success] = true
          resp
        end
      end

      # Changes the IP address of a website, or a user account, hosted on your server
      #
      # ==== Required
      #  * <tt>:ip</tt> - PENDING
      def set_site_ip(options = {})
        options[:user] = options.delete(:username) if options[:username]
        server.perform_request('setsiteip', options)
      end

      # Restores a user's account from a backup file. You may restore a monthly, weekly, or daily backup
      #
      # ==== Required
      #  * <tt>:username</tt> - PENDING
      #  * <tt>:type</tt> - PENDING
      #  * <tt>:all</tt> - PENDING
      #  * <tt>:ip</tt> - PENDING
      #  * <tt>:mail</tt> - PENDING
      #  * <tt>:mysql</tt> - PENDING
      #  * <tt>:subs</tt> - PENDING
      def restore_account(options = {})
        options[:user] = options.delete(:username) if options[:username]
        server.perform_request('restoreaccount', options.merge(response_key: 'metadata'))
      end

      protected
      # Some WHM API methods always return a result, even if the user
      # doesn't actually exist. This makes it seem like your request
      # was successful when it really wasn't
      #
      # Example
      #   verify_user('bob') do
      #      change_password()
      #   end
      def verify_user(username, &block)
        exists = summary(username: username)
        if exists[:success]
          yield
        else
          raise WhmInvalidUser, "User #{username} does not exist"
        end
      end

    end
  end
end