simple_wallet 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ecb26e24cf18bdc51ca2d483ee5570a91418108e4aa42da8138c38d7de099704
-  data.tar.gz: a20a7b3eed5ce08422a739b1419f73da1d1ed7fbd08800ccf5ca329daef09aa7
+  metadata.gz: f6eac1eb277d4d4262cd05c2ced9a10c7f790613a97fb3385e496953cfd7764a
+  data.tar.gz: c4147c19783452b10af6c63bd97e50c4b2c75e70032129e4e3aa5f734630d151
 SHA512:
-  metadata.gz: c4c60183ac0922910a4de5fed4defba64d56126ff2809ab9b20a02996dbbd38dcc641213787ccfda7afe6c234372674737fc5b60578832bc5dcdc36685ac5def
-  data.tar.gz: bc129abbe862eba61e6714d1ee6665839f4f2c95665b005978479b882977dc00e36d559e7109362d3978786696daa861ec030793365af4546407cf9e6dd0a4b7
+  metadata.gz: 1e6c8f15d40e3d4c9612ace9b5e14ba6aadc55dd21b2fc807b8c3326d21ef83532cbbc21edad53ed2ec1e742aaae23af3ae51fbb7ffe7fa47fa0936ca1c9fed2
+  data.tar.gz: dacc153a8da1661f1cecc050b995740889d35359fcc1de4827d0ff28b573a8b8dd7a7bce895079ac2a8dc783558aa671eb1dcb4eedd605b92d295976d18db91e

data/app/services/simple_wallet/account_crediting_service.rb

@@ -0,0 +1,55 @@
+module SimpleWallet
+  class AccountCreditingService < Service
+    validates :account, presence: true
+    validates :amount, presence: true, numericality: { only_integer: true, greater_than: 0 }
+
+    def initialize(account:, amount: nil, source: nil, note: nil)
+      @account = account
+      @amount = amount
+      @source = source
+      @note = note
+    end
+
+    # Use set_transaction_isolation_level: false to avoid getting this exception:
+    #   ActiveRecord::TransactionIsolationError (cannot set isolation when joining a transaction)
+    def credit(set_transaction_isolation_level: true)
+      # Setting transaction isolation level in tests is problematic due to nested transactions :|
+      isolation_level = (::Rails.env.test? || !set_transaction_isolation_level) ? nil : :serializable
+
+      ActiveRecord::Base.transaction(isolation: isolation_level) do
+        return false unless valid?
+        unless crediting_transaction.valid?
+          copy_errors_from(crediting_transaction)
+          return false
+        end
+
+        crediting_transaction.save!
+        after_operation
+      end
+
+      true
+    end
+
+    private
+
+    attr_reader :account, :source, :amount, :note
+
+    def crediting_transaction
+      @crediting_transaction ||= ::SimpleWallet::Transaction::Credit.new(
+        account: account,
+        source: source,
+        pre_account_balance: account&.balance,
+        amount: amount,
+        note: note
+      )
+    end
+
+    def after_operation
+      update_accounts_balance
+    end
+
+    def update_accounts_balance
+      account.recalculate_balance!
+    end
+  end
+end

data/app/services/simple_wallet/account_debiting_service.rb

@@ -0,0 +1,81 @@
+module SimpleWallet
+  class AccountDebitingService < Service
+    validates :account, presence: true
+    validates :amount, presence: true, numericality: { only_integer: true, greater_than: 0 }
+    validate :account_has_sufficient_funds
+
+    def initialize(account:, amount: nil, source: nil, note: nil, up_to_account_balance: false)
+      @account = account
+      @amount = amount
+      @source = source
+      @up_to_account_balance = up_to_account_balance
+      @note = note
+    end
+
+    # Use set_transaction_isolation_level: false to avoid getting this exception:
+    #   ActiveRecord::TransactionIsolationError (cannot set isolation when joining a transaction)
+    def debit(set_transaction_isolation_level: true)
+      # Checking account's balance should be wrapped in a transaction:
+      # Setting transaction isolation level in tests is problematic due to nested transactions :|
+      isolation_level = (Rails.env.test? || !set_transaction_isolation_level) ? nil : :serializable
+
+      ActiveRecord::Base.transaction(isolation: isolation_level) do
+        return false unless valid?
+        unless debiting_transaction.valid?
+          copy_errors_from(debiting_transaction)
+          return false
+        end
+
+        debiting_transaction.save!
+        after_operation
+      end
+
+      true
+    end
+
+    private
+
+    attr_reader :account, :source, :amount, :note, :up_to_account_balance
+
+    def ensure_negative(amount_to_convert)
+      -(amount_to_convert.abs)
+    end
+
+    # If debiting up to account balance is allowed then we debit as much as we can.
+    # If not then we will return error on insufficient funds.
+    def actual_amount_to_debit
+      if up_to_account_balance
+        [ account.balance, amount ].min
+      else
+        amount
+      end
+    end
+
+    def account_has_sufficient_funds
+      return if errors.include?(:account)
+      return if errors.include?(:amount)
+
+      if account.balance < actual_amount_to_debit
+        errors.add(:amount, t(".exceeds_balance"))
+      end
+    end
+
+    def debiting_transaction
+      @debiting_transaction ||= ::SimpleWallet::Transaction::Debit.new(
+        account: account,
+        source: source,
+        pre_account_balance: account.balance,
+        amount: ensure_negative(actual_amount_to_debit),
+        note: note
+      )
+    end
+
+    def after_operation
+      update_accounts_balance
+    end
+
+    def update_accounts_balance
+      account.recalculate_balance!
+    end
+  end
+end

data/app/services/simple_wallet/service.rb

@@ -0,0 +1,35 @@
+module SimpleWallet
+  class Service
+    include ActiveModel::Validations
+
+    def errors_sentence
+      errors.full_messages.to_sentence
+    end
+
+    # Shamelessly stolen from:
+    # https://github.com/rails/rails/blob/fbe2433be6e052a1acac63c7faf287c52ed3c5ba/actionpack/lib/abstract_controller/translation.rb#L13
+    def t(key, **options)
+      if key.to_s.first == "."
+        path = self.class.name.underscore.tr("/", ".")
+        parent_class_path = self.class.superclass.name.underscore.tr("/", ".")
+        defaults = [ :"#{path}#{key}", :"#{parent_class_path}#{key}" ]
+        defaults << options[:default] if options[:default]
+        options[:default] = defaults.flatten
+        key = "#{path}#{key}"
+      end
+
+      options[:raise] = (Rails.env.development? || Rails.env.test?)
+      I18n.t(key, **options)
+    end
+
+    private
+
+    delegate :logger, to: :Rails
+
+    def copy_errors_from(errors_source)
+      errors_source.errors.each do |error|
+        errors.add(error.attribute, error.message)
+      end
+    end
+  end
+end

data/config/locales/simple_wallet.en.yml

@@ -0,0 +1,4 @@
+en:
+  simple_wallet:
+    account_debiting_service:
+      exceeds_balance: "exceeds available balance"

data/lib/simple_wallet/version.rb

@@ -1,3 +1,3 @@
 module SimpleWallet
-  VERSION = "0.1.1"
+  VERSION = "0.1.2"
 end