fintoc 0.1.0 → 1.1.0

data/lib/fintoc/v1/resources/account.rb

@@ -0,0 +1,95 @@
+require 'tabulate'
+require 'fintoc/utils'
+require 'fintoc/v1/resources/movement'
+require 'fintoc/v1/resources/balance'
+
+module Fintoc
+  module V1
+    class Account
+      include Utils
+
+      attr_reader :id, :name, :holder_name, :currency, :type, :refreshed_at,
+                  :official_name, :number, :holder_id, :balance, :movements
+
+      HEADERS = ['#', 'Amount', 'Currency', 'Description', 'Date'].freeze
+
+      def initialize(
+        id:,
+        name:,
+        official_name:,
+        number:,
+        holder_id:,
+        holder_name:,
+        type:,
+        currency:,
+        refreshed_at: nil,
+        balance: nil,
+        movements: nil,
+        client: nil,
+        **
+      )
+        @id = id
+        @name = name
+        @official_name = official_name
+        @number = number
+        @holder_id = holder_id
+        @holder_name = holder_name
+        @type = type
+        @currency = currency
+        @refreshed_at = DateTime.iso8601(refreshed_at) if refreshed_at
+        @balance = Fintoc::V1::Balance.new(**balance)
+        @movements = movements || []
+        @client = client
+      end
+
+      def update_balance
+        @balance = Fintoc::V1::Balance.new(**get_account[:balance])
+      end
+
+      def get_movements(**params)
+        _get_movements(**params).lazy.map do
+          |movement| Fintoc::V1::Movement.new(**movement, client: @client)
+        end
+      end
+
+      def update_movements(**params)
+        @movements += get_movements(**params).to_a
+        @movements = @movements.uniq.sort_by(&:post_date)
+      end
+
+      def show_movements(rows = 5)
+        puts("This account has #{Utils.pluralize(@movements.size, 'movement')}.")
+
+        return unless @movements.any?
+
+        movements =
+          @movements
+          .to_a
+          .slice(0, rows)
+          .map.with_index do |mov, index|
+            [index + 1, mov.amount, mov.currency, mov.description, mov.locale_date]
+          end
+
+        puts
+        puts tabulate(HEADERS, movements, indent: 4, style: 'fancy')
+      end
+
+      def to_s
+        "💰 #{@holder_name}’s #{@name} #{@balance}"
+      end
+
+      private
+
+      def get_account
+        @client.get(version: :v1).call("accounts/#{@id}")
+      end
+
+      def _get_movements(**params)
+        first = @client.get(version: :v1).call("accounts/#{@id}/movements", **params)
+        return first if params.empty?
+
+        first + Utils.flatten(@client.fetch_next)
+      end
+    end
+  end
+end

data/lib/fintoc/v1/resources/balance.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Fintoc
+  module V1
+    class Balance
+      attr_reader :available, :current, :limit
+
+      def initialize(available:, current:, limit:)
+        @available = available
+        @current = current
+        @limit = limit
+      end
+
+      def id
+        object_id
+      end
+
+      def to_s
+        "#{@available} (#{@current})"
+      end
+
+      def inspect
+        "<Fintoc::V1::Balance #{@available} (#{@current})>"
+      end
+    end
+  end
+end

data/lib/fintoc/v1/resources/institution.rb

@@ -0,0 +1,21 @@
+module Fintoc
+  module V1
+    class Institution
+      attr_reader :id, :name, :country
+
+      def initialize(id:, name:, country:, **)
+        @id = id
+        @name = name
+        @country = country
+      end
+
+      def to_s
+        "🏦 #{@name}"
+      end
+
+      def inspect
+        "<Fintoc::V1::Institution #{@name}>"
+      end
+    end
+  end
+end

data/lib/fintoc/v1/resources/link.rb

@@ -0,0 +1,85 @@
+require 'date'
+require 'tabulate'
+require 'fintoc/utils'
+require 'fintoc/v1/resources/account'
+require 'fintoc/v1/resources/institution'
+
+module Fintoc
+  module V1
+    class Link
+      attr_reader :id, :username, :holder_type, :institution, :created_at, :mode,
+                  :accounts, :link_token
+
+      include Utils
+
+      def initialize(
+        id:,
+        username:,
+        holder_type:,
+        institution:,
+        created_at:,
+        mode:,
+        accounts: nil,
+        link_token: nil,
+        client: nil,
+        **
+      )
+        @id = id
+        @username = username
+        @holder_type = holder_type
+        @institution = Fintoc::V1::Institution.new(**institution)
+        @created_at = Date.iso8601(created_at)
+        @mode = mode
+        @accounts = if accounts.nil?
+                      []
+                    else
+                      accounts.map { |data| Fintoc::V1::Account.new(**data, client:) }
+                    end
+        @token = link_token
+        @client = client
+      end
+
+      def find_all(**kwargs)
+        raise 'You must provide *exactly one* account field.' if kwargs.size != 1
+
+        field, value = kwargs.to_a.first
+        @accounts.select do |account|
+          account.send(field.to_sym) == value
+        end
+      end
+
+      def find(**)
+        results = find_all(**)
+        results.any? ? results.first : nil
+      end
+
+      def show_accounts(rows = 5)
+        puts "This links has #{Utils.pluralize(@accounts.size, 'account')}"
+        return unless @accounts.any?
+
+        accounts = @accounts.to_a.slice(0, rows)
+                            .map.with_index do |acc, index|
+                              [index + 1, acc.name, acc.holder_name, acc.currency]
+                            end
+        headers = ['#', 'Name', 'Holder', 'Currency']
+        puts
+        puts tabulate(headers, accounts, indent: 4, style: 'fancy')
+      end
+
+      def update_accounts
+        @accounts.each do |account|
+          account.update_balance
+          account.update_movements
+        end
+      end
+
+      def delete
+        @client.links.delete(@id)
+      end
+
+      def to_s
+        "<#{@username}@#{@institution.name}> 🔗 <Fintoc>"
+      end
+    end
+  end
+end

data/lib/fintoc/v1/resources/movement.rb

@@ -0,0 +1,62 @@
+require 'date'
+require 'fintoc/v1/resources/transfer_account'
+
+module Fintoc
+  module V1
+    class Movement
+      attr_reader :id, :amount, :currency, :description, :reference_id,
+                  :post_date, :transaction_date, :type, :recipient_account,
+                  :sender_account, :account, :comment
+
+      def initialize(
+        id:,
+        amount:,
+        currency:,
+        description:,
+        post_date:,
+        transaction_date:,
+        type:,
+        reference_id:,
+        recipient_account:,
+        sender_account:,
+        comment:,
+        client: nil,
+        **
+      )
+        @id = id
+        @amount = amount
+        @currency = currency
+        @description = description
+        @post_date = DateTime.iso8601(post_date)
+        @transaction_date = DateTime.iso8601(transaction_date) if transaction_date
+        @type = type
+        @reference_id = reference_id
+        @recipient_account =
+          if recipient_account
+            Fintoc::V1::TransferAccount.new(**recipient_account)
+          end
+        @sender_account = Fintoc::V1::TransferAccount.new(**sender_account) if sender_account
+        @comment = comment
+        @client = client
+      end
+
+      def ==(other)
+        @id == other.id
+      end
+
+      alias eql? ==
+
+      def hash
+        @id.hash
+      end
+
+      def locale_date
+        @post_date.strftime('%x')
+      end
+
+      def to_s
+        "#{@amount} (#{@description} @ #{locale_date})"
+      end
+    end
+  end
+end

data/lib/fintoc/v1/resources/transfer_account.rb

@@ -0,0 +1,24 @@
+require 'fintoc/v1/resources/institution'
+
+module Fintoc
+  module V1
+    class TransferAccount
+      attr_reader :holder_id, :holder_name, :number, :institution
+
+      def initialize(holder_id:, holder_name:, number:, institution:, **)
+        @holder_id = holder_id
+        @holder_name = holder_name
+        @number = number
+        @institution = institution && Fintoc::V1::Institution.new(**institution)
+      end
+
+      def id
+        object_id
+      end
+
+      def to_s
+        @holder_id.to_s
+      end
+    end
+  end
+end

data/lib/fintoc/v2/client/client.rb

@@ -0,0 +1,37 @@
+require 'fintoc/base_client'
+require 'fintoc/v2/managers/entities_manager'
+require 'fintoc/v2/managers/accounts_manager'
+require 'fintoc/v2/managers/account_numbers_manager'
+require 'fintoc/v2/managers/transfers_manager'
+require 'fintoc/v2/managers/simulate_manager'
+require 'fintoc/v2/managers/account_verifications_manager'
+
+module Fintoc
+  module V2
+    class Client < BaseClient
+      def entities
+        @entities ||= Managers::EntitiesManager.new(self)
+      end
+
+      def accounts
+        @accounts ||= Managers::AccountsManager.new(self)
+      end
+
+      def account_numbers
+        @account_numbers ||= Managers::AccountNumbersManager.new(self)
+      end
+
+      def transfers
+        @transfers ||= Managers::TransfersManager.new(self)
+      end
+
+      def simulate
+        @simulate ||= Managers::SimulateManager.new(self)
+      end
+
+      def account_verifications
+        @account_verifications ||= Managers::AccountVerificationsManager.new(self)
+      end
+    end
+  end
+end

data/lib/fintoc/v2/managers/account_numbers_manager.rb

@@ -0,0 +1,64 @@
+require 'fintoc/v2/resources/account_number'
+
+module Fintoc
+  module V2
+    module Managers
+      class AccountNumbersManager
+        def initialize(client)
+          @client = client
+        end
+
+        def create(account_id:, description: nil, metadata: nil, idempotency_key: nil, **params)
+          data = _create_account_number(
+            account_id:, description:, metadata:, idempotency_key:, **params
+          )
+          build_account_number(data)
+        end
+
+        def get(account_number_id)
+          data = _get_account_number(account_number_id)
+          build_account_number(data)
+        end
+
+        def list(**params)
+          _list_account_numbers(**params).map { |data| build_account_number(data) }
+        end
+
+        def update(account_number_id, idempotency_key: nil, **params)
+          data = _update_account_number(account_number_id, idempotency_key:, **params)
+          build_account_number(data)
+        end
+
+        private
+
+        def _create_account_number(
+          account_id:, description: nil, metadata: nil, idempotency_key: nil, **params
+        )
+          request_params = { account_id: }
+          request_params[:description] = description if description
+          request_params[:metadata] = metadata if metadata
+          request_params.merge!(params)
+
+          @client.post(version: :v2, idempotency_key:).call('account_numbers', **request_params)
+        end
+
+        def _get_account_number(account_number_id)
+          @client.get(version: :v2).call("account_numbers/#{account_number_id}")
+        end
+
+        def _list_account_numbers(**params)
+          @client.get(version: :v2).call('account_numbers', **params)
+        end
+
+        def _update_account_number(account_number_id, idempotency_key: nil, **params)
+          @client.patch(version: :v2, idempotency_key:)
+                 .call("account_numbers/#{account_number_id}", **params)
+        end
+
+        def build_account_number(data)
+          Fintoc::V2::AccountNumber.new(**data, client: @client)
+        end
+      end
+    end
+  end
+end

data/lib/fintoc/v2/managers/account_verifications_manager.rb

@@ -0,0 +1,46 @@
+require 'fintoc/v2/resources/account_verification'
+
+module Fintoc
+  module V2
+    module Managers
+      class AccountVerificationsManager
+        def initialize(client)
+          @client = client
+        end
+
+        def create(account_number:, idempotency_key: nil)
+          data = _create_account_verification(account_number:, idempotency_key:)
+          build_account_verification(data)
+        end
+
+        def get(account_verification_id)
+          data = _get_account_verification(account_verification_id)
+          build_account_verification(data)
+        end
+
+        def list(**params)
+          _list_account_verifications(**params).map { |data| build_account_verification(data) }
+        end
+
+        private
+
+        def _create_account_verification(account_number:, idempotency_key: nil)
+          @client.post(version: :v2, use_jws: true, idempotency_key:)
+                 .call('account_verifications', account_number:)
+        end
+
+        def _get_account_verification(account_verification_id)
+          @client.get(version: :v2).call("account_verifications/#{account_verification_id}")
+        end
+
+        def _list_account_verifications(**params)
+          @client.get(version: :v2).call('account_verifications', **params)
+        end
+
+        def build_account_verification(data)
+          Fintoc::V2::AccountVerification.new(**data, client: @client)
+        end
+      end
+    end
+  end
+end

data/lib/fintoc/v2/managers/accounts_manager.rb

@@ -0,0 +1,55 @@
+require 'fintoc/v2/resources/account'
+
+module Fintoc
+  module V2
+    module Managers
+      class AccountsManager
+        def initialize(client)
+          @client = client
+        end
+
+        def create(entity_id:, description:, idempotency_key: nil, **params)
+          data = _create_account(entity_id:, description:, idempotency_key:, **params)
+          build_account(data)
+        end
+
+        def get(account_id)
+          data = _get_account(account_id)
+          build_account(data)
+        end
+
+        def list(**params)
+          _list_accounts(**params).map { |data| build_account(data) }
+        end
+
+        def update(account_id, idempotency_key: nil, **params)
+          data = _update_account(account_id, idempotency_key:, **params)
+          build_account(data)
+        end
+
+        private
+
+        def _create_account(entity_id:, description:, idempotency_key: nil, **params)
+          @client.post(version: :v2, idempotency_key:)
+                 .call('accounts', entity_id:, description:, **params)
+        end
+
+        def _get_account(account_id)
+          @client.get(version: :v2).call("accounts/#{account_id}")
+        end
+
+        def _list_accounts(**params)
+          @client.get(version: :v2).call('accounts', **params)
+        end
+
+        def _update_account(account_id, idempotency_key: nil, **params)
+          @client.patch(version: :v2, idempotency_key:).call("accounts/#{account_id}", **params)
+        end
+
+        def build_account(data)
+          Fintoc::V2::Account.new(**data, client: @client)
+        end
+      end
+    end
+  end
+end

data/lib/fintoc/v2/managers/entities_manager.rb

@@ -0,0 +1,36 @@
+require 'fintoc/v2/resources/entity'
+
+module Fintoc
+  module V2
+    module Managers
+      class EntitiesManager
+        def initialize(client)
+          @client = client
+        end
+
+        def get(entity_id)
+          data = _get_entity(entity_id)
+          build_entity(data)
+        end
+
+        def list(**params)
+          _list_entities(**params).map { |data| build_entity(data) }
+        end
+
+        private
+
+        def _get_entity(entity_id)
+          @client.get(version: :v2).call("entities/#{entity_id}")
+        end
+
+        def _list_entities(**params)
+          @client.get(version: :v2).call('entities', **params)
+        end
+
+        def build_entity(data)
+          Fintoc::V2::Entity.new(**data, client: @client)
+        end
+      end
+    end
+  end
+end

data/lib/fintoc/v2/managers/simulate_manager.rb

@@ -0,0 +1,32 @@
+require 'fintoc/v2/resources/transfer'
+
+module Fintoc
+  module V2
+    module Managers
+      class SimulateManager
+        def initialize(client)
+          @client = client
+        end
+
+        def receive_transfer(account_number_id:, amount:, currency:, idempotency_key: nil)
+          data = _simulate_receive_transfer(
+            account_number_id:, amount:, currency:, idempotency_key:
+          )
+          build_transfer(data)
+        end
+
+        private
+
+        def _simulate_receive_transfer(account_number_id:, amount:, currency:, idempotency_key: nil)
+          @client
+            .post(version: :v2, idempotency_key:)
+            .call('simulate/receive_transfer', account_number_id:, amount:, currency:)
+        end
+
+        def build_transfer(data)
+          Fintoc::V2::Transfer.new(**data, client: @client)
+        end
+      end
+    end
+  end
+end

data/lib/fintoc/v2/managers/transfers_manager.rb

@@ -0,0 +1,61 @@
+require 'fintoc/v2/resources/transfer'
+
+module Fintoc
+  module V2
+    module Managers
+      class TransfersManager
+        def initialize(client)
+          @client = client
+        end
+
+        def create(amount:, currency:, account_id:, counterparty:, idempotency_key: nil, **params)
+          data = _create_transfer(
+            amount:, currency:, account_id:, counterparty:, idempotency_key:, **params
+          )
+          build_transfer(data)
+        end
+
+        def get(transfer_id)
+          data = _get_transfer(transfer_id)
+          build_transfer(data)
+        end
+
+        def list(**params)
+          _list_transfers(**params).map { |data| build_transfer(data) }
+        end
+
+        def return(transfer_id, idempotency_key: nil)
+          data = _return_transfer(transfer_id, idempotency_key:)
+          build_transfer(data)
+        end
+
+        private
+
+        def _create_transfer(
+          amount:, currency:, account_id:, counterparty:, idempotency_key: nil, **params
+        )
+          @client
+            .post(version: :v2, use_jws: true, idempotency_key:)
+            .call('transfers', amount:, currency:, account_id:, counterparty:, **params)
+        end
+
+        def _get_transfer(transfer_id)
+          @client.get(version: :v2).call("transfers/#{transfer_id}")
+        end
+
+        def _list_transfers(**params)
+          @client.get(version: :v2).call('transfers', **params)
+        end
+
+        def _return_transfer(transfer_id, idempotency_key: nil)
+          @client.post(version: :v2, use_jws: true, idempotency_key:)
+                 .call('transfers/return', transfer_id:)
+        end
+
+        def build_transfer(data)
+          Fintoc::V2::Transfer.new(**data, client: @client)
+        end
+      end
+    end
+  end
+end