revolut-connect 0.1.6 → 0.1.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6f6c231899d0e5bfd5e675e2b911ccead17aa1df7c8f8e7e7475ba07ebfd4800
-  data.tar.gz: b15045344651b7a013b15dba27ac2ad19b868029fb85f642129fde6be5c5dd1e
+  metadata.gz: b0b5d6b9801d9238ff7de1397f5398dd26651944e8d82de4f80eb497cbd89878
+  data.tar.gz: d9057ed5cbcc377551854526e4be16fcc11ad5bbcb0419ec7e6806e36d81ef52
 SHA512:
-  metadata.gz: 6c0de989febb683fff5dc5d823dd89285dac611192e4053222eccb304df0d8d9ae4b3fc0589a4e74bcf6c7e6180736f4712ac45e036a4f1262fead830c53fc07
-  data.tar.gz: 4d77b497a69a1936ffb28fe30b1f64534c8ea3b5cf94776f3b449d925d3b986b8c7c29ad8ebc9e30e964d64baa01456930a7dc274128a09c73709d0ae4e7ae47
+  metadata.gz: 68f7f02ffc2a8dba0c99ae87953ca8d02f880dde5343478678ff85fb88d0b736840b60260a82b893d750369214a7ae7b1cbe0f73e5643e9cf67d3e7973ceda8d
+  data.tar.gz: 778f06a9e1fe00e69450f8b74213461df563aa51ba51f95850f42cf75a6bca64a7cd7626b2ef44a69a7b8c0b1c15f5ccb163168170a32dcce99911bc4a15dd55

data/Gemfile

@@ -5,7 +5,7 @@ source "https://rubygems.org"
 # Specify your gem's dependencies in revolut-connect.gemspec
 gemspec
 
-gem "rake", "~> 13.0"
+gem "rake", "~> 13.2"
 
 group :development, :test do
   gem "byebug", "~> 11.1"
@@ -14,13 +14,13 @@ group :development, :test do
   gem "pry-rescue", "~> 1.5"
   gem "pry-stack_explorer", "~> 0.6.1"
   gem "dotenv"
-  gem "standard", "~> 1.3"
+  gem "standard", "~> 1.36"
   gem "timecop"
 end
 
 group :test do
   gem "rspec", "~> 3.0"
-  gem "webmock", "~> 3.23.0"
+  gem "webmock", "~> 3.23.1"
   gem "simplecov"
   gem "simplecov-cobertura"
 end

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    revolut-connect (0.1.6)
+    revolut-connect (0.1.7)
       faraday (>= 2)
       faraday-retry (>= 2)
       jwt (>= 1)
@@ -9,13 +9,13 @@ PATH
 GEM
   remote: https://rubygems.org/
   specs:
-    addressable (2.8.6)
-      public_suffix (>= 2.0.2, < 6.0)
+    addressable (2.8.7)
+      public_suffix (>= 2.0.2, < 7.0)
     ast (2.4.2)
     base64 (0.2.0)
-    bigdecimal (3.1.6)
-    binding_of_caller (1.0.0)
-      debug_inspector (>= 0.0.1)
+    bigdecimal (3.1.8)
+    binding_of_caller (1.0.1)
+      debug_inspector (>= 1.2.0)
     byebug (11.1.3)
     coderay (1.1.3)
     crack (1.0.0)
@@ -23,26 +23,28 @@ GEM
       rexml
     debug_inspector (1.2.0)
     diff-lcs (1.5.1)
-    docile (1.4.0)
-    dotenv (3.1.0)
-    faraday (2.9.0)
+    docile (1.4.1)
+    dotenv (3.1.2)
+    faraday (2.10.0)
       faraday-net_http (>= 2.0, < 3.2)
-    faraday-net_http (3.1.0)
+      logger
+    faraday-net_http (3.1.1)
       net-http
-    faraday-retry (2.2.0)
+    faraday-retry (2.2.1)
       faraday (~> 2.0)
     hashdiff (1.1.0)
     interception (0.5)
-    json (2.7.1)
-    jwt (2.8.1)
+    json (2.7.2)
+    jwt (2.8.2)
       base64
     language_server-protocol (3.17.0.3)
     lint_roller (1.1.0)
-    method_source (1.0.0)
+    logger (1.6.0)
+    method_source (1.1.0)
     net-http (0.4.1)
       uri
-    parallel (1.24.0)
-    parser (3.3.0.5)
+    parallel (1.25.1)
+    parser (3.3.4.0)
       ast (~> 2.4.1)
       racc
     pry (0.14.2)
@@ -57,26 +59,27 @@ GEM
     pry-stack_explorer (0.6.1)
       binding_of_caller (~> 1.0)
       pry (~> 0.13)
-    public_suffix (5.0.4)
-    racc (1.7.3)
+    public_suffix (6.0.1)
+    racc (1.8.0)
     rainbow (3.1.1)
-    rake (13.1.0)
-    regexp_parser (2.9.0)
-    rexml (3.2.6)
+    rake (13.2.1)
+    regexp_parser (2.9.2)
+    rexml (3.3.2)
+      strscan
     rspec (3.13.0)
       rspec-core (~> 3.13.0)
       rspec-expectations (~> 3.13.0)
       rspec-mocks (~> 3.13.0)
     rspec-core (3.13.0)
       rspec-support (~> 3.13.0)
-    rspec-expectations (3.13.0)
+    rspec-expectations (3.13.1)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
-    rspec-mocks (3.13.0)
+    rspec-mocks (3.13.1)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
     rspec-support (3.13.1)
-    rubocop (1.61.0)
+    rubocop (1.64.1)
       json (~> 2.3)
       language_server-protocol (>= 3.17.0)
       parallel (~> 1.10)
@@ -84,14 +87,14 @@ GEM
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 1.8, < 3.0)
       rexml (>= 3.2.5, < 4.0)
-      rubocop-ast (>= 1.30.0, < 2.0)
+      rubocop-ast (>= 1.31.1, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 3.0)
-    rubocop-ast (1.31.1)
-      parser (>= 3.3.0.4)
-    rubocop-performance (1.20.2)
+    rubocop-ast (1.31.3)
+      parser (>= 3.3.1.0)
+    rubocop-performance (1.21.1)
       rubocop (>= 1.48.1, < 2.0)
-      rubocop-ast (>= 1.30.0, < 2.0)
+      rubocop-ast (>= 1.31.1, < 2.0)
     ruby-progressbar (1.13.0)
     simplecov (0.22.0)
       docile (~> 1.1)
@@ -102,28 +105,30 @@ GEM
       simplecov (~> 0.19)
     simplecov-html (0.12.3)
     simplecov_json_formatter (0.1.4)
-    standard (1.34.0)
+    standard (1.39.2)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.0)
-      rubocop (~> 1.60)
+      rubocop (~> 1.64.0)
       standard-custom (~> 1.0.0)
-      standard-performance (~> 1.3)
+      standard-performance (~> 1.4)
     standard-custom (1.0.2)
       lint_roller (~> 1.0)
       rubocop (~> 1.50)
-    standard-performance (1.3.1)
+    standard-performance (1.4.0)
       lint_roller (~> 1.1)
-      rubocop-performance (~> 1.20.2)
-    timecop (0.9.8)
+      rubocop-performance (~> 1.21.0)
+    strscan (3.1.0)
+    timecop (0.9.10)
     unicode-display_width (2.5.0)
     uri (0.13.0)
-    webmock (3.23.0)
+    webmock (3.23.1)
       addressable (>= 2.8.0)
       crack (>= 0.3.2)
       hashdiff (>= 0.4.0, < 2.0.0)
 
 PLATFORMS
   x86_64-darwin-23
+  x86_64-linux
 
 DEPENDENCIES
   byebug (~> 11.1)
@@ -132,14 +137,14 @@ DEPENDENCIES
   pry-byebug (~> 3.10)
   pry-rescue (~> 1.5)
   pry-stack_explorer (~> 0.6.1)
-  rake (~> 13.0)
+  rake (~> 13.2)
   revolut-connect!
   rspec (~> 3.0)
   simplecov
   simplecov-cobertura
-  standard (~> 1.3)
+  standard (~> 1.36)
   timecop
-  webmock (~> 3.23.0)
+  webmock (~> 3.23.1)
 
 BUNDLED WITH
    2.4.22

data/README.md

@@ -19,6 +19,7 @@ _:warning: For now this connector only supports the [Business API](https://devel
 
 - `Account`
 - `Counterparty`
+- `ForeignExchange`
 - `Payment`
 - `Transaction`
 - `TransferReason`
@@ -30,7 +31,6 @@ _:warning: For now this connector only supports the [Business API](https://devel
 ### Business API
 
 - `Card` resource
-- `ForeignExchange` resource
 - `PaymentDraft` resource
 - `PayoutLink` resource
 - `TeamMember` resource
@@ -101,7 +101,7 @@ If bundler is not being used to manage dependencies, install the gem by executin
     And then, when you need to load the auth again:
 
     ```rb
-    Revolut::Auth.load(auth_to_persist)
+    Revolut::Auth.load(JSON.parse(auth_to_persist))
     ```
 
     You can also store this json in an environment variable and the gem will auto load it:
@@ -149,8 +149,8 @@ Revolut.configure do |config|
   # Useful for observability tools like Helicone: https://www.helicone.ai/
   # Default: {}
   config.global_headers = {
-    "Helicone-Auth": "Bearer {HELICONE_API_KEY}"
-    "helicone-stream-force-format" => "true",
+    "Helicone-Auth": "Bearer {HELICONE_API_KEY}",
+    "helicone-stream-force-format" => "true"
   }
 
   # Optional: Set the environment to be production or sandbox.
@@ -218,6 +218,35 @@ retrieved_counterparty = Revolut::Counterparty.retrieve(created_counterparty.id)
 deleted = Revolut::Counterparty.delete(retrieved_counterparty.id)
 ```
 
+#### ForeignExchange
+
+<https://developer.revolut.com/docs/business/foreign-exchange>
+
+```rb
+# Exchange currencies
+exchange = Revolut::ForeignExchange.exchange(
+  request_id: "49c6a48b-6b58-40a0-b974-0b8c4888c8a9", # The ID of the request, provided by you. It helps you identify the transaction in your system.
+  from: {
+    account_id: "8fe12333-5b27-4ad5-896c-38a25673fcc8",
+    currency: "USD"
+  },
+  to: {
+    account_id: "b4a3bcd2-c1dd-47cc-ac50-40cdb5856d42",
+    currency: "GBP",
+    amount: 10
+  },
+ reference: "exchange"
+)
+
+
+# Retrieve information on exchange rates between currencies
+rate = Revolut::ForeignExchange.rate(
+  from: "EUR",
+  to: "USD",
+  amount: 100
+)
+```
+
 #### Payments
 
 <https://developer.revolut.com/docs/business/create-payment>
@@ -297,6 +326,49 @@ rotated = Revolut::Webhook.rotate_signing_secret(webhook.id)
 failed_events = Revolut::Webhook.failed_events(webhook.id)
 ```
 
+#### Webhooks in web applications (Rails example)
+
+In order to start listening to revolut webhook events you'll first have to create a webhook in your revolut instance so that revolut knows that it needs to start pushing events to a certain URL:
+
+```rb
+webhook = Revolut::Webhook.create(url: "http://{your web app webhook URL}")
+puts webhook.signing_secret
+```
+
+You can then copy the signing secret and store it in the env variables as follows:
+
+```text
+REVOLUT_WEBHOOK_SECRET={copy your signing secret here}
+```
+
+Then, in the revolut webhook controller, you can do the following to coerce revolut events (rails example):
+
+```rb
+class Webhooks::RevolutController < ApplicationController
+
+  def run
+    coerced = Revolut::WebhookEvent.construct_from(request, ENV["REVOLUT_WEBHOOK_SECRET"])
+    case coerced.event
+      when "TransactionStateChanged"
+        # handle event
+      when "PayoutLinkCreated"
+        # handle event
+      ...
+    end
+  rescue Revolut::SignatureVerificationError => e
+    # Do something when the signature verification fails
+    head :bad_request
+  end
+
+end
+```
+
+The rails routes would look something like this:
+
+```rb
+post "webhooks/revolut", to: "webhooks/revolut#run"
+```
+
 ## Development
 
 You can use `bin/console` to access an interactive console. This will preload environment variables from a `.env` file.

data/lib/revolut/resources/foreign_exchange.rb

@@ -0,0 +1,28 @@
+require "forwardable"
+
+module Revolut
+  class ForeignExchange < Resource
+    shallow
+
+    class << self
+      extend Forwardable
+
+      def resource_name
+        "exchange"
+      end
+
+      def exchange(**attrs)
+        response = http_client.post("/#{resource_name}", data: attrs)
+
+        new(response.body)
+      end
+
+      # Delegate rate to the rate resource
+      def_delegators :rate_resource, :rate
+
+      def rate_resource
+        Revolut::Rate
+      end
+    end
+  end
+end

data/lib/revolut/resources/rate.rb

@@ -0,0 +1,15 @@
+module Revolut
+  class Rate < Resource
+    shallow
+
+    def self.resource_name
+      "rate"
+    end
+
+    def self.rate(**)
+      response = http_client.get("/#{resource_name}", **)
+
+      new(response.body)
+    end
+  end
+end

data/lib/revolut/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Revolut
-  VERSION = "0.1.6"
+  VERSION = "0.1.7"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: revolut-connect
 version: !ruby/object:Gem::Version
-  version: 0.1.6
+  version: 0.1.7
 platform: ruby
 authors:
 - Martin Mochetti
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-03-08 00:00:00.000000000 Z
+date: 2024-07-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jwt
@@ -82,7 +82,9 @@ files:
 - lib/revolut/resources/auth.rb
 - lib/revolut/resources/bank_account.rb
 - lib/revolut/resources/counterparty.rb
+- lib/revolut/resources/foreign_exchange.rb
 - lib/revolut/resources/payment.rb
+- lib/revolut/resources/rate.rb
 - lib/revolut/resources/resource.rb
 - lib/revolut/resources/simulation.rb
 - lib/revolut/resources/transaction.rb