ledger_sync 1.1.3 → 1.3.1

data/lib/ledger_sync/adaptors/quickbooks_online/invoice/operations/find.rb

@@ -0,0 +1,25 @@
+module LedgerSync
+  module Adaptors
+    module QuickBooksOnline
+      module Invoice
+        module Operations
+          class Find < Operation::Find
+            class Contract < LedgerSync::Adaptors::Contract
+              schema do
+                required(:external_id).maybe(:string)
+                optional(:account).hash(Types::Reference)
+                optional(:currency).maybe(:string)
+                optional(:customer).hash(Types::Reference)
+                optional(:deposit).maybe(:integer)
+                required(:ledger_id).filled(:string)
+                optional(:line_items).array(Types::Reference)
+                optional(:memo).maybe(:string)
+                optional(:transaction_date).maybe(:date?)
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ledger_sync/adaptors/quickbooks_online/invoice/operations/update.rb

@@ -0,0 +1,25 @@
+module LedgerSync
+  module Adaptors
+    module QuickBooksOnline
+      module Invoice
+        module Operations
+          class Update < Operation::FullUpdate
+            class Contract < LedgerSync::Adaptors::Contract
+              schema do
+                required(:external_id).maybe(:string)
+                optional(:account).hash(Types::Reference)
+                required(:currency).filled(:string)
+                required(:customer).hash(Types::Reference)
+                optional(:deposit).maybe(:integer)
+                required(:ledger_id).filled(:string)
+                required(:line_items).array(Types::Reference)
+                optional(:memo).filled(:string)
+                optional(:transaction_date).filled(:date?)
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ledger_sync/adaptors/quickbooks_online/invoice_sales_line_item/ledger_serializer.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module LedgerSync
+  module Adaptors
+    module QuickBooksOnline
+      module InvoiceSalesLineItem
+        class LedgerSerializer < QuickBooksOnline::LedgerSerializer
+          id
+
+          attribute ledger_attribute: 'DetailType' do
+            'SalesItemLineDetail'
+          end
+
+          attribute ledger_attribute: 'SalesItemLineDetail.ItemRef.value',
+                    resource_attribute: 'item.ledger_id'
+
+          attribute ledger_attribute: 'SalesItemLineDetail.ClassRef.value',
+                    resource_attribute: 'ledger_class.ledger_id'
+
+          attribute ledger_attribute: 'Amount',
+                    resource_attribute: :amount,
+                    type: LedgerSerializerType::AmountType
+
+          attribute ledger_attribute: 'Description',
+                    resource_attribute: :description
+        end
+      end
+    end
+  end
+end

data/lib/ledger_sync/adaptors/quickbooks_online/item/ledger_serializer.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module LedgerSync
+  module Adaptors
+    module QuickBooksOnline
+      module Item
+        class LedgerSerializer < QuickBooksOnline::LedgerSerializer
+          id
+        end
+      end
+    end
+  end
+end

data/lib/ledger_sync/adaptors/quickbooks_online/journal_entry/searcher.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+
 require_relative '../searcher'
 
 module LedgerSync
@@ -6,21 +7,6 @@ module LedgerSync
     module QuickBooksOnline
       module JournalEntry
         class Searcher < QuickBooksOnline::Searcher
-          def resources
-            @resources ||= begin
-              adaptor
-                .query(
-                  resource: 'journal_entry',
-                  limit: limit,
-                  offset: offset
-                )
-                .map do |c|
-                  LedgerSync::JournalEntry.new(
-                    ledger_id: c.fetch('Id')
-                  )
-                end
-            end
-          end
         end
       end
     end

data/lib/ledger_sync/adaptors/quickbooks_online/ledger_class/ledger_serializer.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module LedgerSync
+  module Adaptors
+    module QuickBooksOnline
+      module LedgerClass
+        class LedgerSerializer < QuickBooksOnline::LedgerSerializer
+          id
+
+          attribute ledger_attribute: 'Name',
+                    resource_attribute: :name
+          attribute ledger_attribute: 'Active',
+                    resource_attribute: :active
+          attribute ledger_attribute: 'SubClass',
+                    resource_attribute: :sub_class
+          attribute ledger_attribute: 'FullyQualifiedName',
+                    resource_attribute: :fully_qualified_name
+
+          attribute ledger_attribute: 'ParentRef.value',
+                    resource_attribute: 'parent.ledger_id'
+        end
+      end
+    end
+  end
+end

data/lib/ledger_sync/adaptors/quickbooks_online/ledger_class/operations/create.rb

@@ -0,0 +1,23 @@
+module LedgerSync
+  module Adaptors
+    module QuickBooksOnline
+      module LedgerClass
+        module Operations
+          class Create < QuickBooksOnline::Operation::Create
+            class Contract < LedgerSync::Adaptors::Contract
+              params do
+                required(:external_id).maybe(:string)
+                required(:ledger_id).value(:nil)
+                required(:name).filled(:string)
+                required(:active).filled(:bool?)
+                required(:sub_class).filled(:bool?)
+                optional(:fully_qualified_name).maybe(:string)
+                optional(:parent).maybe(:hash, Types::Reference)
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ledger_sync/adaptors/quickbooks_online/ledger_class/operations/find.rb

@@ -0,0 +1,23 @@
+module LedgerSync
+  module Adaptors
+    module QuickBooksOnline
+      module LedgerClass
+        module Operations
+          class Find < QuickBooksOnline::Operation::Find
+            class Contract < LedgerSync::Adaptors::Contract
+              params do
+                required(:external_id).maybe(:string)
+                required(:ledger_id).filled(:string)
+                optional(:name).maybe(:string)
+                optional(:active).maybe(:bool?)
+                optional(:sub_class).maybe(:bool?)
+                optional(:fully_qualified_name).maybe(:string)
+                optional(:parent).maybe(:hash, Types::Reference)
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ledger_sync/adaptors/quickbooks_online/ledger_class/operations/update.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module LedgerSync
+  module Adaptors
+    module QuickBooksOnline
+      module LedgerClass
+        module Operations
+          class Update < QuickBooksOnline::Operation::FullUpdate
+            class Contract < LedgerSync::Adaptors::Contract
+              params do
+                required(:external_id).maybe(:string)
+                required(:ledger_id).filled(:string)
+                required(:name).filled(:string)
+                required(:active).filled(:bool?)
+                required(:sub_class).filled(:bool?)
+                optional(:fully_qualified_name).maybe(:string)
+                optional(:parent).maybe(:hash, Types::Reference)
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ledger_sync/adaptors/quickbooks_online/ledger_class/searcher.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module LedgerSync
+  module Adaptors
+    module QuickBooksOnline
+      module LedgerClass
+        class Searcher < LedgerSync::Adaptors::QuickBooksOnline::Searcher
+          def query_string
+            "Name LIKE '%#{query}%'"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ledger_sync/adaptors/quickbooks_online/ledger_serializer.rb

@@ -79,12 +79,15 @@ module LedgerSync
           QuickBooksOnline.const_get("#{resource_class.name.split('LedgerSync::')[1..-1].join('LedgerSync::')}::LedgerSerializer")
         end
 
-        def self.quickbooks_online_resource_type(type = nil)
+        def self.quickbooks_online_resource_type
           @quickbooks_online_resource_type ||= begin
-            inferred_resource_class = _inferred_resource_class
-            qbo_type = (type || inferred_resource_class.resource_type).to_s
-            type_hash = QuickBooksOnline::LedgerSerializer.quickbooks_online_resource_types_hash.try(:fetch, qbo_type, nil)
-            raise "Cannot define type in #{name}.  Type already exists: #{qbo_type}.  Defined previously by #{quickbooks_online_resource_types_hash[qbo_type][:serializer_class].name}" if type_hash.present? && (type_hash[:serializer_class] != serializer_class || type_hash[:resource_class] != inferred_resource_class) if type_hash.present?
+            qbo_type = Adaptor.ledger_resource_type_for(
+              resource_class: inferred_resource_class
+            )
+            type_hash = QuickBooksOnline::LedgerSerializer
+                        .quickbooks_online_resource_types_hash
+                        .try(:fetch, qbo_type, nil)
+            raise "Cannot define type in #{name}.  Type already exists: #{qbo_type}.  Defined previously by #{quickbooks_online_resource_types_hash[qbo_type][:serializer_class].name}" if type_hash.present? && (type_hash[:serializer_class] != serializer_class || type_hash[:resource_class] != inferred_resource_class)
 
             QuickBooksOnline::LedgerSerializer.class_eval do
               @quickbooks_online_resource_types_hash ||= {}

data/lib/ledger_sync/adaptors/quickbooks_online/ledger_serializer_type/entity_reference_type.rb

@@ -12,15 +12,7 @@ module LedgerSync
             return if value.empty?
 
             value = LedgerSync::Util::HashHelpers.deep_stringify_keys(value)
-            resource_class = begin
-              quickbooks_online_type_hash = QuickBooksOnline::LedgerSerializer.quickbooks_online_resource_types_hash.fetch(value['type'].downcase, nil)
-              if quickbooks_online_type_hash.present?
-                quickbooks_online_type_hash.try(:fetch, :resource_class, nil)
-              else
-                LedgerSync.resources[value['type'].downcase.to_sym]
-              end
-            end
-
+            resource_class = Adaptor.resource_from_ledger_type(type: value['type'])
             raise "Unknown QuickBooks Online resource type: #{value['type']}" if resource_class.blank?
 
             ret = resource_class.new(
@@ -39,11 +31,9 @@ module LedgerSync
               'value' => value.ledger_id
             }
             ret['name'] = value.display_name if value.respond_to?(:display_name)
-            ret['type'] = string_helpers.camelcase(
-              QuickBooksOnline::LedgerSerializer.ledger_serializer_for(
-                resource_class: value.class
-              ).quickbooks_online_resource_type
-            )
+            ret['type'] = Adaptor.ledger_resource_type_for(
+              resource_class: value.class
+            ).classify
             ret
           end
 

data/lib/ledger_sync/adaptors/quickbooks_online/ledger_serializer_type/transaction_reference_type.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module LedgerSync
+  module Adaptors
+    module QuickBooksOnline
+      module LedgerSerializerType
+        class TransactionReferenceType < Adaptors::LedgerSerializerType::ValueType
+          def convert_from_ledger(value:)
+            return if value.nil?
+
+            raise "Unknown value type.  Array expected.  Given: #{value.class.name}" unless value.is_a?(Array)
+            return if value.empty?
+
+            value.map do |item|
+              resource_class = Adaptor.resource_from_ledger_type(type: item['TxnType'])
+
+              raise "Unknown QuickBooks Online resource type: #{item['TxnType']}" if resource_class.blank?
+
+              resource_class.new(
+                ledger_id: item['TxnId']
+              )
+            end
+          end
+
+          def convert_from_local(value:)
+            return if value.nil?
+            raise "List expected.  Given: #{value.class.name}" unless value.is_a?(Array)
+            raise "Resources expected.  Given: #{value.map { |i| i.class.name }.join(', ')}" unless value.all?(LedgerSync::Resource)
+
+            value.map do |resource|
+              {
+                'TxnId' => resource.ledger_id,
+                'TxnType' => Adaptor.ledger_resource_type_for(
+                  resource_class: resource.class
+                ).classify
+              }
+            end
+          end
+
+          private
+
+          def string_helpers
+            @string_helpers ||= LedgerSync::Util::StringHelpers
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ledger_sync/adaptors/quickbooks_online/oauth_client.rb

@@ -0,0 +1,93 @@
+# frozen_string_literal: true
+
+module LedgerSync
+  module Adaptors
+    module QuickBooksOnline
+      class OAuthClient
+        AUTHORIZE_URL     = 'https://appcenter.intuit.com/connect/oauth2'
+        SITE_URL          = 'https://appcenter.intuit.com/connect/oauth2'
+        TOKEN_URL         = 'https://oauth.platform.intuit.com/oauth2/v1/tokens/bearer'
+
+        class RedirectURIParser
+          attr_reader :uri
+
+          def initialize(uri:)
+            @uri = uri
+          end
+
+          def code
+            @code ||= query.fetch('code').first
+          end
+
+          def parsed_uri
+            @parsed_uri = URI.parse(uri)
+          end
+
+          def query
+            @query ||= CGI.parse(parsed_uri.query)
+          end
+
+          def realm_id
+            @realm_id ||= query.fetch('realmId').first
+          end
+
+          def redirect_uri
+            @redirect_uri ||= begin
+              use_uri = parsed_uri.dup
+              use_uri.fragment = nil
+              use_uri.query = nil
+              ret = use_uri.to_s
+              ret = ret[0..-2] if ret.end_with?('/')
+              ret
+            end
+          end
+        end
+
+        attr_reader :client_id,
+                    :client_secret
+
+        def initialize(client_id:, client_secret:)
+          @client_id = client_id
+          @client_secret = client_secret
+        end
+
+        def authorization_url(redirect_uri:)
+          client.auth_code.authorize_url(
+            redirect_uri: redirect_uri,
+            response_type: 'code',
+            state: SecureRandom.hex(12),
+            scope: 'com.intuit.quickbooks.accounting'
+          )
+        end
+
+        def auth_code
+          client.auth_code
+        end
+
+        def client
+          @client ||= OAuth2::Client.new(
+            client_id,
+            client_secret,
+            authorize_url: AUTHORIZE_URL,
+            site: SITE_URL,
+            token_url: TOKEN_URL
+          )
+        end
+
+        def get_token(code:, redirect_uri:)
+          auth_code.get_token(
+            code,
+            redirect_uri: redirect_uri
+          )
+        end
+
+        def self.new_from_env
+          new(
+            client_id: ENV.fetch('QUICKBOOKS_ONLINE_CLIENT_ID'),
+            client_secret: ENV.fetch('QUICKBOOKS_ONLINE_CLIENT_SECRET')
+          )
+        end
+      end
+    end
+  end
+end

data/lib/ledger_sync/adaptors/quickbooks_online/operation.rb

@@ -7,16 +7,51 @@ module LedgerSync
         module Mixin
           def self.included(base)
             base.include Adaptors::Operation::Mixin
+            base.include InstanceMethods # To ensure these override parent methods
           end
 
-          def perform
-            super
-          rescue OAuth2::Error => e
-            failure(e)
-          end
+          module InstanceMethods
+            def deserialized_resource(response:)
+              ledger_serializer.deserialize(
+                hash: response.body.dig(
+                  quickbooks_online_resource_type.to_s.classify
+                )
+              )
+            end
+
+            def ledger_resource_path
+              @ledger_resource_path ||= "#{ledger_resource_type_for_path}/#{resource.ledger_id}"
+            end
+
+            def ledger_resource_type_for_path
+              quickbooks_online_resource_type.tr('_', '')
+            end
+
+            def result(response:)
+              if response.success?
+                success(
+                  resource: deserialized_resource(response: response),
+                  response: response
+                )
+              else
+                failure(
+                  Error::OperationError.new(
+                    operation: self,
+                    response: response
+                  )
+                )
+              end
+            end
+
+            def perform
+              super
+            rescue LedgerSync::Error::OperationError, OAuth2::Error => e
+              failure(e)
+            end
 
-          def quickbooks_online_resource_type
-            @quickbooks_online_resource_type ||= ledger_serializer.class.quickbooks_online_resource_type
+            def quickbooks_online_resource_type
+              @quickbooks_online_resource_type ||= ledger_serializer.class.quickbooks_online_resource_type
+            end
           end
         end
       end