forward 0.0.1 → 0.0.11

data/README.md

@@ -0,0 +1,7 @@
+1. parse options
+2. pass to client
+3. client gets a session for the user based on stored token/authentication request or asks the user to signup
+4. if account is in good standing client requests a tunnel to be setup
+5. if tunnel is setup, client opens the ssh channel
+6. client starts forwarding traffic
+7. the end

data/Rakefile

@@ -1,3 +1,8 @@
 #!/usr/bin/env rake
 require 'rake/testtask'
-require 'bundler/gem_tasks'
+require 'bundler/gem_tasks'
+
+Rake::TestTask.new do |t|
+    t.libs << 'test'
+    t.test_files = FileList['test/**/*_test.rb']
+end

data/bin/forward

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+$LOAD_PATH.unshift(File.expand_path('../../lib', __FILE__))
+
+require 'forward'
+
+Forward::CLI.run(ARGV)

data/forward.gemspec

@@ -4,14 +4,22 @@ require File.expand_path('../lib/forward/version', __FILE__)
 Gem::Specification.new do |gem|
   gem.authors       = ['blahed']
   gem.email         = ['travis@50east.co']
-  gem.description   = 'Something'
-  gem.summary       = 'Something'
-  gem.homepage      = ''
+  gem.summary       = 'Forward Lets You Share localhost over the Web. Demo a Website Without Hosting.'
+  gem.homepage      = 'https://forwardhq.com'
 
   gem.files         = `git ls-files`.split($\)
   gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
-  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.test_files    = gem.files.grep(%r{^(test|features)/})
   gem.name          = 'forward'
   gem.require_paths = ['lib']
   gem.version       = Forward::VERSION
+
+  gem.add_dependency 'json', '~> 1.7.3'
+  gem.add_dependency 'highline', '~> 1.6.13'
+  gem.add_dependency 'net-ssh', '~> 2.4.0'
+
+  gem.add_development_dependency 'minitest', '~> 3.0.0'
+  gem.add_development_dependency 'mocha', '~> 0.11.4'
+  gem.add_development_dependency 'fakeweb', '~> 1.3.0'
+  gem.add_development_dependency 'fakefs', '~> 0.4.0'
 end

data/forwardhq.crt

@@ -0,0 +1,112 @@
+-----BEGIN CERTIFICATE-----
+MIIFCTCCA/GgAwIBAgIQQN4DiY5aF21RqglaWWIJnDANBgkqhkiG9w0BAQUFADBy
+MQswCQYDVQQGEwJHQjEbMBkGA1UECBMSR3JlYXRlciBNYW5jaGVzdGVyMRAwDgYD
+VQQHEwdTYWxmb3JkMRowGAYDVQQKExFDT01PRE8gQ0EgTGltaXRlZDEYMBYGA1UE
+AxMPRXNzZW50aWFsU1NMIENBMB4XDTEyMDgwOTAwMDAwMFoXDTEzMDgwOTIzNTk1
+OVowUjEhMB8GA1UECxMYRG9tYWluIENvbnRyb2wgVmFsaWRhdGVkMRUwEwYDVQQL
+EwxFc3NlbnRpYWxTU0wxFjAUBgNVBAMTDWZvcndhcmRocS5jb20wggEiMA0GCSqG
+SIb3DQEBAQUAA4IBDwAwggEKAoIBAQDcyzuKOE3k44yBYLKXp3AXlf3zbXnZQoHg
+qzSupKtxHXIVPv6H6IK5HMKT0fgkJaBldMACrIwh6qBCwNm/2OlToTlPY4Ho/9tU
+f4ud6Y8zSGMOssvR2/jNAfViRtn6AsDZu+0+NM3ZbF4lYorO7KrSTZHhmVDtk4KP
+HpGRLXKBOa3H/8TQ7RrG8779Ad+RiobwpZc0C7RV/xX2rM5HwWDGNc03eC2GiRSd
+u8vHp36PeXeW+EWOiHdOthBS49FiTlb6VIQe9eyfOKXMAWEsBum55woGbOutULwQ
+TQ9HfGfcqve0Zjo24chLvb0hmbOXk+VRJG7J83+QZzHn3JjHEF5dAgMBAAGjggG5
+MIIBtTAfBgNVHSMEGDAWgBTay+qtWwhdzP/8JlTOSeVVxjj0+DAdBgNVHQ4EFgQU
+fvmPP+mzOr0ed77Yfsdle6lKLc8wDgYDVR0PAQH/BAQDAgWgMAwGA1UdEwEB/wQC
+MAAwNAYDVR0lBC0wKwYIKwYBBQUHAwEGCCsGAQUFBwMCBgorBgEEAYI3CgMDBglg
+hkgBhvhCBAEwRQYDVR0gBD4wPDA6BgsrBgEEAbIxAQICBzArMCkGCCsGAQUFBwIB
+Fh1odHRwczovL3NlY3VyZS5jb21vZG8uY29tL0NQUzA7BgNVHR8ENDAyMDCgLqAs
+hipodHRwOi8vY3JsLmNvbW9kb2NhLmNvbS9Fc3NlbnRpYWxTU0xDQS5jcmwwbgYI
+KwYBBQUHAQEEYjBgMDgGCCsGAQUFBzAChixodHRwOi8vY3J0LmNvbW9kb2NhLmNv
+bS9Fc3NlbnRpYWxTU0xDQV8yLmNydDAkBggrBgEFBQcwAYYYaHR0cDovL29jc3Au
+Y29tb2RvY2EuY29tMCsGA1UdEQQkMCKCDWZvcndhcmRocS5jb22CEXd3dy5mb3J3
+YXJkaHEuY29tMA0GCSqGSIb3DQEBBQUAA4IBAQCJEBvC7c/IrrA0YQPNfgeI2UHN
+OE5wSK8OveVL++iP4lTxMXew59YOjFccovwot6Jp7RLtlDNlRePDavKzcG/IXiY7
+oW39bjjLwosrjljq2tZCMm0aTGeNIjMjcN76m9TidlU2DmhhbAT2JdSe+FqEgJnM
+rJxOgDyxNFGA4UERYambkm+CEFWhEZ6CUneW69IcENglZN9DRcBrX4tivUA/i24W
+xXz7OFhwfNbJRoLCGH6YVSKzyE8hV1EXDRmTsmHQ1Tw7xk+FduxR5Q2TiB8cdix5
+ByS6bHA8C5DnS2xJ4mXSxcrCIcjDtbyMEFdDMS7yzfv3LHDetyYyt4rK9E2D
+-----END CERTIFICATE-----
+-----BEGIN CERTIFICATE-----
+MIIFAzCCA+ugAwIBAgIQGLLLuqME8aAPwfLzJkYqSjANBgkqhkiG9w0BAQUFADCB
+gTELMAkGA1UEBhMCR0IxGzAZBgNVBAgTEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4G
+A1UEBxMHU2FsZm9yZDEaMBgGA1UEChMRQ09NT0RPIENBIExpbWl0ZWQxJzAlBgNV
+BAMTHkNPTU9ETyBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTAeFw0wNjEyMDEwMDAw
+MDBaFw0xOTEyMzEyMzU5NTlaMHIxCzAJBgNVBAYTAkdCMRswGQYDVQQIExJHcmVh
+dGVyIE1hbmNoZXN0ZXIxEDAOBgNVBAcTB1NhbGZvcmQxGjAYBgNVBAoTEUNPTU9E
+TyBDQSBMaW1pdGVkMRgwFgYDVQQDEw9Fc3NlbnRpYWxTU0wgQ0EwggEiMA0GCSqG
+SIb3DQEBAQUAA4IBDwAwggEKAoIBAQCt8AiwcsargxIxF3CJhakgEtSYau2A1NHf
+5I5ZLdOWIY120j8YC0YZYwvHIPPlC92AGvFaoL0dds23Izp0XmEbdaqb1IX04XiR
+0y3hr/yYLgbSeT1awB8hLRyuIVPGOqchfr7tZ291HRqfalsGs2rjsQuqag7nbWzD
+ypWMN84hHzWQfdvaGlyoiBSyD8gSIF/F03/o4Tjg27z5H6Gq1huQByH6RSRQXScq
+oChBRVt9vKCiL6qbfltTxfEFFld+Edc7tNkBdtzffRDPUanlOPJ7FAB1WfnwWdsX
+Pvev5gItpHnBXaIcw5rIp6gLSApqLn8tl2X2xQScRMiZln5+pN0vAgMBAAGjggGD
+MIIBfzAfBgNVHSMEGDAWgBQLWOWLxkwVN6RAqTCpIb5HNlpW/zAdBgNVHQ4EFgQU
+2svqrVsIXcz//CZUzknlVcY49PgwDgYDVR0PAQH/BAQDAgEGMBIGA1UdEwEB/wQI
+MAYBAf8CAQAwIAYDVR0lBBkwFwYKKwYBBAGCNwoDAwYJYIZIAYb4QgQBMD4GA1Ud
+IAQ3MDUwMwYEVR0gADArMCkGCCsGAQUFBwIBFh1odHRwczovL3NlY3VyZS5jb21v
+ZG8uY29tL0NQUzBJBgNVHR8EQjBAMD6gPKA6hjhodHRwOi8vY3JsLmNvbW9kb2Nh
+LmNvbS9DT01PRE9DZXJ0aWZpY2F0aW9uQXV0aG9yaXR5LmNybDBsBggrBgEFBQcB
+AQRgMF4wNgYIKwYBBQUHMAKGKmh0dHA6Ly9jcnQuY29tb2RvY2EuY29tL0NvbW9k
+b1VUTlNHQ0NBLmNydDAkBggrBgEFBQcwAYYYaHR0cDovL29jc3AuY29tb2RvY2Eu
+Y29tMA0GCSqGSIb3DQEBBQUAA4IBAQAtlzR6QDLqcJcvgTtLeRJ3rvuq1xqo2l/z
+odueTZbLN3qo6u6bldudu+Ennv1F7Q5Slqz0J790qpL0pcRDAB8OtXj5isWMcL2a
+ejGjKdBZa0wztSz4iw+SY1dWrCRnilsvKcKxudokxeRiDn55w/65g+onO7wdQ7Vu
+F6r7yJiIatnyfKH2cboZT7g440LX8NqxwCPf3dfxp+0Jj1agq8MLy6SSgIGSH6lv
++Wwz3D5XxqfyH8wqfOQsTEZf6/Nh9yvENZ+NWPU6g0QO2JOsTGvMd/QDzczc4BxL
+XSXaPV7Od4rhPsbXlM1wSTz/Dr0ISKvlUhQVnQ6cGodWaK2cCQBk
+-----END CERTIFICATE-----
+-----BEGIN CERTIFICATE-----
+MIIE8TCCA9mgAwIBAgIQS3VXgmk5DJvjLxLsX22UXjANBgkqhkiG9w0BAQUFADBv
+MQswCQYDVQQGEwJTRTEUMBIGA1UEChMLQWRkVHJ1c3QgQUIxJjAkBgNVBAsTHUFk
+ZFRydXN0IEV4dGVybmFsIFRUUCBOZXR3b3JrMSIwIAYDVQQDExlBZGRUcnVzdCBF
+eHRlcm5hbCBDQSBSb290MB4XDTEwMDIxMTAwMDAwMFoXDTIwMDUzMDEwNDgzOFow
+gYExCzAJBgNVBAYTAkdCMRswGQYDVQQIExJHcmVhdGVyIE1hbmNoZXN0ZXIxEDAO
+BgNVBAcTB1NhbGZvcmQxGjAYBgNVBAoTEUNPTU9ETyBDQSBMaW1pdGVkMScwJQYD
+VQQDEx5DT01PRE8gQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwggEiMA0GCSqGSIb3
+DQEBAQUAA4IBDwAwggEKAoIBAQDQQIuLcuORG/dRwRtUBJjTqb/B5opdO4f7u4jO
+DeMvPwaW8KIpUJmu2zuhV7B0UXHN7UKRTUH+qcjYaoZ3RLtZZpdQXrTULHBEz9o3
+lUJpPDDEcbNS8CFNodi6OXwcnqMknfKDFpiqFnxDmxVbt640kf7UYiYYRpo/68H5
+8ZBX66x6DYvbcjBqZtXgRqNw3GjZ/wRIiXfeten7Z21B6bw5vTLZYgLxsag9bjec
+4i/i06Imi8a4VUOI4SM+pdIkOWpHqwDUobOpJf4NP6cdutNRwQuk2qw471VQJAVl
+RpM0Ty2NrcbUIRnSjsoFYXEHc0flihkSvQRNzk6cpUisuyb3AgMBAAGjggF0MIIB
+cDAfBgNVHSMEGDAWgBStvZh6NLQm9/rEJlTvA73gJMtUGjAdBgNVHQ4EFgQUC1jl
+i8ZMFTekQKkwqSG+RzZaVv8wDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMB
+Af8wEQYDVR0gBAowCDAGBgRVHSAAMEQGA1UdHwQ9MDswOaA3oDWGM2h0dHA6Ly9j
+cmwudXNlcnRydXN0LmNvbS9BZGRUcnVzdEV4dGVybmFsQ0FSb290LmNybDCBswYI
+KwYBBQUHAQEEgaYwgaMwPwYIKwYBBQUHMAKGM2h0dHA6Ly9jcnQudXNlcnRydXN0
+LmNvbS9BZGRUcnVzdEV4dGVybmFsQ0FSb290LnA3YzA5BggrBgEFBQcwAoYtaHR0
+cDovL2NydC51c2VydHJ1c3QuY29tL0FkZFRydXN0VVROU0dDQ0EuY3J0MCUGCCsG
+AQUFBzABhhlodHRwOi8vb2NzcC51c2VydHJ1c3QuY29tMA0GCSqGSIb3DQEBBQUA
+A4IBAQBNhw1QMPOCXcQ/1O/ujUjj572Qa8QyOMZeKKtcpa1h+Y67hRQ5IVFbjozc
+F5KAL4OUaYjBvieOT5+pg9i+14eScaO2/RF0uJWBKCB3DUN3dXY4HU0bLpeJjAob
+ZhZS1BSab4BIFt4wwEJo6r+iuipETayJ4vPMU5vj5h1uT5if2Q5RUIbgGjQyJIB9
+OofzPOVaTbeLvQokDa7b9I9c0mYMghxyN7bRudCYNBsnbYteHkBzGPqo5MbokMOr
+GeTBoc1M1Dq2iMjz0GVhOr8Y9K8cVqnrlzjZICkfPyopR52KD2oSgUQCIdQ7Ohor
+HkBDfZSgaQ78LvtS9v0uMtjLa73r
+-----END CERTIFICATE-----
+-----BEGIN CERTIFICATE-----
+MIIENjCCAx6gAwIBAgIBATANBgkqhkiG9w0BAQUFADBvMQswCQYDVQQGEwJTRTEU
+MBIGA1UEChMLQWRkVHJ1c3QgQUIxJjAkBgNVBAsTHUFkZFRydXN0IEV4dGVybmFs
+IFRUUCBOZXR3b3JrMSIwIAYDVQQDExlBZGRUcnVzdCBFeHRlcm5hbCBDQSBSb290
+MB4XDTAwMDUzMDEwNDgzOFoXDTIwMDUzMDEwNDgzOFowbzELMAkGA1UEBhMCU0Ux
+FDASBgNVBAoTC0FkZFRydXN0IEFCMSYwJAYDVQQLEx1BZGRUcnVzdCBFeHRlcm5h
+bCBUVFAgTmV0d29yazEiMCAGA1UEAxMZQWRkVHJ1c3QgRXh0ZXJuYWwgQ0EgUm9v
+dDCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBALf3GjPm8gAELTngTlvt
+H7xsD821+iO2zt6bETOXpClMfZOfvUq8k+0DGuOPz+VtUFrWlymUWoCwSXrbLpX9
+uMq/NzgtHj6RQa1wVsfwTz/oMp50ysiQVOnGXw94nZpAPA6sYapeFI+eh6FqUNzX
+mk6vBbOmcZSccbNQYArHE504B4YCqOmoaSYYkKtMsE8jqzpPhNjfzp/haW+710LX
+a0Tkx63ubUFfclpxCDezeWWkWaCUN/cALw3CknLa0Dhy2xSoRcRdKn23tNbE7qzN
+E0S3ySvdQwAl+mG5aWpYIxG3pzOPVnVZ9c0p10a3CitlttNCbxWyuHv77+ldU9U0
+WicCAwEAAaOB3DCB2TAdBgNVHQ4EFgQUrb2YejS0Jvf6xCZU7wO94CTLVBowCwYD
+VR0PBAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wgZkGA1UdIwSBkTCBjoAUrb2YejS0
+Jvf6xCZU7wO94CTLVBqhc6RxMG8xCzAJBgNVBAYTAlNFMRQwEgYDVQQKEwtBZGRU
+cnVzdCBBQjEmMCQGA1UECxMdQWRkVHJ1c3QgRXh0ZXJuYWwgVFRQIE5ldHdvcmsx
+IjAgBgNVBAMTGUFkZFRydXN0IEV4dGVybmFsIENBIFJvb3SCAQEwDQYJKoZIhvcN
+AQEFBQADggEBALCb4IUlwtYj4g+WBpKdQZic2YR5gdkeWxQHIzZlj7DYd7usQWxH
+YINRsPkyPef89iYTx4AWpb9a/IfPeHmJIZriTAcKhjW88t5RxNKWt9x+Tu5w/Rw5
+6wwCURQtjr0W4MHfRnXnJK3s9EK0hZNwEGe6nQY1ShjTK3rMUUKhemPR5ruhxSvC
+Nr4TDea9Y355e6cJDUCrat2PisP29owaQgVR1EX1n6diIWgVIEM8med8vSTYqZEX
+c4g/VhsxOBi0cQ+azcgOno4uG+GMmIPLHzHxREzGBHNJdmAPx/i9F4BrLunMTA5a
+mnkPIAou1Z5jJh5VkpTYghdae9C8x49OhgQ=
+-----END CERTIFICATE-----

data/lib/forward.rb

@@ -1,4 +1,90 @@
+require 'base64'
+require 'json'
+require 'logger'
+require 'openssl'
+require 'optparse'
+require 'rbconfig'
+require 'stringio'
+require 'uri'
+
+require 'highline/import'
+require 'net/ssh'
+
+require 'forward/core_extensions'
+
+require 'forward/error'
+require 'forward/api'
+require 'forward/config'
+require 'forward/tunnel'
+require 'forward/client'
+require 'forward/cli'
 require 'forward/version'
 
 module Forward
+  DEFAULT_SSL      = true
+  DEFAULT_SSH_PORT = 22
+  DEFAULT_SSH_USER = 'tunnel'
+
+  # Returns either a ssh user set in the environment or a set default.
+  #
+  # Returns a String containing the ssh user.
+  def self.ssh_user
+    ENV['FORWARD_SSH_USER'] || DEFAULT_SSH_USER
+  end
+
+  # Returns either a ssh port set in the environment or a set default.
+  #
+  # Returns a String containing the ssh port.
+  def self.ssh_port
+    ENV['FORWARD_SSH_PORT'] || DEFAULT_SSH_PORT
+  end
+
+  def self.client=(client)
+    @@client = client
+  end
+
+  def self.client
+    defined?(@@client) && @@client
+  end
+
+  def self.debug!
+    @@debug      = true
+    logger.level = Logger::DEBUG
+  end
+
+  def self.debug?
+    defined?(@@debug) && @@debug
+  end
+
+  def self.stringio_log
+    @@stringio_log ||= StringIO.new
+  end
+
+  def self.debug_remotely!
+    logger(stringio_log)
+    debug!
+    @@debug_remotely = true
+  end
+
+  def self.debug_remotely?
+    defined?(@@debug_remotely) && @@debug_remotely
+  end
+
+  def self.log(level, message)
+    logger.send(level, message) if debug?
+  end
+
+  def self.logger(logdev = STDOUT)
+    @@logger ||= Logger.new(logdev)
+  end
+
+  # Returns a string representing a detailed client version.
+  #
+  # Returns a String representing the client.
+  def self.client_string
+    os     = RbConfig::CONFIG['host_os']
+    engine = defined?(RUBY_ENGINE) ? RUBY_ENGINE : 'ruby'
+
+    "[#{os}]::[#{engine}-#{RUBY_VERSION}]::[ruby-client-#{Forward::VERSION}]"
+  end
 end

data/lib/forward/api.rb

@@ -0,0 +1,45 @@
+require 'forward/api/resource'
+require 'forward/api/client_log'
+require 'forward/api/public_key'
+require 'forward/api/tunnel'
+require 'forward/api/user'
+
+module Forward
+  module Api
+    class BadResponse < StandardError; end
+    class ResourceNotFound < StandardError; end
+    class ResourceError < StandardError
+      attr_reader :action, :errors
+
+      def initialize(action, json)
+        @action = action
+        @json   = json
+        @errors = json[:errors]
+      end
+    end
+
+    DEFAULT_API_HOST = 'https://forwardhq.com'
+
+    # Returns either an api host set in the environment or a set default.
+    #
+    # Returns a String containing the api host.
+    def self.uri
+      URI.parse(ENV['FORWARD_API_HOST'] || DEFAULT_API_HOST)
+    end
+
+    # Returns True or False if we should be using ssl
+    #
+    # Returns a Boolean.
+    def self.ssl?
+      uri.scheme == 'https'
+    end
+
+    def self.token=(token)
+      @@api_token = token
+    end
+
+    def self.token
+      defined?(@@api_token) ? @@api_token : nil
+    end
+  end
+end

data/lib/forward/api/client_log.rb

@@ -0,0 +1,28 @@
+module Forward
+  module Api
+    class ClientLog < Resource
+
+      def self.create(log)
+        resource     = ClientLog.new(:create)
+        resource.uri = '/api/client_logs'
+        params       = {
+          :client => Forward.client_string,
+          :log    => log,
+        }
+
+        params[:user_id] = user_id unless user_id.nil?
+
+        resource.post(params)
+      end
+
+      private
+
+      def self.user_id
+        if !Forward.client.nil? && !Forward.client.config.nil?
+          Forward.client.config.id
+        end
+      end
+
+    end
+  end
+end

data/lib/forward/api/public_key.rb

@@ -0,0 +1,16 @@
+module Forward
+  module Api
+    class PublicKey < Resource
+
+      def self.create
+        resource     = PublicKey.new(:create)
+        resource.uri = '/api/public_keys'
+
+        response = resource.post
+
+        response[:private_key]
+      end
+
+    end
+  end
+end

data/lib/forward/api/resource.rb

@@ -0,0 +1,121 @@
+require 'cgi'
+require 'json'
+require 'net/http'
+require 'net/https'
+require 'uri'
+
+module Forward
+  module Api
+    class Resource
+
+      attr_accessor :http
+      attr_accessor :uri
+
+      def initialize(action = nil)
+        @action           = action
+        @http             = Net::HTTP.new(Forward::Api.uri.host, Forward::Api.uri.port)
+        @http.use_ssl     = Forward::Api.ssl?
+        @http.verify_mode = OpenSSL::SSL::VERIFY_PEER
+        @http.ca_file     = File.expand_path('../../../../forwardhq.crt', __FILE__)
+      end
+
+      def request(method = :get, params = {})
+        log(:debug, "Request: [#{method.to_s.upcase}] for `#{http.address}:#{http.port}#{uri}'")
+        log(:debug, "Request: params `#{params.reject { |k,v| k == :password }.inspect }'")
+        build_request(method, params)
+        add_headers!
+
+        response = @http.request(@request)
+
+        parse_response(response)
+      rescue ResourceError => e
+        self.class.dispatch_error(e)
+      end
+
+      def build_request(method, params = {})
+        @method = method
+
+        case @method
+        when :get
+          @request = Net::HTTP::Get.new(uri)
+        when :post
+          @request = Net::HTTP::Post.new(uri)
+          @request.body = params.to_json unless params.empty?
+        when :put
+          @request = Net::HTTP::Put.new(uri)
+          @request.body = params.to_json unless params.empty?
+        when :delete
+          @request = Net::HTTP::Delete.new(uri)
+          @request.body = params.to_json unless params.empty?
+        end
+      end
+
+      def add_headers!
+        if Forward::Api.token
+          @request['Authorization'] = "Token token=#{Forward::Api.token}"
+        end
+
+        @request['Content-Type'] = 'application/json'
+        @request['Accept']       = 'application/json'
+      end
+
+      def get(params = {})
+        @response = request(:get, params)
+      end
+
+      def post(params = {})
+        @response = request(:post, params)
+      end
+
+      def put(params = {})
+        @response = request(:put, params)
+      end
+
+      def delete(params = {})
+        @response = request(:delete, params)
+      end
+
+      def parse_response(response)
+        log(:debug, "Response: [#{response.code}] `#{response.body}'")
+
+        if response.code.to_i == 404
+          raise ResourceNotFound
+        elsif response.code.to_i != 200
+          raise BadResponse, "response code was: #{response.code}"
+        elsif response['content-type'] !~ /^application\/json/
+          raise BadResponse, "response was not JSON, unable to parse"
+        end
+
+        json = JSON.parse(response.body)
+
+        if json.is_a? Hash
+          json.symbolize_keys!
+          raise ResourceError.new(@action, json) if json.has_key?(:errors)
+        end
+
+        json
+      end
+
+      def self.dispatch_error(error)
+        Forward.log(:debug, "Dispatching ResourceError:   action: #{error.action}   errors: #{error.errors.inspect}")
+        method = :"#{error.action}_error"
+
+        if respond_to? method
+          send(method, error.errors)
+        else
+          Forward::Client.cleanup_and_exit!('An error occured, please contact support@forwardhq.com')
+        end
+      end
+
+      private
+
+      def log(level, message)
+        unless self.class.to_s == 'Forward::Api::ClientLog'
+          Forward.log(level, message)
+        end
+      end
+
+    end
+
+  end
+end