docusign_dtr 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 1fc2fec821cff482ea06b2492c22a3ee5096724e645fbf80f4cf95bffabfb545
+  data.tar.gz: 1203596c16a182231f760ec48162a6341e97487b7a77d4001754ef266691dc3b
+SHA512:
+  metadata.gz: 231e6a4c4c146c76cd4b34387070ab26e3574be16a8fca2f8857fe90550e6cd50d39b7dfa0a75a07eead3f3c41c2a252e70b0bf70456bb01969388099310fdbe
+  data.tar.gz: afbe311e75325a4cac5843be88b84ffd6c122e47deadd116f39d6221673a4306b422179526b46fbea14a9c47c944e8dc4fa57095c311ba49b7aa70fe3a5c7e84

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.rubocop.yml

@@ -0,0 +1,33 @@
+AllCops:
+  TargetRubyVersion: 2.5
+  Exclude:
+    - '**/Guardfile'
+    - 'db/**/*'
+    - 'tmp/**/*'
+    - 'vendor/**/*'
+    - 'bin/**/*'
+    - 'log/**/*'
+    - 'dotloop.gemspec'
+Documentation:
+  Enabled: false
+Metrics/BlockLength:
+  Max: 100
+  Exclude:
+    - 'spec/**/*.rb'
+Metrics/LineLength:
+  Max: 120
+  AllowURI: true
+  URISchemes:
+    - http
+    - https
+Metrics/MethodLength:
+  CountComments: false
+  Max: 15
+Style/RaiseArgs:
+  Enabled: false
+Style/ClassAndModuleChildren:
+  Enabled: false
+Style/FrozenStringLiteralComment:
+  Enabled: false
+Style/Alias:
+  EnforcedStyle: prefer_alias_method

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,74 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, gender identity and expression, level of experience,
+nationality, personal appearance, race, religion, or sexual identity and
+orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+  address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at shane.davies@gmail.com. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in docusign_dtr.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 Loft 47
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,73 @@
+# DocusignDtr
+This library is designed to help ruby applications consume the Docusign DTR API.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'docusign_dtr'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install docusign_dtr
+
+## Usage
+
+```ruby
+auth = DocusignDtr::Auth::Jwt.new(
+  integrator_key: '1e1e1e1e-1e1e-1e1e-1e1e-1e1e1e1e1e1e',
+  private_key: "-----BEGIN RSA PRIVATE KEY-----\nTRUST_NO_ONE\n-----END RSA PRIVATE KEY-----",
+  user_guid: '1f1f1f1f-1f1f-1f1f-1f1f-1f1f1f1f1f1f',
+  redirect_uri: 'https://www.google.com'
+)
+begin
+auth.request_token
+rescue DocusignDtr::ConsentRequired
+  # launch or redirect user to grant url and try again
+  Launchy.open(auth.grant_url)
+end
+
+puts "Your access token is #{auth.access_token}"
+```
+Now you can use the ```access_token``` in the docusign [api explorer](https://stage.cartavi.com/restapi/swashbuckle/ui/index).
+
+When you receive a DocusignDtr::ConsentRequired error Send your client to the grant_url above and they will be required to authenticate your app. Once they authorize your app they will be redirected to the redirect_url  (for now its google.com)
+When you receive an auth object you can use the access_token to connect to resources:
+
+```ruby
+auth_token = 'SOME_LONG_SECRET_TRUST_NO_ONE_WITH_THIS'
+client = DocusignDtr::Client.new(token: auth_token, test_mode: false, application: 'myapplication.com')
+all_rooms = client.Room.all  # => [#<DocusignDtr::Models::Room ... >,]
+room = client.Room.find(all_rooms.last.id) # =>  #<DocusignDtr::Models::Room ... >
+room.name #=> My Room
+document = room.documents.last # =>  #<DocusignDtr::Models::Docuement ... >
+file = document.download # => #<File:/tmp/....>
+
+# Other endpoints
+offices = client.Office.all
+document = client.Document.find(12345)
+member = client.Member.find(56789)
+task_list = client.TaskList.find(98765)
+titles = client.Title.all
+profile = client.User.profile(54321)
+```
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/docusign_dtr.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,6 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "docusign_dtr"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "pry"
+Pry.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/certs/shanedavies.pem

@@ -0,0 +1,25 @@
+-----BEGIN CERTIFICATE-----
+MIIEODCCAqCgAwIBAgIBATANBgkqhkiG9w0BAQsFADAjMSEwHwYDVQQDDBhzZGF2
+aWVzL0RDPWxvZnQ0Ny9EQz1jb20wHhcNMTgwODA5MjA0NjQ5WhcNMTkwODA5MjA0
+NjQ5WjAjMSEwHwYDVQQDDBhzZGF2aWVzL0RDPWxvZnQ0Ny9EQz1jb20wggGiMA0G
+CSqGSIb3DQEBAQUAA4IBjwAwggGKAoIBgQC5uLNdd1ksckPgS7YfXj+6CWuxA8K5
+hDLOp9warlWizDgG3G4gyC6IwPatQX2cJACkArsB/pgdrmHf8scTGrCpFxwdMBZ1
+/PdNFjtyosnolsCP1wtjUI3AZcUkDXMpZhBAu6ouCNoZlqhzTtWzDFLDsyTgq+Dh
+J92jh3e30mxm9SUk9oU2OG7S1Z2LyjHmKFVYQVKv23hcEzccyuzicKFFMsgQw8Wp
+Mnm+sU/bas7L3FYKHoqoRhM3fnwfPrk1bh/o8xgdKcZJovF6Tyu1S1g/02zPJL5L
+SwlclupuM4t4jkvG3s4L/wuOcFN34nYG4XvpHug0C13R0soZnfPCpQvBYOGOPlol
+KoIPL74jre7R9xPR2ww/RQy0Jt6L9x8l+Ob4wVH86Ybj31Ht9JM4sdGSVLT8cM7I
+CJXmr4Y+TMXUjt8E1a8AWIO0KPB7bEzQji3ap7nr5YPx8Gf1fSP4rKHmUmnWwM6h
+21Ml2EfZZvYiMnXRwwRRI4UxagABBYr+SgMCAwEAAaN3MHUwCQYDVR0TBAIwADAL
+BgNVHQ8EBAMCBLAwHQYDVR0OBBYEFL6k7vksZaFGNcJSoOHYm7Mrft0kMB0GA1Ud
+EQQWMBSBEnNkYXZpZXNAbG9mdDQ3LmNvbTAdBgNVHRIEFjAUgRJzZGF2aWVzQGxv
+ZnQ0Ny5jb20wDQYJKoZIhvcNAQELBQADggGBAHAZ7y+8cRxZN5IVj1QLNKUpq0jz
+rlXdw5LkX1RHAF+AGx04epkfd98Rb89Pw8UPl15KwpnBqLP0Edvdc0cQ2f+MuRod
+q0b9RdxeaafJiKz63W5xE+U5ISZZMx+Kwkp9Y+LVl+eJR2jI/bE15ZopFw9Zl9NV
+NW5L0VAFfOx5MTwpQI3gevlbH+cQpAT/97mnIHsKU5fbHeY4cn4QtzycekPDl8oB
+UG5uO7+0xHrKOlKYBGjCMejj/NFanOVw6tXJAURjoHMOK8W4Q9rLuJIiI0WFZxOP
+Ojo1ihgcp2Dgjr5QJ6QayOb4Y4j2r8RrkSvPL04tPXE8Oj0j0/yV4PZin/odJ9LN
+ROe6I8zgZ08i2nLTiHsdilC+eEez2Gxl3TVbavPUEKocGUi1l6tr+PBjUb0bNKGv
+WPTyTwBv5qAL48mT3OBIV99mY13XurTi2s2OCJAgkQZIQlGsFzmT/4IDYivCoABO
+QVWtuf6LfMkXYW5shBsTlpiGbXeVlm0QW2Av3w==
+-----END CERTIFICATE-----

data/docusign_dtr.gemspec

@@ -0,0 +1,41 @@
+lib = File.expand_path('lib', __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'docusign_dtr/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'docusign_dtr'
+  spec.version       = DocusignDtr::VERSION
+  spec.authors       = ['Loft47']
+  spec.email         = ['support@loft47.com']
+
+  spec.summary       = %(Docusign DTR library)
+  spec.description   = %(Ruby library for Docusign DTR rest API)
+  spec.homepage      = %(http://github.com/Loft47/docusign_dtr)
+  spec.license       = 'MIT'
+  spec.cert_chain    = ['certs/shanedavies.pem']
+  spec.signing_key   = File.expand_path('~/.ssh/docusign-private_key.pem') if $PROGRAM_NAME.end_with?('gem')
+  spec.required_ruby_version = '~> 2.5'
+
+  raise 'RubyGems 2.5 or newer is required to protect against public gem pushes.' unless spec.respond_to?(:metadata)
+  spec.metadata['allowed_push_host'] = 'https://rubygems.org'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_runtime_dependency 'httparty'
+  spec.add_runtime_dependency 'jwt'
+  spec.add_runtime_dependency 'plissken'
+  spec.add_runtime_dependency 'virtus'
+  spec.add_development_dependency 'bundler'
+  spec.add_development_dependency 'byebug'
+  spec.add_development_dependency 'launchy'
+  spec.add_development_dependency 'pry'
+  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'rspec'
+  spec.add_development_dependency 'rubocop'
+  spec.add_development_dependency 'simplecov'
+  spec.add_development_dependency 'travis'
+  spec.add_development_dependency 'webmock'
+end

data/lib/docusign_dtr/activity.rb

@@ -0,0 +1,17 @@
+module DocusignDtr
+  class Activity
+    attr_accessor :client
+
+    def initialize(client:)
+      @client = client
+    end
+
+    def all_by_task_id(task_id)
+      @client.get("/tasks/#{task_id}/activity")['activity'].map do |activity_attrs|
+        activity = DocusignDtr::Models::Activity.new(activity_attrs)
+        activity.client = client
+        activity
+      end
+    end
+  end
+end

data/lib/docusign_dtr/auth/base.rb

@@ -0,0 +1,87 @@
+require 'uri'
+require 'base64'
+module DocusignDtr
+  module Auth
+    class Base
+      include HTTParty
+
+      attr_accessor :config
+      attr_accessor :token_response
+
+      def initialize
+        @config = DocusignDtr::Models::AuthConfig.new
+      end
+
+      def grant_url
+        grant_uri = URI("#{base_uri}oauth/auth")
+        grant_uri.query = URI.encode_www_form(grant_params)
+        grant_uri.to_s
+      end
+
+      def parse_url_response(url)
+        params = URI.decode_www_form(URI(url).query)
+        hash = Hash[*params.flatten]
+        OpenStruct.new(hash)
+      end
+
+      private
+
+      def full_scope
+        (%w[signature impersonation] + DocusignDtr::DTR_SCOPE).join(' ')
+      end
+
+      def base_uri
+        "https://#{domain}/"
+      end
+
+      def domain
+        @config.test_mode ? 'account-d.docusign.com' : 'account.docusign.com'
+      end
+
+      def auth_uri
+        @auth_uri ||= URI("#{base_uri}oauth/token")
+      end
+
+      def grant_params
+        {
+          response_type: :code,
+          scope: full_scope,
+          state: @config.state,
+          client_id: @config.integrator_key,
+          redirect_uri: @config.redirect_uri
+        }.delete_if { |_, v| v.nil? }
+      end
+
+      def base_headers
+        {
+          'Content-Type': 'application/x-www-form-urlencoded',
+          'User-Agent': @config.application.to_s,
+          'Accept': '*/*'
+        }
+      end
+
+      def encoded_integrator_key
+        Base64.urlsafe_encode64("#{@config.integrator_key}:#{@config.secret_key}")
+      end
+
+      def handle_error(response)
+        raise error_type(response), "Error communicating: Response code #{response.code}"
+      end
+
+      def error_type(response)
+        case response.code
+        when 400
+          # {"error":"invalid_grant"}
+          return DocusignDtr::InvalidGrant if response.parsed_response['error'].match?(/grant/)
+          DocusignDtr::ConsentRequired # {"error":"consent_required"}
+        when 401
+          DocusignDtr::Unauthorized
+        when 403
+          DocusignDtr::Forbidden
+        else
+          StandardError
+        end
+      end
+    end
+  end
+end

data/lib/docusign_dtr/auth/code.rb

@@ -0,0 +1,43 @@
+require 'securerandom'
+module DocusignDtr
+  module Auth
+    class Code < Base
+      def initialize(integrator_key:,
+                     secret_key:,
+                     redirect_uri:,
+                     test_mode: true,
+                     application: 'docusign_dtr')
+        @config = DocusignDtr::Models::AuthConfig.new(
+          application: application,
+          integrator_key: integrator_key,
+          redirect_uri: redirect_uri,
+          secret_key: secret_key,
+          state: SecureRandom.uuid,
+          test_mode: test_mode
+        )
+      end
+
+      def request_token(code:, state: nil)
+        raise 'State does ont match. Possible CSRF!' if state && state != @config.state
+        params = { grant_type: :authorization_code, code: code }
+        response = self.class.post(auth_uri, query: params, headers: headers, timeout: 60)
+        handle_error(response.code) if response.code != 200
+        @token_response = DocusignDtr::Models::AuthTokenResponse.new(response.parsed_response)
+      end
+
+      def refresh_token
+        raise 'No token to refresh' unless @token_response&.access_token
+        params = { grant_type: :refresh_token, refresh_token: @token_response.access_token }
+        response = self.class.post("#{base_uri}oauth/token", query: params, headers: headers, timeout: 60)
+        handle_error(response.code) if response.code != 200
+        @token_response = DocusignDtr::Models::AuthTokenResponse.new(response.parsed_response)
+      end
+
+      private
+
+      def headers
+        base_headers.merge('Authorization': "Basic #{encoded_integrator_key}")
+      end
+    end
+  end
+end

data/lib/docusign_dtr/auth/jwt.rb

@@ -0,0 +1,51 @@
+require 'jwt'
+module DocusignDtr
+  module Auth
+    class Jwt < Base
+      EXPIRES_IN = 3600
+      # rubocop:disable Metrics/ParameterLists
+      def initialize(integrator_key:,
+                     private_key:,
+                     user_guid:,
+                     redirect_uri:,
+                     test_mode: true,
+                     application: 'docusign_dtr')
+        @config = DocusignDtr::Models::AuthConfig.new(
+          application: application,
+          integrator_key: integrator_key,
+          private_key: OpenSSL::PKey::RSA.new(private_key),
+          redirect_uri: redirect_uri,
+          test_mode: test_mode,
+          user_guid: user_guid
+        )
+      end
+      # rubocop:enable Metrics/ParameterLists
+
+      def request_token
+        response = self.class.post(auth_uri, query: access_token_params, headers: base_headers, timeout: 60)
+        handle_error(response) if response.code != 200
+        @token_response = DocusignDtr::Models::AuthTokenResponse.new(response.parsed_response)
+      end
+
+      private
+
+      def body_params
+        {
+          iss: @config.integrator_key,
+          sub: @config.user_guid,
+          aud: domain,
+          iat: Time.now.to_i,
+          exp: Time.now.to_i + EXPIRES_IN,
+          scope: full_scope
+        }
+      end
+
+      def access_token_params
+        {
+          grant_type: 'urn:ietf:params:oauth:grant-type:jwt-bearer',
+          assertion: JWT.encode(body_params, @config.private_key, 'RS256')
+        }
+      end
+    end
+  end
+end

data/lib/docusign_dtr/client.rb

@@ -0,0 +1,98 @@
+module DocusignDtr
+  class Client
+    include HTTParty
+    attr_accessor :token
+
+    def initialize(token:, test_mode: true, application: 'docusign_dtr')
+      @test_mode = test_mode
+      @token = token
+      @application = application
+      raise 'Missing Token' unless token
+    end
+
+    def get(page, params = {})
+      response = raw(page, params)
+      snakify(response)
+    end
+
+    def raw(page, params = {})
+      full_path = [base_uri, page].join
+      response = self.class.get(full_path, query: params, headers: headers, timeout: 60)
+      handle_error(response.code) if response.code != 200
+      response.parsed_response
+    end
+
+    def handle_error(response_code)
+      raise error_type(response_code), "Error communicating: Response code #{response_code}"
+    end
+
+    def Office # rubocop:disable  Naming/MethodName
+      @office ||= DocusignDtr::Office.new(client: self) # rubocop:disable Naming/MemoizedInstanceVariableName
+    end
+
+    def Document # rubocop:disable  Naming/MethodName
+      @document ||= DocusignDtr::Document.new(client: self) # rubocop:disable Naming/MemoizedInstanceVariableName
+    end
+
+    def Member # rubocop:disable  Naming/MethodName
+      @member ||= DocusignDtr::Member.new(client: self) # rubocop:disable Naming/MemoizedInstanceVariableName
+    end
+
+    def Meta # rubocop:disable  Naming/MethodName
+      @meta ||= DocusignDtr::Meta.new(client: self) # rubocop:disable Naming/MemoizedInstanceVariableName
+    end
+
+    def Room # rubocop:disable  Naming/MethodName
+      @room ||= DocusignDtr::Room.new(client: self) # rubocop:disable Naming/MemoizedInstanceVariableName
+    end
+
+    def Task # rubocop:disable  Naming/MethodName
+      @task ||= DocusignDtr::Task.new(client: self) # rubocop:disable Naming/MemoizedInstanceVariableName
+    end
+
+    def TaskList # rubocop:disable  Naming/MethodName
+      @task_list ||= DocusignDtr::TaskList.new(client: self) # rubocop:disable Naming/MemoizedInstanceVariableName
+    end
+
+    def Title # rubocop:disable  Naming/MethodName
+      @title ||= DocusignDtr::Title.new(client: self) # rubocop:disable Naming/MemoizedInstanceVariableName
+    end
+
+    def User # rubocop:disable  Naming/MethodName
+      @user ||= DocusignDtr::User.new(client: self) # rubocop:disable Naming/MemoizedInstanceVariableName
+    end
+
+    def base_uri
+      @base_uri ||= @test_mode ? 'https://stage.cartavi.com/restapi/v1' : 'https://cartavi.com/restapi/v1'
+    end
+
+    private
+
+    def headers
+      {
+        'Authorization': "Bearer #{@token}",
+        'User-Agent': @application.to_s,
+        'Accept': 'application/json'
+      }
+    end
+
+    def snakify(hash)
+      if hash.is_a? Array
+        hash.map(&:to_snake_keys)
+      else
+        hash.to_snake_keys
+      end
+    end
+
+    def error_type(response_code)
+      case response_code
+      when 401
+        DocusignDtr::Unauthorized
+      when 403
+        DocusignDtr::Forbidden
+      else
+        StandardError
+      end
+    end
+  end
+end

data/lib/docusign_dtr/document.rb

@@ -0,0 +1,34 @@
+module DocusignDtr
+  class Document
+    attr_accessor :client
+
+    def initialize(client:)
+      @client = client
+    end
+
+    def all_by_room_id(room_id)
+      @client.get("/rooms/#{room_id}/documents")['documents'].map do |document_attrs|
+        document = DocusignDtr::Models::Document.new(document_attrs)
+        document.client = client
+        document
+      end
+    end
+
+    def find(id)
+      document_attrs = @client.get("/documents/#{id}/details")
+      document = DocusignDtr::Models::Document.new(document_attrs)
+      document.client = client
+      document
+    end
+
+    def create(document_attrs = {}) end
+
+    def download(id)
+      # document_attrs = @client.get("/documents/#{id}")
+    end
+
+    def destroy(id) end
+
+    def update(id) end
+  end
+end

data/lib/docusign_dtr/exceptions.rb

@@ -0,0 +1,6 @@
+module DocusignDtr
+  class ConsentRequired < StandardError; end
+  class InvalidGrant < StandardError; end
+  class Forbidden < StandardError; end
+  class Unauthorized < StandardError; end
+end