asaas-sdk 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d420f112f43923771b7d6df6feb5eb99f42774d8903338614995bdc7be3af2f1
-  data.tar.gz: 7dd8d9109d82e5daa3455775711f974078a758ca0273d13f241511f07b8a474c
+  metadata.gz: e1e48c5ecf2b4a9ad5d592669c2c3999196cc5fdaee7425fbd7f24137d72c715
+  data.tar.gz: a2d31385b28339e9415f1c458a12bfdb0de6634361e5ed390c8389d7defccf53
 SHA512:
-  metadata.gz: 47faba89b760d0dd6bd587b04be2cd0919f3f220377a142abc34e5f6465803a9392f949362f71a5df930f3953ff3366def7b2d119de302fa9853d5d54c018560
-  data.tar.gz: 39e16dc9fc2d333f992223bc3e9970f0b06d8243abe1987a87bedb1035a286153d0ec14054e5d0e65ba39f40f722b46f1e3e3e6ca4b47e1f5823758731325c88
+  metadata.gz: 44ba93d66d206d166e4724873b2f7e8afdc1fd54ede61fab34d01a297c2209945a6293d0003a9c773df0b14291666d46afd57c2a0ed8f64da845553d562eca5a
+  data.tar.gz: 2a94a9fb4edea9fb562c94e8704b2411361311514d1c66a910baa814514484187ab630275159e119e9a5c7236ba54caa9f2ab5da103a97827b3dfb5304fd2425

data/CHANGELOG.md

@@ -7,6 +7,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.1.1] - 2026-11-12
+
+### Added
+- `Transfer.cancel(id, opts)` calls `DELETE /transfers/:id/cancel`. `Transfer.delete`
+  hits `/transfers/:id`, which isn't the cancel endpoint.
+
+### Fixed
+- `update`, `delete`, `list`, `Finance.balance`, `Finance.statistics` and
+  `Finance.extract` now forward the per-call `retryable` and `timeout` options.
+  `ListObject#next_page` keeps them, so `auto_paging_each` honours them on every page.
+
 ## [0.1.0] - 2026-11-11
 
 First public release, published as `asaas-sdk`. The Ruby namespace is `Asaas`;

data/README.md

@@ -131,6 +131,11 @@ automatically repeated after an ambiguous response, set `retryable: false` and
 reconcile the payment before any new refund submission. Passing an idempotency
 key forwards the header; it does not by itself prove provider-side deduplication.
 
+The generic `create`, `retrieve`, `update`, `delete` and `list` (including the
+pages `auto_paging_each` fetches), `Finance.balance`, `Finance.statistics`,
+`Finance.extract` and `Transfer.cancel` accept the same `retryable` and
+`timeout` options.
+
 ### Subscriptions
 
 ```ruby
@@ -192,7 +197,7 @@ Asaas::PaymentLink.add_image("lnk_123", image: "base64data")
 Asaas::Transfer.create(value: 500.0, walletId: "wal_abc")
 Asaas::Transfer.retrieve("tra_123")
 Asaas::Transfer.list
-Asaas::Transfer.delete("tra_123")  # cancel
+Asaas::Transfer.cancel("tra_123")  # DELETE /transfers/:id/cancel
 ```
 
 ### Installments

data/lib/asaas/list_object.rb

@@ -6,15 +6,17 @@ module Asaas
 
     attr_reader :data, :has_more, :total_count, :limit, :offset
 
-    def initialize(attrs, client:, path:, params: {})
-      @data        = Array(attrs["data"]).map { AsaasObject.construct_from(_1) }
-      @has_more    = attrs["hasMore"] || false
-      @total_count = attrs["totalCount"]
-      @limit       = attrs["limit"]
-      @offset      = attrs["offset"] || 0
-      @client      = client
-      @path        = path
-      @params      = params
+    # request_options (retryable, timeout) also apply to every next_page call.
+    def initialize(attrs, client:, path:, params: {}, request_options: {})
+      @data            = Array(attrs["data"]).map { AsaasObject.construct_from(_1) }
+      @has_more        = attrs["hasMore"] || false
+      @total_count     = attrs["totalCount"]
+      @limit           = attrs["limit"]
+      @offset          = attrs["offset"] || 0
+      @client          = client
+      @path            = path
+      @params          = params
+      @request_options = request_options
     end
 
     def each(&block)
@@ -25,8 +27,8 @@ module Asaas
       return nil unless @has_more
 
       next_params = @params.merge("offset" => @offset + @limit, "limit" => @limit)
-      raw = @client.request(:get, @path, params: next_params)
-      self.class.new(raw, client: @client, path: @path, params: next_params)
+      raw = @client.request(:get, @path, params: next_params, **@request_options)
+      self.class.new(raw, client: @client, path: @path, params: next_params, request_options: @request_options)
     end
 
     def auto_paging_each(&block)
@@ -41,8 +43,8 @@ module Asaas
       end
     end
 
-    def self.construct_from(attrs, client:, path:, params: {})
-      new(attrs, client: client, path: path, params: params)
+    def self.construct_from(attrs, client:, path:, params: {}, request_options: {})
+      new(attrs, client: client, path: path, params: params, request_options: request_options)
     end
 
     def inspect

data/lib/asaas/resources/base.rb

@@ -14,36 +14,31 @@ module Asaas
           :post,
           resource_path,
           params: params,
-          retryable: opts.fetch(:retryable, true),
-          timeout: opts[:timeout],
-          idempotency_key: opts[:idempotency_key]
+          idempotency_key: opts[:idempotency_key],
+          **request_options(opts)
         )
         AsaasObject.construct_from(response)
       end
 
       def self.retrieve(id, opts = {})
-        response = client(opts).request(
-          :get,
-          "#{resource_path}/#{id}",
-          retryable: opts.fetch(:retryable, true),
-          timeout: opts[:timeout]
-        )
+        response = client(opts).request(:get, "#{resource_path}/#{id}", **request_options(opts))
         AsaasObject.construct_from(response)
       end
 
       def self.update(id, params = {}, opts = {})
-        response = client(opts).request(:put, "#{resource_path}/#{id}", params: params)
+        response = client(opts).request(:put, "#{resource_path}/#{id}", params: params, **request_options(opts))
         AsaasObject.construct_from(response)
       end
 
       def self.delete(id, opts = {})
-        response = client(opts).request(:delete, "#{resource_path}/#{id}")
+        response = client(opts).request(:delete, "#{resource_path}/#{id}", **request_options(opts))
         AsaasObject.construct_from(response)
       end
 
       def self.list(params = {}, opts = {})
-        response = client(opts).request(:get, resource_path, params: params)
-        ListObject.construct_from(response, client: client(opts), path: resource_path, params: params)
+        response = client(opts).request(:get, resource_path, params: params, **request_options(opts))
+        ListObject.construct_from(response, client: client(opts), path: resource_path, params: params,
+                                            request_options: request_options(opts))
       end
     end
   end

data/lib/asaas/resources/finance.rb

@@ -6,19 +6,20 @@ module Asaas
       extend HasClient
 
       def self.balance(opts = {})
-        response = client(opts).request(:get, "/finance/balance")
+        response = client(opts).request(:get, "/finance/balance", **request_options(opts))
         AsaasObject.construct_from(response)
       end
 
       def self.statistics(params = {}, opts = {})
-        response = client(opts).request(:get, "/finance/payment/statistics", params: params)
+        response = client(opts).request(:get, "/finance/payment/statistics", params: params, **request_options(opts))
         AsaasObject.construct_from(response)
       end
 
       def self.extract(params = {}, opts = {})
         path = "/financialTransactions"
-        response = client(opts).request(:get, path, params: params)
-        ListObject.construct_from(response, client: client(opts), path: path, params: params)
+        response = client(opts).request(:get, path, params: params, **request_options(opts))
+        ListObject.construct_from(response, client: client(opts), path: path, params: params,
+                                            request_options: request_options(opts))
       end
     end
   end

data/lib/asaas/resources/has_client.rb

@@ -4,12 +4,17 @@ module Asaas
   module Resources
     module HasClient
       def self.extended(base)
-        base.private_class_method(:client)
+        base.private_class_method(:client, :request_options)
       end
 
       def client(opts = {})
         Client.new(api_key: opts[:api_key])
       end
+
+      # Per-call transport options every request accepts: retry and timeout.
+      def request_options(opts = {})
+        { retryable: opts.fetch(:retryable, true), timeout: opts[:timeout] }
+      end
     end
   end
 end

data/lib/asaas/resources/transfer.rb

@@ -4,6 +4,12 @@ module Asaas
   module Resources
     class Transfer < Base
       def self.resource_path = "/transfers"
+
+      # Cancels a transfer that hasn't reached the bank yet.
+      def self.cancel(id, opts = {})
+        response = client(opts).request(:delete, "#{resource_path}/#{id}/cancel", **request_options(opts))
+        AsaasObject.construct_from(response)
+      end
     end
   end
 end

data/lib/asaas/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Asaas
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: asaas-sdk
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - JoaoPierre