ledger_sync-quickbooks_online 0.1.1

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

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module LedgerSync
+  module QuickBooksOnline
+    class LedgerClass
+      module Operations
+        class Find < QuickBooksOnline::Operation::Find
+          class Contract < LedgerSync::Ledgers::Contract
+            params do
+              required(:external_id).maybe(:string)
+              required(:ledger_id).filled(:string)
+              optional(:Name).maybe(:string)
+              optional(:Active).maybe(:bool?)
+              optional(:SubClass).maybe(:bool?)
+              optional(:FullyQualifiedName).maybe(:string)
+              optional(:Parent).maybe(:hash, Types::Reference)
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module LedgerSync
+  module QuickBooksOnline
+    class LedgerClass
+      module Operations
+        class Update < QuickBooksOnline::Operation::FullUpdate
+          class Contract < LedgerSync::Ledgers::Contract
+            params do
+              required(:external_id).maybe(:string)
+              required(:ledger_id).filled(:string)
+              required(:Name).filled(:string)
+              required(:Active).filled(:bool?)
+              required(:SubClass).filled(:bool?)
+              optional(:FullyQualifiedName).maybe(:string)
+              optional(:Parent).maybe(:hash, Types::Reference)
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

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

data/lib/ledger_sync/quickbooks_online/ledger_class/serializer.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require_relative '../reference/serializer'
+
+module LedgerSync
+  module QuickBooksOnline
+    class LedgerClass
+      class Serializer < QuickBooksOnline::Serializer
+        id
+
+        attribute :Name
+        attribute :Active
+        attribute :SubClass
+        attribute :FullyQualifiedName
+
+        references_one 'ParentRef',
+                       resource_attribute: :Parent,
+                       serializer: Reference::Serializer
+      end
+    end
+  end
+end

data/lib/ledger_sync/quickbooks_online/oauth_client.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+module LedgerSync
+  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

data/lib/ledger_sync/quickbooks_online/operation.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+module LedgerSync
+  module QuickBooksOnline
+    class Operation
+      module Mixin
+        def self.included(base)
+          base.include Ledgers::Operation::Mixin
+          base.include InstanceMethods # To ensure these override parent methods
+        end
+
+        module InstanceMethods
+          def deserialized_resource(response:)
+            deserializer.deserialize(
+              hash: response.body[quickbooks_online_resource_type.to_s.camelize],
+              resource: resource
+            )
+          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 response_to_operation_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)
+          ensure
+            client.update_secrets_in_dotenv
+          end
+
+          def quickbooks_online_resource_type
+            @quickbooks_online_resource_type ||= client.class.ledger_resource_type_for(resource_class: resource.class)
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require_relative '../operation'
+
+module LedgerSync
+  module QuickBooksOnline
+    class Operation
+      class Create
+        include QuickBooksOnline::Operation::Mixin
+
+        private
+
+        def operate
+          response_to_operation_result(
+            response: client.post(
+              path: ledger_resource_type_for_path,
+              payload: serializer.serialize(resource: resource)
+            )
+          )
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require_relative '../operation'
+
+module LedgerSync
+  module QuickBooksOnline
+    class Operation
+      class Find
+        include QuickBooksOnline::Operation::Mixin
+
+        private
+
+        def operate
+          response_to_operation_result(
+            response: client.find(
+              path: ledger_resource_path
+            )
+          )
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+require_relative '../operation'
+
+module LedgerSync
+  module QuickBooksOnline
+    class Operation
+      class FullUpdate
+        include QuickBooksOnline::Operation::Mixin
+
+        private
+
+        def find_resource
+          client.find(
+            path: ledger_resource_path
+          )
+        end
+
+        def operate
+          find_result_hash = find_resource.body[quickbooks_online_resource_type.to_s.classify]
+          merged_resource = deserializer.deserialize(
+            hash: find_result_hash,
+            merge_for_full_update: true,
+            resource: resource
+          )
+          merged_serializer = serializer.class.new
+          response_to_operation_result(
+            response: client.post(
+              path: ledger_resource_type_for_path,
+              payload: merged_serializer.serialize(
+                deep_merge_unmapped_values: find_result_hash,
+                resource: merged_resource
+              )
+            )
+          )
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require_relative '../operation'
+
+module LedgerSync
+  module QuickBooksOnline
+    class Operation
+      class SparseUpdate
+        include QuickBooksOnline::Operation::Mixin
+
+        private
+
+        def operate
+          response = client.post(
+            resource: quickbooks_online_resource_type,
+            payload: merged_serializer.serialize
+          )
+
+          response_to_operation_result(
+            resource: serializer.deserialize(hash: response),
+            response: response
+          )
+        end
+      end
+    end
+  end
+end

data/lib/ledger_sync/quickbooks_online/payment/deserializer.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+require_relative '../reference/deserializer'
+require_relative '../payment_line/deserializer'
+
+module LedgerSync
+  module QuickBooksOnline
+    class Payment
+      class Deserializer < QuickBooksOnline::Deserializer
+        id
+
+        amount :TotalAmt
+        attribute :PaymentRefNum
+        attribute :PrivateNote
+        attribute :ExchangeRate
+        date :TxnDate
+
+        references_one :Currency,
+                       hash_attribute: 'CurrencyRef',
+                       deserializer: Reference::Deserializer
+
+        references_one :Customer,
+                       hash_attribute: 'CustomerRef',
+                       deserializer: Reference::Deserializer
+
+        references_one :DepositToAccount,
+                       hash_attribute: 'DepositToAccountRef',
+                       deserializer: Reference::Deserializer
+
+        references_one :ARAccount,
+                       hash_attribute: 'ARAccountRef',
+                       deserializer: Account::Deserializer
+
+        references_many :Line,
+                        hash_attribute: 'Line',
+                        deserializer: PaymentLine::Deserializer
+      end
+    end
+  end
+end

data/lib/ledger_sync/quickbooks_online/payment/operations/create.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module LedgerSync
+  module QuickBooksOnline
+    class Payment
+      module Operations
+        class Create < Operation::Create
+          class Contract < LedgerSync::Ledgers::Contract
+            params do
+              required(:external_id).maybe(:string)
+              optional(:ARAccount).hash(Types::Reference)
+              required(:Currency).filled(:hash, Types::Reference)
+              required(:Customer).hash(Types::Reference)
+              optional(:DepositToAccount).hash(Types::Reference)
+              optional(:ExchangeRate).maybe(:float)
+              required(:ledger_id).value(:nil)
+              required(:Line).array(Types::Reference)
+              optional(:PrivateNote).filled(:string)
+              optional(:PaymentRefNum).maybe(:string)
+              required(:TotalAmt).filled(:integer)
+              optional(:TxnDate).filled(:date?)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ledger_sync/quickbooks_online/payment/operations/find.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module LedgerSync
+  module QuickBooksOnline
+    class Payment
+      module Operations
+        class Find < Operation::Find
+          class Contract < LedgerSync::Ledgers::Contract
+            schema do
+              required(:external_id).maybe(:string)
+              optional(:ARAccount).hash(Types::Reference)
+              optional(:Currency).maybe(:hash, Types::Reference)
+              optional(:Customer).hash(Types::Reference)
+              optional(:DepositToAccount).hash(Types::Reference)
+              optional(:ExchangeRate).maybe(:float)
+              required(:ledger_id).filled(:string)
+              optional(:Line).array(Types::Reference)
+              optional(:PrivateNote).maybe(:string)
+              optional(:PaymentRefNum).maybe(:string)
+              optional(:TotalAmt).maybe(:integer)
+              optional(:TxnDate).maybe(:date?)
+            end
+          end
+        end
+      end
+    end
+  end
+end