dotloop-ruby 0.1.0

data/lib/dotloop/document.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+module Dotloop
+  class Document
+    DOTLOOP_FILE_UPLOAD_BOUNDARY = "AaB03x"
+
+    attr_accessor :client
+
+    def initialize(client:)
+      @client = client
+    end
+
+    def all(profile_id:, loop_id:, folder_id:)
+      @client.get("/profile/#{profile_id.to_i}/loop/#{loop_id.to_i}/folder/#{folder_id.to_i}/document")[:data].map do |document_attrs|
+        doc = Dotloop::Models::Document.new(document_attrs)
+        doc.client = client
+        doc.profile_id = profile_id.to_i
+        doc.loop_id = loop_id.to_i
+        doc.folder_id = folder_id.to_i
+        doc
+      end
+    end
+
+    def find(profile_id:, loop_id:, folder_id:, document_id:)
+      document_data = @client.get("/profile/#{profile_id.to_i}/loop/#{loop_id.to_i}/folder/#{folder_id.to_i}/document/#{document_id.to_i}")[:data]
+      document = Dotloop::Models::Document.new(document_data)
+      document.client = client
+      document.profile_id = profile_id.to_i
+      document.loop_id = loop_id.to_i
+      document.folder_id = folder_id.to_i
+      document
+    end
+
+    def get(profile_id:, loop_id:, folder_id:, document_id:)
+      sio = StringIO.new
+      sio.set_encoding(Encoding::ASCII_8BIT)
+      sio.write(
+        @client.download(
+          "/profile/#{profile_id.to_i}/loop/#{loop_id.to_i}/folder/#{folder_id.to_i}/document/#{document_id.to_i}"
+        )
+      )
+      sio.flush
+      sio.close
+      sio
+    end
+
+    def upload(profile_id:, loop_id:, folder_id:, params: {})
+      file_url = params["file_url"]
+      file_name = params["file_name"]
+      file_content = params["file_content"]
+      # url = relative_path_S3(file_url)
+      # file = Aws::S3::Object.new(S3_CREDENTIALS['bucket'], url, region: S3_CREDENTIALS["region"]).get.data.body.read
+
+      post_body = []
+
+      post_body << "--#{DOTLOOP_FILE_UPLOAD_BOUNDARY}\r\n"
+      post_body << "Content-Disposition: form-data; name=\"file\"; filename=\"#{file_name}\"\r\n"
+      post_body << "Content-Type: application/pdf\r\n"
+      post_body << "\r\n"
+      post_body << file_content
+      post_body << "\r\n--#{DOTLOOP_FILE_UPLOAD_BOUNDARY}--\r\n"
+
+      document_data = @client.upload("/profile/#{profile_id.to_i}/loop/#{loop_id.to_i}/folder/#{folder_id.to_i}/document/", post_body.join)[:data]
+      document = Dotloop::Models::Document.new(document_data)
+      document.client = client
+      document.profile_id = profile_id.to_i
+      document.loop_id = loop_id.to_i
+      document.folder_id = folder_id.to_i
+      document
+    end
+  end
+end

data/lib/dotloop/exceptions.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Dotloop
+  class BadRequest < StandardError; end
+  class Forbidden < StandardError; end
+  class NotFound < StandardError; end
+  class TooManyRequest < StandardError; end
+  class Unauthorized < StandardError; end
+  class UnprocessableEntity < StandardError; end
+end

data/lib/dotloop/folder.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+module Dotloop
+  class Folder
+    attr_accessor :client
+
+    FOLDER_FIELDS = %w[name].freeze
+
+    def initialize(client:)
+      @client = client
+    end
+
+    def all(profile_id:, loop_id:)
+      url = "/profile/#{profile_id.to_i}/loop/#{loop_id.to_i}/folder"
+      @client.get(url)[:data].map do |folder_attrs|
+        folder = Dotloop::Models::Folder.new(folder_attrs)
+        folder.client = client
+        folder.profile_id = profile_id.to_i
+        folder.loop_id = loop_id.to_i
+        folder
+      end
+    end
+
+    def find(profile_id:, loop_id:, folder_id:)
+      folder_data = @client.get("/profile/#{profile_id.to_i}/loop/#{loop_id.to_i}/folder/#{folder_id.to_i}")[:data]
+      folder = Dotloop::Models::Folder.new(folder_data)
+      folder.client = client
+      folder.profile_id = profile_id.to_i
+      folder.loop_id = loop_id.to_i
+      folder
+    end
+
+    def create(profile_id:, loop_id:, params: {})
+      data = {
+        name: params['name']
+      }
+
+      folder_data = @client.post("/profile/#{profile_id.to_i}/loop/#{loop_id.to_i}/folder", data)[:data]
+      folder = Dotloop::Models::Folder.new(folder_data)
+      folder.client = client
+      folder.profile_id = profile_id.to_i
+      folder
+    end
+
+    def update(profile_id:, loop_id:, folder_id:, params: {})
+      data = {}
+      params.each do |key, value|
+        FOLDER_FIELDS.include?(key.to_s) || next
+        data[key] = value.to_s
+      end
+
+      folder_data = @client.patch("/profile/#{profile_id.to_i}/loop/#{loop_id.to_i}/folder/#{folder_id.to_i}", data)[:data]
+      folder = Dotloop::Models::Folder.new(folder_data)
+      folder.client = client
+      folder.profile_id = profile_id.to_i
+      folder.loop_id = loop_id.to_i
+      folder
+    end
+  end
+end

data/lib/dotloop/loop.rb

@@ -0,0 +1,157 @@
+# frozen_string_literal: true
+
+module Dotloop
+  class Loop
+    include Dotloop::QueryParamHelpers
+    attr_accessor :client
+
+    LOOP_FIELDS = %w[name status transactionType].freeze
+
+    LOOP_DETAILS_FIELDS = {
+      "Property Address" => [
+        "Country", "Street Number", "Street Name", "Unit Number", "City",
+        "State/Prov", "Zip/Postal Code", "County", "MLS Number", "Parcel/Tax ID"
+      ],
+      "Financials" => [
+        "Purchase/Sale Price", "Sale Commission Rate",
+        "Sale Commission Split % - Buy Side", "Sale Commission Split % - Sell Side",
+        "Sale Commission Total", "Earnest Money Amount", "Earnest Money Held By",
+        "Sale Commission Split $ - Buy Side", "Sale Commission Split $ - Sell Side"
+      ],
+      "Contract Dates" => [
+        "Contract Agreement Date", "Closing Date"
+      ],
+      "Offer Dates" => [
+        "Inspection Date", "Offer Date", "Offer Expiration Date", "Occupancy Date"
+      ],
+      "Contract Info" => [
+        "Transaction Number", "Class", "Type"
+      ],
+      "Referral" => [
+        "Referral %", "Referral Source"
+      ],
+      "Listing Information" => [
+        "Expiration Date", "Listing Date", "Original Price",
+        "Current Price", "1st Mortgage Balance", "2nd Mortgage Balance",
+        "Other Liens", "Description of Other Liens", "Homeowner's Association",
+        "Homeowner's Association Dues", "Total Encumbrances", "Property Includes",
+        "Property Excludes", "Remarks"
+      ],
+      "Geographic Description" => [
+        "MLS Area", "Legal Description", "Map Grid", "Subdivision", "Lot",
+        "Deed Page", "Deed Book", "Section", "Addition", "Block"
+      ],
+      "Property" => [
+        "Year Built", "Bedrooms", "Square Footage", "School District",
+        "Type", "Bathrooms", "Lot Size"
+      ]
+    }.freeze
+
+    def initialize(client:)
+      @client = client
+    end
+
+    def all(options = {})
+      loops = []
+      options[:batch_size] = BATCH_SIZE
+      (1..MAX_LOOPS).each do |i|
+        options[:batch_number] = i
+        current_batch = batch(options)
+        loops += current_batch
+        break if current_batch.size < options[:batch_size]
+      end
+      loops
+    end
+
+    def batch(options = {})
+      @client.get("/profile/#{profile_id(options)}/loop", query_params(options))[:data].map do |attrs|
+        lp = Dotloop::Models::Loop.new(attrs)
+        lp.client = client
+        lp.profile_id = profile_id(options)
+        lp
+      end
+    end
+
+    def find(profile_id:, loop_id:)
+      loop_data = @client.get("/profile/#{profile_id.to_i}/loop/#{loop_id.to_i}")[:data]
+      lp = Dotloop::Models::Loop.new(loop_data)
+      lp.client = client
+      lp.profile_id = profile_id.to_i
+      lp
+    end
+
+    def detail(profile_id:, loop_id:)
+      loop_detail = @client.get("/profile/#{profile_id.to_i}/loop/#{loop_id.to_i}/detail")[:data]
+      loop_detail = Dotloop::LoopDetail.new(loop_detail).details
+      ld = Dotloop::Models::LoopDetail.new(loop_detail)
+      ld.profile_id = profile_id.to_i
+      ld.loop_id = loop_id.to_i
+      ld
+    end
+
+    def create(profile_id:, params: {})
+      data = {
+        name: params['name'],
+        status: params['status'],
+        transactionType: params['transactionType']
+      }
+
+      loop_data = @client.post("/profile/#{profile_id.to_i}/loop", data)[:data]
+      lp = Dotloop::Models::Loop.new(loop_data)
+      lp.client = client
+      lp.profile_id = profile_id.to_i
+      lp
+    end
+
+    def loop_it(profile_id:, params: {})
+      loop_data = @client.post("/loop-it?profile_id=#{profile_id}", params)[:data]
+      lp = Dotloop::Models::Loop.new(loop_data)
+      lp.client = client
+      lp.profile_id = profile_id.to_i
+      lp
+    end
+
+    def update(profile_id:, loop_id:, params: {})
+      data = {}
+      params.each do |key, value|
+        LOOP_FIELDS.include?(key.to_s) || next
+        data[key] = value.to_s
+      end
+
+      loop_data = @client.patch("/profile/#{profile_id.to_i}/loop/#{loop_id.to_i}", data)[:data]
+      lp = Dotloop::Models::Loop.new(loop_data)
+      lp.client = client
+      lp.profile_id = profile_id.to_i
+      lp
+    end
+
+    def update_details(profile_id:, loop_id:, params: {})
+      data = {}
+      LOOP_DETAILS_FIELDS.keys.each do |key|
+        (detail_fields = params[key])
+        detail_fields.is_a?(Hash) || next
+        data[key] = {}
+        detail_fields.each do |k, v|
+          LOOP_DETAILS_FIELDS[key].include?(k.to_s) || next
+          data[key][k] = v.to_s
+        end
+      end
+
+      loop_detail = @client.patch("/profile/#{profile_id.to_i}/loop/#{loop_id.to_i}/detail", data)[:data]
+      loop_detail = Dotloop::LoopDetail.new(loop_detail).details
+      Dotloop::Models::LoopDetail.new(loop_detail)
+    end
+
+    private
+
+    def query_params(options)
+      {
+        batch_number:        batch_number(options),
+        batch_size:          batch_size(options),
+        sort:                options[:sort],
+        filter:              options[:filter],
+        include_details:     options[:include_details]
+      }.delete_if { |_, v| should_delete(v) }
+    end
+  end
+end

data/lib/dotloop/loop_detail.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Dotloop
+  class LoopDetail
+    attr_accessor :details
+    FIXED_SECTIONS = %i[
+      contract_dates contract_info financials geographic_description
+      listing_information offer_dates property_address property referral
+    ].freeze
+
+    def initialize(data)
+      @details = FIXED_SECTIONS.each_with_object({}) { |key, memo| memo[key] = {} }.merge(contacts: [])
+      parse_data(data)
+    end
+
+    def parse_data(data)
+      fix_hash_keys(data).each { |item| build_section(item[0], item[1]) }
+    end
+
+    private
+
+    def build_section(key, section_data)
+      return unless FIXED_SECTIONS.include?(key)
+      values = fix_hash_keys(section_data)
+      @details[key] = values
+    end
+
+    def index_to_key(index)
+      index.to_s.downcase.delete(%(')).gsub(/%/, ' percent ').gsub(/\$/, ' doller ').gsub(/[^a-z]/, '_').squeeze('_').gsub(/^_*/, '').gsub(/_*$/, '').to_sym
+    end
+
+    def fix_hash_keys(bad_hash)
+      bad_hash.each_with_object({}) do |item, memo|
+        memo[index_to_key(item[0])] = item[1]
+      end
+    end
+  end
+end

data/lib/dotloop/models/contact.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Dotloop
+  module Models
+    class Contact
+      include Virtus.model
+      attribute :address
+      attribute :city
+      attribute :country
+      attribute :email
+      attribute :fax
+      attribute :first_name
+      attribute :home
+      attribute :id, Integer
+      attribute :last_name
+      attribute :office
+      attribute :state
+      attribute :zip_code
+      attr_accessor :client
+    end
+  end
+end

data/lib/dotloop/models/document.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Dotloop
+  module Models
+    class Document
+      include Virtus.model
+      attribute :created, DateTime
+      attribute :id, Integer
+      attribute :name
+      attribute :updated, DateTime
+
+      attr_accessor :client
+      attr_accessor :profile_id
+      attr_accessor :loop_id
+      attr_accessor :folder_id
+
+      def download
+        client.Document.get(
+          profile_id: profile_id,
+          loop_id: loop_id,
+          folder_id: folder_id,
+          document_id: id
+        )
+      end
+    end
+  end
+end

data/lib/dotloop/models/folder.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Dotloop
+  module Models
+    class Folder
+      include Virtus.model
+      attribute :name
+      attribute :id, Integer
+
+      attr_accessor :client
+      attr_accessor :profile_id
+      attr_accessor :loop_id
+
+      def documents
+        client.Document.all(profile_id: profile_id, loop_id: loop_id, folder_id: id)
+      end
+    end
+  end
+end

data/lib/dotloop/models/loop.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Dotloop
+  module Models
+    class Loop
+      include Virtus.model
+      attribute :completed_task_count, Integer
+      attribute :id, Integer
+      attribute :name
+      attribute :loop_url, Integer
+      attribute :profile_id, Integer
+      attribute :status
+      attribute :transaction_type
+      attribute :total_task_count, Integer
+      attribute :updated, DateTime
+
+      attr_accessor :client
+      attr_accessor :profile_id
+
+      def detail
+        client.Loop.detail(profile_id: profile_id, loop_id: id)
+      end
+
+      def folders
+        client.Folder.all(profile_id: profile_id, loop_id: id)
+      end
+
+      def participants
+        client.Participant.all(profile_id: profile_id, loop_id: id)
+      end
+
+      def tasklists
+        client.Tasklist.all(profile_id: profile_id, loop_id: id)
+      end
+
+      def update(data)
+        client.Loop.update(profile_id: profile_id, loop_id: id, params: data)
+      end
+
+      def update_details(data)
+        client.Loop.update_details(profile_id: profile_id, loop_id: id, params: data)
+      end
+    end
+  end
+end