hubspot-api-client 6.0.0 → 7.3.0

data/sample-apps/timeline-events-app/Rakefile

@@ -0,0 +1,6 @@
+# Add your own tasks in files placed in lib/tasks ending in .rake,
+# for example lib/tasks/capistrano.rake, and they will automatically be available to Rake.
+
+require_relative 'config/application'
+
+Rails.application.load_tasks

data/sample-apps/timeline-events-app/app/assets/config/manifest.js

@@ -0,0 +1,3 @@
+//= link_tree ../images
+//= link_directory ../javascripts .js
+//= link_directory ../stylesheets .css

data/sample-apps/timeline-events-app/app/assets/javascripts/application.js

@@ -0,0 +1,15 @@
+// This is a manifest file that'll be compiled into application.js, which will include all the files
+// listed below.
+//
+// Any JavaScript/Coffee file within this directory, lib/assets/javascripts, or any plugin's
+// vendor/assets/javascripts directory can be referenced here using a relative path.
+//
+// It's not advisable to add code directly here, but if you do, it'll appear at the bottom of the
+// compiled file. JavaScript code in this file should be added after the last require_* statement.
+//
+// Read Sprockets README (https://github.com/rails/sprockets#sprockets-directives) for details
+// about supported directives.
+//
+//= require rails-ujs
+//= require activestorage
+//= require_tree .

data/sample-apps/timeline-events-app/app/assets/javascripts/cable.js

@@ -0,0 +1,13 @@
+// Action Cable provides the framework to deal with WebSockets in Rails.
+// You can generate new channels where WebSocket features live using the `rails generate channel` command.
+//
+//= require action_cable
+//= require_self
+//= require_tree ./channels
+
+(function() {
+  this.App || (this.App = {});
+
+  App.cable = ActionCable.createConsumer();
+
+}).call(this);

data/sample-apps/timeline-events-app/app/assets/stylesheets/application.css

@@ -0,0 +1,101 @@
+/*
+ * This is a manifest file that'll be compiled into application.css, which will include all the files
+ * listed below.
+ *
+ * Any CSS and SCSS file within this directory, lib/assets/stylesheets, or any plugin's
+ * vendor/assets/stylesheets directory can be referenced here using a relative path.
+ *
+ * You're free to add application-wide styles to this file and they'll appear at the bottom of the
+ * compiled file so the styles you add here take precedence over styles defined in any other CSS/SCSS
+ * files in this directory. Styles in this file should be added after the last require_* statement.
+ * It is generally better to create a new file per style scope.
+ *
+ *= require_tree .
+ *= require_self
+ */
+
+ .wrapper .container {
+  padding-bottom: 2rem;
+  padding-top: 2rem;
+}
+
+.navigation {
+  background: #f4f5f6;
+  border-bottom: .1rem solid #d1d1d1;
+  display: block;
+  height: 5.2rem;
+  left: 0;
+  max-width: 100%;
+  width: 100%;
+}
+
+.navigation .container {
+  padding-bottom: 0;
+  padding-top: 0
+}
+
+.navigation .navigation-list {
+  list-style: none;
+  margin-bottom: 0;
+}
+
+.navigation .navigation-item {
+  float: left;
+  margin-bottom: 0;
+  margin-left: 2.5rem;
+  position: relative
+}
+
+.navigation .navigation-title, .navigation .title {
+  color: #606c76;
+  position: relative
+}
+
+.navigation .navigation-link, .navigation .navigation-title, .navigation .title {
+  display: inline;
+  font-size: 1.6rem;
+  line-height: 5.2rem;
+  padding: 0;
+  text-decoration: none
+}
+
+.navigation .navigation-link.active {
+  color: #606c76
+}
+
+pre {
+  line-height: 0.7;
+}
+
+pre p {
+  margin: 0;
+  margin-left: 5px;
+}
+
+.row {
+  display: flex;
+}
+
+.column {
+  flex: 50%;
+}
+
+.alert {
+  padding: 20px;
+  background-color: #f7786f;
+  color: white;
+  margin-bottom: 15px;
+}
+
+.contacts-iframe {
+  height: 700px;
+  width: 100%;
+  position:relative;
+}
+
+.contacts-iframe iframe {
+  border: none;
+  position:absolute;
+  width:1080px;
+  height:900px;
+}

data/sample-apps/timeline-events-app/app/controllers/application_controller.rb

@@ -0,0 +1,12 @@
+class ApplicationController < ActionController::Base
+  include ExceptionHandler
+
+  before_action :check_env_variables
+
+  private
+
+  def check_env_variables
+    missing_vars = %w[HUBSPOT_CLIENT_ID HUBSPOT_CLIENT_SECRET].select { |var| ENV[var].blank? }
+    raise(ExceptionHandler::HubspotError.new, "Please specify #{missing_vars.join(', ')} in .env") if missing_vars.present?
+  end
+end

data/sample-apps/timeline-events-app/app/controllers/concerns/exception_handler.rb

@@ -0,0 +1,12 @@
+module ExceptionHandler
+  extend ActiveSupport::Concern
+
+  class HubspotError < StandardError; end
+
+  included do
+    rescue_from HubspotError do |error|
+      @error = error
+      render template: 'timeline_events/index'
+    end
+  end
+end

data/sample-apps/timeline-events-app/app/controllers/oauth/authorization_controller.rb

@@ -0,0 +1,19 @@
+module Oauth
+  class AuthorizationController < ApplicationController
+    def authorize
+      url = Services::Authorization::GetAuthorizationUri.new(request: request).call
+      redirect_to url
+    end
+
+    def callback
+      session[:tokens] = Services::Authorization::Tokens::Generate.new(
+        code: params[:code],
+        request: request
+      ).call
+      Services::Authorization::AuthorizeHubspot.new(tokens: session[:tokens]).call
+      redirect_to root_path
+    end
+
+    def login;end
+  end
+end

data/sample-apps/timeline-events-app/app/controllers/timeline_events_controller.rb

@@ -0,0 +1,37 @@
+class TimelineEventsController < ApplicationController
+  before_action :authorize
+
+  def index
+    return unless params[:contact_id]
+
+    @contacts_url = 'https://app.hubspot.com/contacts/' + ENV['HUBSPOT_ACCOUNT_ID'] +
+                    '/contact/' + params[:contact_id]
+  end
+
+  def create
+    if email_valid?
+      template = Services::Hubspot::Timeline::CreateTemplate.new(template_params).call
+      event = Services::Hubspot::Timeline::CreateEvent.new(template_params[:email], template.id).call
+      redirect_to root_path(contact_id: event.object_id)
+    else
+      redirect_to root_path, flash: { error: "Error: we can't find this email in your contacts list." }
+    end
+  end
+
+  private
+
+  def email_valid?
+    Services::Hubspot::Contacts::Search.new(email: template_params[:email]).call.present?
+  end
+
+  def template_params
+    params.require(:event_template).permit(:email, :target_record_type, :header_template, :detail_template)
+  end
+
+  def authorize
+    redirect_to login_path and return if session['tokens'].blank?
+
+    session['tokens'] = Services::Authorization::Tokens::Refresh.new(tokens: session['tokens'], request: request).call
+    Services::Authorization::AuthorizeHubspot.new(tokens: session['tokens']).call
+  end
+end

data/sample-apps/timeline-events-app/app/helpers/application_helper.rb

@@ -0,0 +1,2 @@
+module ApplicationHelper
+end

data/sample-apps/timeline-events-app/app/lib/services/authorization/authorize_hubspot.rb

@@ -0,0 +1,15 @@
+module Services
+  module Authorization
+    class AuthorizeHubspot
+      def initialize(tokens:)
+        @tokens = tokens
+      end
+
+      def call
+        ::Hubspot.configure do |config|
+          config.access_token = @tokens[:access_token]
+        end
+      end
+    end
+  end
+end

data/sample-apps/timeline-events-app/app/lib/services/authorization/get_authorization_uri.rb

@@ -0,0 +1,33 @@
+module Services
+  module Authorization
+    class GetAuthorizationUri
+      CALLBACK_PATH = '/oauth/callback'.freeze
+
+      def initialize(request:)
+        @request = request
+      end
+
+      def call
+        check_presence_of_credentials
+
+        ::Hubspot::OAuthHelper.authorize_url(
+          client_id: ENV['HUBSPOT_CLIENT_ID'],
+          redirect_uri: redirect_uri,
+          scope: %w[contacts]
+        )
+      end
+
+      private
+
+      def redirect_uri
+        @request.protocol + @request.host_with_port + CALLBACK_PATH
+      end
+
+      def check_presence_of_credentials
+        return if ENV['HUBSPOT_CLIENT_ID'].present?
+
+        raise(ExceptionHandler::HubspotError.new, 'Please specify HUBSPOT_CLIENT_ID in .env')
+      end
+    end
+  end
+end

data/sample-apps/timeline-events-app/app/lib/services/authorization/tokens/base.rb

@@ -0,0 +1,19 @@
+module Services
+  module Authorization
+    module Tokens
+      class Base
+        CALLBACK_PATH = '/oauth/callback'.freeze
+
+        def expires_at(expires_in)
+          Time.current + (expires_in * 0.95).round
+        end
+
+        private
+
+        def redirect_uri
+          @request.protocol + @request.host_with_port + CALLBACK_PATH
+        end
+      end
+    end
+  end
+end

data/sample-apps/timeline-events-app/app/lib/services/authorization/tokens/generate.rb

@@ -0,0 +1,26 @@
+module Services
+  module Authorization
+    module Tokens
+      class Generate < Tokens::Base
+        def initialize(code:, request:)
+          @code = code
+          @request = request
+        end
+
+        def call
+          default_api = ::Hubspot::OAuth::DefaultApi.new
+          tokens = default_api.create_token(
+            grant_type: :authorization_code,
+            code: @code,
+            redirect_uri: redirect_uri,
+            client_id: ENV['HUBSPOT_CLIENT_ID'],
+            client_secret: ENV['HUBSPOT_CLIENT_SECRET'],
+            return_type: 'Object'
+          )
+          tokens[:expires_at] = expires_at(tokens[:expires_in])
+          tokens
+        end
+      end
+    end
+  end
+end

data/sample-apps/timeline-events-app/app/lib/services/authorization/tokens/refresh.rb

@@ -0,0 +1,33 @@
+module Services
+  module Authorization
+    module Tokens
+      class Refresh < Tokens::Base
+        def initialize(tokens:, request:)
+          @tokens = tokens
+          @request = request
+        end
+
+        def call
+          @tokens = refresh_tokens if Time.current > @tokens[:expires_at]
+          @tokens
+        end
+
+        private
+
+        def refresh_tokens
+          default_api = ::Hubspot::OAuth::DefaultApi.new
+          tokens = default_api.create_token(
+            grant_type: :refresh_token,
+            refresh_token: @tokens[:refresh_token],
+            redirect_uri: redirect_uri,
+            client_id: ENV['HUBSPOT_CLIENT_ID'],
+            client_secret: ENV['HUBSPOT_CLIENT_SECRET'],
+            return_type: 'Object'
+          )
+          tokens[:expires_at] = expires_at(tokens[:expires_in])
+          tokens
+        end
+      end
+    end
+  end
+end

data/sample-apps/timeline-events-app/app/lib/services/hubspot/contacts/search.rb

@@ -0,0 +1,37 @@
+module Services
+  module Hubspot
+    module Contacts
+      class Search
+        def initialize(email:)
+          @email = email
+        end
+
+        def call
+          search_api = ::Hubspot::Crm::Contacts::SearchApi.new
+          results = search_api.do_search(search_request, auth_names: 'oauth2').results
+          results = add_fullnames(results)
+          results
+        end
+
+        private
+
+        def search_request
+          filter = ::Hubspot::Crm::Contacts::Filter.new(
+            property_name: 'email',
+            operator: 'EQ',
+            value: @email
+          )
+          filter_group = ::Hubspot::Crm::Contacts::FilterGroup.new(filters: [filter])
+          ::Hubspot::Crm::Contacts::PublicObjectSearchRequest.new(filter_groups: [filter_group])
+        end
+
+        def add_fullnames(contacts)
+          contacts.each do |contact|
+            fullname = [contact.properties['firstname'], contact.properties['lastname']].reject(&:empty?).join(' ')
+            contact.properties['fullname'] = fullname
+          end
+        end
+      end
+    end
+  end
+end

data/sample-apps/timeline-events-app/app/lib/services/hubspot/timeline/create_event.rb

@@ -0,0 +1,20 @@
+module Services
+  module Hubspot
+    module Timeline
+      class CreateEvent
+        def initialize(email, template_id)
+          @email = email
+          @template_id = template_id
+        end
+
+        def call
+          timeline_event = ::Hubspot::Crm::Timeline::TimelineEvent.new(
+            email: @email,
+            event_template_id: @template_id
+          )
+          ::Hubspot::Crm::Timeline::EventsApi.new.create(timeline_event: timeline_event)
+        end
+      end
+    end
+  end
+end

data/sample-apps/timeline-events-app/app/lib/services/hubspot/timeline/create_template.rb

@@ -0,0 +1,39 @@
+module Services
+  module Hubspot
+    module Timeline
+      class CreateTemplate
+        def initialize(template_params)
+          @template_params = template_params
+        end
+
+        def call
+          api_client = api_client_with_hapikey
+          create_api = ::Hubspot::Crm::Timeline::TemplatesApi.new(api_client)
+          create_api.create(
+            ENV['HUBSPOT_APPLICATION_ID'],
+            timeline_event_template_create_request: template_create_request,
+            auth_names: 'hapikey'
+          )
+        end
+
+        private
+
+        def template_create_request
+          ::Hubspot::Crm::Timeline::TimelineEventTemplateCreateRequest.new(
+            object_type: @template_params[:target_record_type],
+            name: 'Test event template name',
+            header_template: @template_params[:header_template],
+            detail_template: @template_params[:detail_template]
+          )
+        end
+
+        def api_client_with_hapikey
+          config = ::Hubspot::Crm::Timeline::Configuration.new do |config|
+            config.api_key = { 'hapikey' => ENV['HUBSPOT_DEVELOPER_API_KEY'] }
+          end
+          ::Hubspot::Crm::Timeline::ApiClient.new(config)
+        end
+      end
+    end
+  end
+end