bridge_bankin 0.1.0

data/lib/bridge_bankin/api/error.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module BridgeBankin
+  module API
+    class Error < StandardError
+      def initialize(code, response_body = {})
+        @payload = response_body
+        @code = code
+        @type = payload[:type]
+        @documentation_url = payload[:documentation_url]
+
+        super(payload[:message])
+      end
+
+      attr_reader :payload, :code, :type, :documentation_url
+    end
+
+    class BadRequestError < Error; end
+
+    class UnauthorizedError < Error; end
+
+    class ForbiddenError < Error; end
+
+    class NotFoundError < Error; end
+
+    class ConflictError < Error; end
+
+    class UnsupportedMediaTypeError < Error; end
+
+    class UnprocessableEntityError < Error; end
+
+    class TooManyRequestsError < Error; end
+
+    class InternalServerError < Error; end
+  end
+end

data/lib/bridge_bankin/api/resource.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module BridgeBankin
+  module API
+    module Resource
+      def protected_resource(access_token)
+        api_client.access_token = access_token
+        yield
+      end
+
+      private
+
+      def api_client
+        @api_client ||= API::Client.new
+      end
+    end
+  end
+end

data/lib/bridge_bankin/authorization.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require "time"
+
+module BridgeBankin
+  class Authorization
+    attr_reader :access_token, :expires_at
+
+    def initialize(access_token, expires_at)
+      @access_token = access_token
+      @expires_at = Time.parse(expires_at)
+    end
+
+    class << self
+      include API::Resource
+
+      def generate_token(email:, password:)
+        response = api_client.post("/v2/authenticate", email: email, password: password)
+        new(response[:access_token], response[:expires_at])
+      end
+    end
+  end
+end

data/lib/bridge_bankin/bank.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module BridgeBankin
+  class Bank < BridgeObject
+    RESOURCE_TYPE = "bank"
+
+    class << self
+      include API::Resource
+
+      def list(**params)
+        data = api_client.get("/v2/banks", params)
+        convert_to_bridge_object(data)
+      end
+
+      def find(id:, **params)
+        data = api_client.get("/v2/banks/#{id}", params)
+        convert_to_bridge_object(data)
+      end
+    end
+  end
+end

data/lib/bridge_bankin/bridge_object.rb

@@ -0,0 +1,105 @@
+# frozen_string_literal: true
+
+module BridgeBankin
+  class BridgeObject
+    HIDDEN_ATTRIBUTES = %i[resource_type resource_uri].freeze
+
+    def initialize(**attrs)
+      define_instance_variables(attrs)
+    end
+
+    class << self
+      def convert_to_bridge_object(**data)
+        if data[:resources]
+          data[:resources].map { |resource| convert_to_bridge_object(resource) }
+        elsif data.is_a?(Array)
+          data.map { |val| convert_to_bridge_object(val) }
+        else
+          object_from_resource_type(data)
+        end
+      end
+
+      private
+
+      def object_classes
+        @object_classes ||= ObjectTypes.resource_types_to_classes
+      end
+
+      def object_from_resource_type(data)
+        object_classes.fetch(data[:resource_type], BridgeObject).new(data)
+      end
+    end
+
+    def to_hash
+      instance_variables.each_with_object({}) do |var, hash|
+        hash[var.to_s.delete("@")] =
+          case instance_variable_get(var)
+          when BridgeObject
+            instance_variable_get(var).to_hash
+          when Array
+            instance_variable_get(var).map { |val| val.is_a?(BridgeObject) ? val.to_hash : val }
+          else
+            instance_variable_get(var)
+          end
+      end.transform_keys!(&:to_sym)
+    end
+
+    def to_json(*_args)
+      to_hash.to_json
+    end
+
+    def ==(other)
+      other.is_a?(BridgeObject) && to_hash == other.to_hash
+    end
+
+    private
+
+    def define_instance_variables(attrs)
+      attrs.each do |key, value|
+        next if HIDDEN_ATTRIBUTES.include?(key)
+
+        handle_values_types(key, value) do |parsed_value|
+          instance_variable_set("@#{key}".to_sym, parsed_value)
+          self.class.class_eval { attr_reader key }
+        end
+      end
+    end
+
+    def handle_values_types(key, value)
+      yield(
+        case value
+        when Array
+          handle_array_values(value)
+        when Hash
+          handle_hash_values(value)
+        when String
+          handle_time_values(key, value)
+        else
+          value
+        end
+      )
+    end
+
+    def handle_array_values(array)
+      array.map do |value|
+        next value unless value.is_a?(Hash)
+
+        handle_hash_values(value)
+      end
+    end
+
+    def handle_hash_values(hash)
+      self.class.convert_to_bridge_object(hash)
+    end
+
+    def handle_time_values(key, value)
+      if key == :date
+        Date.parse(value)
+      elsif key.to_s.match?(/_at$/)
+        Time.parse(value)
+      else
+        value
+      end
+    end
+  end
+end

data/lib/bridge_bankin/category.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module BridgeBankin
+  class Category < BridgeObject
+    RESOURCE_TYPE = "category"
+
+    class << self
+      include API::Resource
+
+      def list(**params)
+        data = api_client.get("/v2/categories", params)
+        convert_to_bridge_object(data)
+      end
+
+      def find(id:, **params)
+        data = api_client.get("/v2/categories/#{id}", params)
+        convert_to_bridge_object(data)
+      end
+    end
+  end
+end

data/lib/bridge_bankin/configuration.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module BridgeBankin
+  def self.configuration
+    @configuration ||= Configuration.new
+  end
+
+  def self.configuration=(config)
+    @configuration = config
+  end
+
+  def self.configure
+    yield configuration
+  end
+
+  class Configuration
+    attr_reader :api_base_url, :api_version
+    attr_accessor :api_client_id, :api_client_secret
+
+    def initialize
+      @api_base_url = "https://sync.bankin.com"
+      @api_version = "2019-02-18"
+      @api_client_id = "d16099aec29e445dbb31cf3966b3821e"
+      @api_client_secret = "HEb73vHEGB4Hunv5OMXFUDNIgNonYJ89YaHHRSyidVgCPbCtFWqtED5fZYObA0lm"
+    end
+  end
+end

data/lib/bridge_bankin/connect.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module BridgeBankin
+  class Connect < BridgeObject
+    class << self
+      include API::Resource
+
+      def connect_item(access_token:, **params)
+        protected_resource(access_token) do
+          data = api_client.get("/v2/connect/items/add/url", params)
+          convert_to_bridge_object(data)
+        end
+      end
+
+      def connect_item_with_iban(access_token:, **params)
+        protected_resource(access_token) do
+          data = api_client.post("/v2/connect/items/add/url", params)
+          convert_to_bridge_object(data)
+        end
+      end
+
+      def edit_item(access_token:, **params)
+        protected_resource(access_token) do
+          data = api_client.get("/v2/connect/items/edit/url", params)
+          convert_to_bridge_object(data)
+        end
+      end
+
+      def item_sync(access_token:, **params)
+        protected_resource(access_token) do
+          data = api_client.get("/v2/connect/items/sync", params)
+          convert_to_bridge_object(data)
+        end
+      end
+
+      def validate_email(access_token:, **params)
+        protected_resource(access_token) do
+          data = api_client.get("/v2/connect/users/email/confirmation/url", params)
+          convert_to_bridge_object(data)
+        end
+      end
+
+      def validate_pro_items(access_token:, **params)
+        protected_resource(access_token) do
+          data = api_client.get("/v2/connect/items/pro/confirmation/url", params)
+          convert_to_bridge_object(data)
+        end
+      end
+    end
+  end
+end

data/lib/bridge_bankin/insight.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module BridgeBankin
+  class Insight < BridgeObject
+    class << self
+      include API::Resource
+
+      def categories_insights(access_token:, **params)
+        protected_resource(access_token) do
+          data = api_client.get("/v2/insights/category", params)
+          convert_to_bridge_object(data)
+        end
+      end
+    end
+  end
+end

data/lib/bridge_bankin/item.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module BridgeBankin
+  class Item < BridgeObject
+    RESOURCE_TYPE = "item"
+
+    # TODO: Add support of item statuses
+
+    class << self
+      include API::Resource
+
+      def list(access_token:, **params)
+        protected_resource(access_token) do
+          data = api_client.get("/v2/items", params)
+          convert_to_bridge_object(data)
+        end
+      end
+
+      def find(id:, access_token:, **params)
+        protected_resource(access_token) do
+          data = api_client.get("/v2/items/#{id}", params)
+          convert_to_bridge_object(data)
+        end
+      end
+
+      def refresh(id:, access_token:, **params)
+        protected_resource(access_token) do
+          data = api_client.post("/v2/items/#{id}/refresh", params)
+          convert_to_bridge_object(data)
+        end
+      end
+
+      def refresh_status(id:, access_token:, **params)
+        protected_resource(access_token) do
+          data = api_client.get("/v2/items/#{id}/refresh/status", params)
+          convert_to_bridge_object(data)
+        end
+      end
+
+      def delete(id:, access_token:, **params)
+        protected_resource(access_token) do
+          data = api_client.delete("/v2/items/#{id}", params)
+          convert_to_bridge_object(data)
+        end
+      end
+    end
+  end
+end

data/lib/bridge_bankin/object_types.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module BridgeBankin
+  module ObjectTypes
+    def self.resource_types_to_classes
+      {
+        Account::RESOURCE_TYPE => Account,
+        Bank::RESOURCE_TYPE => Bank,
+        Category::RESOURCE_TYPE => Category,
+        Item::RESOURCE_TYPE => Item,
+        Stock::RESOURCE_TYPE => Stock,
+        Transaction::RESOURCE_TYPE => Transaction,
+        Transfer::RESOURCE_TYPE => Transfer,
+        User::RESOURCE_TYPE => User
+      }
+    end
+  end
+end

data/lib/bridge_bankin/resources.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require "bridge_bankin/authorization"
+require "bridge_bankin/account"
+require "bridge_bankin/category"
+require "bridge_bankin/stock"
+require "bridge_bankin/bank"
+require "bridge_bankin/user"
+require "bridge_bankin/connect"
+require "bridge_bankin/item"
+require "bridge_bankin/transaction"
+require "bridge_bankin/transfer"
+require "bridge_bankin/insight"

data/lib/bridge_bankin/stock.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module BridgeBankin
+  class Stock < BridgeObject
+    RESOURCE_TYPE = "stock"
+
+    class << self
+      include API::Resource
+
+      def list(**params)
+        data = api_client.get("/v2/stocks", params)
+        convert_to_bridge_object(data)
+      end
+
+      def list_updated(**params)
+        data = api_client.get("/v2/stocks/updated", params)
+        convert_to_bridge_object(data)
+      end
+
+      def find(id:, **params)
+        data = api_client.get("/v2/stocks/#{id}", params)
+        convert_to_bridge_object(data)
+      end
+    end
+  end
+end

data/lib/bridge_bankin/transaction.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module BridgeBankin
+  class Transaction < BridgeObject
+    RESOURCE_TYPE = "transaction"
+
+    class << self
+      include API::Resource
+
+      def list(access_token:, **params)
+        protected_resource(access_token) do
+          data = api_client.get("/v2/transactions", params)
+          convert_to_bridge_object(data)
+        end
+      end
+
+      def list_updated(access_token:, **params)
+        protected_resource(access_token) do
+          data = api_client.get("/v2/transactions/updated", params)
+          convert_to_bridge_object(data)
+        end
+      end
+
+      def find(id:, access_token:, **params)
+        protected_resource(access_token) do
+          data = api_client.get("/v2/transactions/#{id}", params)
+          convert_to_bridge_object(data)
+        end
+      end
+
+      def list_by_account(account_id:, access_token:, **params)
+        protected_resource(access_token) do
+          data = api_client.get("/v2/accounts/#{account_id}/transactions", params)
+          convert_to_bridge_object(data)
+        end
+      end
+
+      def list_updated_by_account(account_id:, access_token:, **params)
+        protected_resource(access_token) do
+          data = api_client.get("/v2/accounts/#{account_id}/transactions/updated", params)
+          convert_to_bridge_object(data)
+        end
+      end
+
+      def list_by_iban(access_token:, **params)
+        protected_resource(access_token) do
+          data = api_client.post("/v2/transactions/search", params)
+          convert_to_bridge_object(data)
+        end
+      end
+    end
+  end
+end