hubspot_client 0.1.0.beta1 → 0.1.0.beta2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 12f80ed6afbfbb4fc8561616156762128e77defcca1c53bc4f07b93affaebd18
-  data.tar.gz: eaf249fb97115e5178e4785e3824574973817b78e9cc2713af81b46e4f3833af
+  metadata.gz: 6bc3a880bcae828da2e0ae5b37c4027339352b7294868caeb3b87395be557897
+  data.tar.gz: 78a1a367a7a052726fa95f4d792ffdcb1d619ba58cfde4a3f3f1842277aedb41
 SHA512:
-  metadata.gz: b2f43fe74c400cc82d075ff771392431a55294418195a8514018d9b09a4dce169a0986d829967a0c7653b197ed744afff4267d013702bad2371b40f32bd4a59f
-  data.tar.gz: edd7430e6c3cb224a56fbea5e4e59042c3bb752ac6c3616fbe5763f24f94fbf2cbd8e6cfb82015b49b03fa283c875582ba3f4beb12986125f9f9b8ba31ee8eeb
+  metadata.gz: c5d4d5cd7dae89474741e4a985452b2a7aaf15681ba97b61a4fe8ddf8a52d5ecebd0267a6c4304470e65b5a20c35cf52a46c3f4aa66cb86febe0c313d5534914
+  data.tar.gz: 965e6fbd91337cc4f22c88ed74b4ca02ffc1a5fd3dacc8dbd9b0a3efc7254c288fa06efc840827fb453372b389f9cf35fd66398c15f276e3103ec863a820a221

data/CHANGELOG.md

@@ -0,0 +1,19 @@
+## 0.1.0.beta2 (2022-11-28)
+
+### Features
+* Add associate company to contact logic
+* Update README to make it more understanble
+
+### Breaking Changes
+None
+
+## 0.1.0.beta1 (2022-11-25)
+
+### Features
+* Add Company Model and Client
+* Add primary_company method to Contact model
+* Add Properties Client
+* Add Matrix for RSpec tests and support for the moment Ruby 3.0 and 3.1
+
+## Breaking Changes
+None

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    hubspot_client (0.1.0.beta1)
+    hubspot_client (0.1.0.beta2)
       httparty (~> 0.20.0)
 
 GEM

data/README.md

@@ -38,6 +38,7 @@ The idea is that the models behave like an ActiveRecord Model.
 
 #### find
 You can find by `hubspot_id` or `email`
+
 ```ruby
 HubspotClient::Model::Contact.find(hubspot_id: '1337')
 => #<HubspotClient::Model::Contact createdate="2022-11-11T11:57:15.901Z", email="vader@example.com", firstname="Darth", hs_object_id="1337", lastmodifieddate="2022-11-17T13:31:00.526Z", lastname="Vader">
@@ -46,9 +47,62 @@ HubspotClient::Model::Contact.find(email: 'vader@example.com')
 => #<HubspotClient::Model::Contact createdate="2022-11-11T11:57:15.901Z", email="vader@example.com", firstname="Darth", hs_object_id="1337", lastmodifieddate="2022-11-17T13:31:00.526Z", lastname="Vader">
 ```
 
+#### Associate_primary_company
+
+Successfull Request
+```ruby
+hubspot_contact = HubspotClient::Model::Contact.find(hubspot_id: '1337')
+=> #<HubspotClient::Model::Contact createdate="2022-11-11T11:57:15.901Z", email="vader@example.com", firstname="Darth", hs_object_id="1337", lastmodifieddate="2022-11-17T13:31:00.526Z", lastname="Vader"> 
+
+hubspot_contact.associate_primary_company(6582942445)
+=> true
+```
+
 ### Company
 
-[Hubspot- API](https://developers.hubspot.com/docs/api/crm/companies)
+Here you can find the [Hubspot-Companies-API-Documentation](https://developers.hubspot.com/docs/api/crm/companies)
+
+#### find
+
+Find a company be `hubspot_id`
+
+```ruby
+HubspotClient::Model::Company.find(hubspot_id: '6614067165')
+=> #<HubspotClient::Model::Company address="Todesternstraße 1", city="Todestern", createdate="2022-11-28T13:45:40.989Z", hs_lastmodifieddate="2022-11-28T13:45:44.933Z", hs_object_id="6614067165", name="Todesternverwaltungs GmbH", phone="0152123456789", zip="1337">
+```
+
+#### create
+
+```ruby
+example_properties = { name: 'Todesternverwaltungs GmbH',
+                       phone: '0152123456789',
+                       address: 'Todesternstraße 1',
+                       city: 'Todestern',
+                       zip: '1337' }
+
+HubspotClient::Model::Company.create(example_properties)
+=> #<HubspotClient::Model::Company address="Todesternstraße 1", city="Todestern", createdate="2022-11-28T13:45:40.989Z", hs_lastmodifieddate="2022-11-28T13:45:40.989Z", hs_object_id="6614067165", hs_pipeline="companies-lifecycle-pipeline", lifecyclestage="lead", name="Todesternverwaltungs GmbH", phone="0152123456789", zip="1337">  
+```
+
+#### update
+
+```ruby
+hubspot_company = HubspotClient::Model::Company.find(hubspot_id: '6614067165')
+
+# You can change the attribute like so:
+hubspot_company.name = 'Blubber'
+
+# or like so:
+hubspot_company.assign_attributes(name: 'Blubber')
+
+# then you can run:
+hubspot_company.update
+
+# you can also do it directly in the update method:
+hubspot_company.update({ name: 'Blubber' })
+```
+
+
 
 ### Subscription-Preferences
 

data/lib/hubspot_client/client/contact.rb

@@ -5,27 +5,28 @@ module HubspotClient
     class ContactNotFound < StandardError; end
     class ContactNotCreated < StandardError; end
     class ContactNotUpdated < StandardError; end
+    class AssociationError < StandardError; end
 
     class Contact
       include HTTParty
       base_uri 'https://api.hubapi.com'
 
-      BASE_PATH = '/crm/v3/objects/contacts'
+      BASE_PATH_V3 = '/crm/v3/objects/contacts'
       FIND_PROPERTIES = %w[firstname lastname email phone lifecyclestage associatedcompanyid].freeze
 
       def find_by_email(email)
         query_params = find_query_params({ idProperty: 'email' })
-        find_by("#{BASE_PATH}/#{email}?#{query_params}")
+        find_by("#{BASE_PATH_V3}/#{email}?#{query_params}")
       end
 
       def find_by_id(hubspot_id)
         query_params = find_query_params
 
-        find_by("#{BASE_PATH}/#{hubspot_id}?#{query_params}")
+        find_by("#{BASE_PATH_V3}/#{hubspot_id}?#{query_params}")
       end
 
       def create(properties)
-        response = self.class.post(BASE_PATH,
+        response = self.class.post(BASE_PATH_V3,
                                    body: { properties: properties }.to_json,
                                    headers: headers)
 
@@ -35,7 +36,7 @@ module HubspotClient
       end
 
       def update(hubspot_id, properties)
-        response = self.class.patch("#{BASE_PATH}/#{hubspot_id}",
+        response = self.class.patch("#{BASE_PATH_V3}/#{hubspot_id}",
                                     body: { properties: properties }.to_json,
                                     headers: headers)
 
@@ -44,6 +45,15 @@ module HubspotClient
         raise ContactNotUpdated, 'Hubspot could not update'
       end
 
+      def associate_with(hubspot_id, to_object_type, to_object_type_id, association_type = '1')
+        path = "#{BASE_PATH_V3}/#{hubspot_id}/associations/#{to_object_type}/#{to_object_type_id}/#{association_type}"
+        response = self.class.put(path, headers: headers)
+
+        return response if response.code == 200
+
+        raise AssociationError, response
+      end
+
       private
 
       def find_by(path)

data/lib/hubspot_client/model/company.rb

@@ -20,7 +20,8 @@ module HubspotClient
         new(response['properties'])
       end
 
-      def update
+      def update(new_properties = {})
+        assign_attributes(new_properties)
         properties = to_h.slice(*UPDATABLE_PROPERTIES)
         response = Client::Company.new.update(hs_object_id, properties)
 
@@ -37,6 +38,12 @@ module HubspotClient
 
         self
       end
+
+      def assign_attributes(attributes)
+        attributes.each do |attribute, value|
+          self[attribute] = value
+        end
+      end
     end
   end
 end

data/lib/hubspot_client/model/contact.rb

@@ -26,7 +26,8 @@ module HubspotClient
         new(response['properties'])
       end
 
-      def update
+      def update(new_properties = {})
+        assign_attributes(new_properties)
         properties = to_h.slice(*UPDATABLE_PROPERTIES)
         response = Client::Contact.new.update(hs_object_id, properties)
 
@@ -47,6 +48,20 @@ module HubspotClient
       def primary_company
         @primary_company ||= Company.find(hubspot_id: associatedcompanyid)
       end
+
+      def associate_primary_company(hubspot_id)
+        response = Client::Contact.new.associate_with(hs_object_id, 'companies', hubspot_id)
+
+        return true if response.code == 200
+
+        false
+      end
+
+      def assign_attributes(attributes)
+        attributes.each do |attribute, value|
+          self[attribute] = value
+        end
+      end
     end
   end
 end

data/lib/hubspot_client/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module HubspotClient
-  VERSION = '0.1.0.beta1'
+  VERSION = '0.1.0.beta2'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: hubspot_client
 version: !ruby/object:Gem::Version
-  version: 0.1.0.beta1
+  version: 0.1.0.beta2
 platform: ruby
 authors:
 - Garllon
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-11-24 00:00:00.000000000 Z
+date: 2022-11-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
@@ -152,6 +152,7 @@ files:
 - ".github/workflows/rspec_and_rubocop.yml"
 - ".gitignore"
 - ".rubocop.yml"
+- CHANGELOG.md
 - Gemfile
 - Gemfile.lock
 - README.md
@@ -187,7 +188,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: 1.3.1
 requirements: []
-rubygems_version: 3.3.3
+rubygems_version: 3.3.22
 signing_key:
 specification_version: 4
 summary: Hubspot client