andresbravog/signnow-ruby

module Signnow
  module Operations
    module Find
      module ClassMethods
        # Finds a given object
        #
        # @param [Integer] id The id of the object that should be found
        # @return [Signnow::Base] The found object
        def find(attibutes)
          id = attibutes.delete(:id)
          response = Signnow.request(:get, nil, api_find_url(id), {}, options_for_find(attributes))
          self.new(response["data"])
        end

        # URl for the find endpoint
        # overwrite this in the model if the api is not well named
        #
        def api_find_url(id)
          "#{self.name.split("::").last.downcase}s/#{id}"
        end
        protected :api_find_url

        # Options for find
        # overwrite this in the model to set security
        #
        # @return [Hash]
        def options_for_find(attributes)
          access_token = attributes.delete(:access_token)
          raise AuthenticationError unless access_token
          {
            auth_type: :user_token,
            auth_token: access_token
          }
        end
        protected :options_for_find
      end

      def self.included(base)
        base.extend(ClassMethods)
      end
    end
  end
end