fintoc 0.1.0 → 1.0.0

data/lib/fintoc/v2/resources/account_verification.rb

@@ -0,0 +1,73 @@
+module Fintoc
+  module V2
+    class AccountVerification
+      attr_reader :id, :object, :status, :reason, :transfer_id, :counterparty, :mode, :receipt_url,
+                  :transaction_date
+
+      def initialize(
+        id:,
+        object:,
+        status:,
+        reason:,
+        transfer_id:,
+        counterparty:,
+        mode:,
+        receipt_url:,
+        transaction_date:,
+        client: nil,
+        **
+      )
+        @id = id
+        @object = object
+        @status = status
+        @reason = reason
+        @transfer_id = transfer_id
+        @counterparty = counterparty
+        @mode = mode
+        @receipt_url = receipt_url
+        @transaction_date = transaction_date
+        @client = client
+      end
+
+      def to_s
+        "🔍 Account Verification (#{@id}) - #{@status}"
+      end
+
+      def refresh
+        fresh_verification = @client.account_verifications.get(@id)
+        refresh_from_verification(fresh_verification)
+      end
+
+      def pending?
+        @status == 'pending'
+      end
+
+      def succeeded?
+        @status == 'succeeded'
+      end
+
+      def failed?
+        @status == 'failed'
+      end
+
+      private
+
+      def refresh_from_verification(verification)
+        unless verification.id == @id
+          raise ArgumentError, 'Account verification must be the same instance'
+        end
+
+        @object = verification.object
+        @status = verification.status
+        @reason = verification.reason
+        @transfer_id = verification.transfer_id
+        @counterparty = verification.counterparty
+        @mode = verification.mode
+        @receipt_url = verification.receipt_url
+        @transaction_date = verification.transaction_date
+
+        self
+      end
+    end
+  end
+end

data/lib/fintoc/v2/resources/entity.rb

@@ -0,0 +1,51 @@
+module Fintoc
+  module V2
+    class Entity
+      attr_reader :object, :mode, :id, :holder_name, :holder_id, :is_root
+
+      def initialize(
+        object:,
+        mode:,
+        id:,
+        holder_name:,
+        holder_id:,
+        is_root:,
+        client: nil,
+        **
+      )
+        @object = object
+        @mode = mode
+        @id = id
+        @holder_name = holder_name
+        @holder_id = holder_id
+        @is_root = is_root
+        @client = client
+      end
+
+      def to_s
+        "🏢 #{@holder_name} (#{@id})"
+      end
+
+      def refresh
+        fresh_entity = @client.entities.get(@id)
+        refresh_from_entity(fresh_entity)
+      end
+
+      private
+
+      def refresh_from_entity(entity)
+        unless entity.id == @id
+          raise ArgumentError, 'Entity must be the same instance'
+        end
+
+        @object = entity.object
+        @mode = entity.mode
+        @holder_name = entity.holder_name
+        @holder_id = entity.holder_id
+        @is_root = entity.is_root
+
+        self
+      end
+    end
+  end
+end

data/lib/fintoc/v2/resources/transfer.rb

@@ -0,0 +1,131 @@
+require 'money'
+
+module Fintoc
+  module V2
+    class Transfer
+      attr_reader :id, :object, :amount, :currency, :direction, :status, :mode,
+                  :post_date, :transaction_date, :comment, :reference_id, :receipt_url,
+                  :tracking_key, :return_reason, :counterparty, :account_number,
+                  :metadata, :created_at
+
+      def initialize( # rubocop:disable Metrics/MethodLength
+        id:,
+        object:,
+        amount:,
+        currency:,
+        status:,
+        mode:,
+        counterparty:,
+        direction: nil,
+        post_date: nil,
+        transaction_date: nil,
+        comment: nil,
+        reference_id: nil,
+        receipt_url: nil,
+        tracking_key: nil,
+        return_reason: nil,
+        account_number: nil,
+        metadata: {},
+        created_at: nil,
+        client: nil,
+        **
+      )
+        @id = id
+        @object = object
+        @amount = amount
+        @currency = currency
+        @direction = direction
+        @status = status
+        @mode = mode
+        @post_date = post_date
+        @transaction_date = transaction_date
+        @comment = comment
+        @reference_id = reference_id
+        @receipt_url = receipt_url
+        @tracking_key = tracking_key
+        @return_reason = return_reason
+        @counterparty = counterparty
+        @account_number = account_number
+        @metadata = metadata || {}
+        @created_at = created_at
+        @client = client
+      end
+
+      def to_s
+        amount_str = Money.from_cents(@amount, @currency).format
+        direction_icon = inbound? ? '⬇️' : '⬆️'
+        "#{direction_icon} #{amount_str} (#{@id}) - #{@status}"
+      end
+
+      def refresh
+        fresh_transfer = @client.transfers.get(@id)
+        refresh_from_transfer(fresh_transfer)
+      end
+
+      def return_transfer
+        returned_transfer = @client.transfers.return(@id)
+        refresh_from_transfer(returned_transfer)
+      end
+
+      def pending?
+        @status == 'pending'
+      end
+
+      def succeeded?
+        @status == 'succeeded'
+      end
+
+      def failed?
+        @status == 'failed'
+      end
+
+      def returned?
+        @status == 'returned'
+      end
+
+      def return_pending?
+        @status == 'return_pending'
+      end
+
+      def rejected?
+        @status == 'rejected'
+      end
+
+      def inbound?
+        @direction == 'inbound'
+      end
+
+      def outbound?
+        @direction == 'outbound'
+      end
+
+      private
+
+      def refresh_from_transfer(transfer) # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
+        unless transfer.id == @id
+          raise ArgumentError, 'Transfer must be the same instance'
+        end
+
+        @object = transfer.object
+        @amount = transfer.amount
+        @currency = transfer.currency
+        @direction = transfer.direction
+        @status = transfer.status
+        @mode = transfer.mode
+        @post_date = transfer.post_date
+        @transaction_date = transfer.transaction_date
+        @comment = transfer.comment
+        @reference_id = transfer.reference_id
+        @receipt_url = transfer.receipt_url
+        @tracking_key = transfer.tracking_key
+        @return_reason = transfer.return_reason
+        @counterparty = transfer.counterparty
+        @account_number = transfer.account_number
+        @metadata = transfer.metadata
+        @created_at = transfer.created_at
+
+        self
+      end
+    end
+  end
+end

data/lib/fintoc/version.rb

@@ -1,3 +1,3 @@
 module Fintoc
-  VERSION = "0.1.0"
+  VERSION = '1.0.0'
 end

data/lib/fintoc/webhook_signature.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+require 'openssl'
+require 'time'
+require 'fintoc/errors'
+
+module Fintoc
+  class WebhookSignature
+    EXPECTED_SCHEME = 'v1'
+    DEFAULT_TOLERANCE = 300 # 5 minutes
+
+    class << self
+      def verify_header(payload, header, secret, tolerance = DEFAULT_TOLERANCE) # rubocop:disable Naming/PredicateMethod
+        timestamp, signatures = parse_header(header)
+
+        verify_timestamp(timestamp, tolerance) if tolerance
+
+        expected_signature = compute_signature(payload, timestamp, secret)
+        signature = signatures[EXPECTED_SCHEME]
+
+        if signature.nil? || signature.empty? # rubocop:disable Rails/Blank
+          raise Fintoc::Errors::WebhookSignatureError.new("No #{EXPECTED_SCHEME} signature found")
+        end
+
+        unless same_signatures?(signature, expected_signature)
+          raise Fintoc::Errors::WebhookSignatureError.new('Signature mismatch')
+        end
+
+        true
+      end
+
+      def compute_signature(payload, timestamp, secret)
+        signed_payload = "#{timestamp}.#{payload}"
+        OpenSSL::HMAC.hexdigest(OpenSSL::Digest.new('sha256'), secret, signed_payload)
+      end
+
+      private
+
+      def parse_header(header)
+        elements = header.split(',').map(&:strip)
+        pairs = elements.map { |element| element.split('=', 2).map(&:strip) }
+        pairs = pairs.to_h
+
+        if pairs['t'].nil? || pairs['t'].empty? # rubocop:disable Rails/Blank
+          raise Fintoc::Errors::WebhookSignatureError.new('Missing timestamp in header')
+        end
+
+        timestamp = pairs['t'].to_i
+        signatures = pairs.except('t')
+
+        [timestamp, signatures]
+      rescue StandardError => e
+        raise Fintoc::Errors::WebhookSignatureError.new(
+          'Unable to extract timestamp and signatures from header'
+        ), cause: e
+      end
+
+      def verify_timestamp(timestamp, tolerance)
+        now = Time.now.to_i
+
+        if timestamp < (now - tolerance)
+          raise Fintoc::Errors::WebhookSignatureError.new(
+            "Timestamp outside the tolerance zone (#{timestamp})"
+          )
+        end
+      end
+
+      def same_signatures?(signature, expected_signature)
+        OpenSSL.secure_compare(expected_signature, signature)
+      end
+    end
+  end
+end

data/lib/fintoc.rb

@@ -1,6 +1,9 @@
 require 'fintoc/version'
 require 'fintoc/errors'
 require 'fintoc/client'
+require 'fintoc/webhook_signature'
+
+require 'config/initializers/money'
 
 module Fintoc
 end

data/lib/tasks/simplecov_config.rb

@@ -0,0 +1,19 @@
+if ENV['COVERAGE'] == 'true'
+  require 'simplecov'
+  require 'simplecov_text_formatter'
+  require 'simplecov_linter_formatter'
+
+  SimpleCov.start do
+    formatter SimpleCov::Formatter::MultiFormatter.new([SimpleCov::Formatter::HTMLFormatter])
+
+    add_filter '/vendor/'
+    add_filter '/lib/fintoc.rb'
+    add_filter '/lib/fintoc/version.rb'
+    add_filter '/lib/tasks/simplecov_config.rb'
+
+    track_files 'lib/**/*.rb'
+
+    minimum_coverage 100
+    minimum_coverage_by_file 100
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fintoc
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 1.0.0
 platform: ruby
 authors:
 - Juan Ca Sardin
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2021-01-19 00:00:00.000000000 Z
+date: 2025-09-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: http
@@ -25,7 +25,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: tabulate
+  name: money-rails
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -39,83 +39,13 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rspec
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.0'
-- !ruby/object:Gem::Dependency
-  name: rubocop
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.81.0
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.81.0
-- !ruby/object:Gem::Dependency
-  name: rubocop-performance
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: rubocop-rspec
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: vcr
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: webmock
+  name: tabulate
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-  type: :development
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
@@ -129,6 +59,8 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".github/pull_request_template.md"
+- ".github/workflows/ci.yml"
 - ".gitignore"
 - ".rspec"
 - ".rubocop.yml"
@@ -142,23 +74,43 @@ files:
 - bin/console
 - bin/setup
 - fintoc.gemspec
+- lib/config/initializers/money.rb
 - lib/fintoc.rb
+- lib/fintoc/base_client.rb
 - lib/fintoc/client.rb
 - lib/fintoc/constants.rb
 - lib/fintoc/errors.rb
-- lib/fintoc/resources/account.rb
-- lib/fintoc/resources/balance.rb
-- lib/fintoc/resources/institution.rb
-- lib/fintoc/resources/link.rb
-- lib/fintoc/resources/movement.rb
-- lib/fintoc/resources/transfer_account.rb
+- lib/fintoc/jws.rb
 - lib/fintoc/utils.rb
+- lib/fintoc/v1/client/client.rb
+- lib/fintoc/v1/managers/links_manager.rb
+- lib/fintoc/v1/resources/account.rb
+- lib/fintoc/v1/resources/balance.rb
+- lib/fintoc/v1/resources/institution.rb
+- lib/fintoc/v1/resources/link.rb
+- lib/fintoc/v1/resources/movement.rb
+- lib/fintoc/v1/resources/transfer_account.rb
+- lib/fintoc/v2/client/client.rb
+- lib/fintoc/v2/managers/account_numbers_manager.rb
+- lib/fintoc/v2/managers/account_verifications_manager.rb
+- lib/fintoc/v2/managers/accounts_manager.rb
+- lib/fintoc/v2/managers/entities_manager.rb
+- lib/fintoc/v2/managers/simulate_manager.rb
+- lib/fintoc/v2/managers/transfers_manager.rb
+- lib/fintoc/v2/resources/account.rb
+- lib/fintoc/v2/resources/account_number.rb
+- lib/fintoc/v2/resources/account_verification.rb
+- lib/fintoc/v2/resources/entity.rb
+- lib/fintoc/v2/resources/transfer.rb
 - lib/fintoc/version.rb
+- lib/fintoc/webhook_signature.rb
+- lib/tasks/simplecov_config.rb
 homepage: https://github.com/fintoc-com/fintoc-ruby
 licenses: []
 metadata:
   homepage_uri: https://github.com/fintoc-com/fintoc-ruby
   source_code_uri: https://github.com/fintoc-com/fintoc-ruby
+  rubygems_mfa_required: 'true'
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -167,14 +119,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.3.0
+      version: 3.2.2
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.0.3.1
 signing_key: 
 specification_version: 4
 summary: The official Ruby client for the Fintoc API.

data/lib/fintoc/resources/account.rb

@@ -1,84 +0,0 @@
-require 'tabulate'
-require 'fintoc/utils'
-require 'fintoc/resources/movement'
-require 'fintoc/resources/balance'
-
-module Fintoc
-  class Account
-    include Utils
-    attr_reader :id, :name, :holder_name, :currency, :type, :refreshed_at,
-                :official_name, :number, :holder_id, :balance, :movements
-    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::Balance.new(**balance)
-      @movements = movements || []
-      @client = client
-    end
-
-    def update_balance
-      @balance = Fintoc::Balance.new(**get_account[:balance])
-    end
-
-    def get_movements(**params)
-      _get_movements(**params).lazy.map { |movement| Fintoc::Movement.new(**movement) }
-    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
-      headers = ['#', 'Amount', 'Currency', 'Description', 'Date']
-      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.call("accounts/#{@id}")
-    end
-
-    def _get_movements(**params)
-      first = @client.get.call("accounts/#{@id}/movements", **params)
-      return first if params.empty?
-
-      first + Utils.flatten(@client.fetch_next)
-    end
-  end
-end

data/lib/fintoc/resources/balance.rb

@@ -1,24 +0,0 @@
-# frozen_string_literal: true
-
-module Fintoc
-  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
-      "<Balance #{@available} (#{@current})>"
-    end
-  end
-end

data/lib/fintoc/resources/institution.rb

@@ -1,18 +0,0 @@
-module Fintoc
-  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
-      "<Institution #{@name}>"
-    end
-  end
-end