lithic 0.2.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f8946d1c458ae277f59faee42210befe43f7ad248f2af24d1a96700ace4bffd5
-  data.tar.gz: 7ec367fffbd069f955681d5b3e59328ae0714493739c8d7f6f0291ebfa13315f
+  metadata.gz: 3c9b82b20af6ee10e138b64db9e21fa9859d5058b058b3f4d8bd9c3ce12f83ac
+  data.tar.gz: 2bf7dbce1c92170c905528b75e67a6b69145a154c217286a25710b83cd42c325
 SHA512:
-  metadata.gz: f0ca88aa8c35a14f40e5387407acdf493491c40f5b100bef248632c2d55e5bf2c31bcf9a659f074319b4314a7560819da891a6d8ec58ce50fac2f1726d6997be
-  data.tar.gz: 9a0d64b55815fd2ad4a7e414ba4864e3612f3107e17e2d93609978023d8904df2c7450bb40f8f86efad97e1e7c7b1741a7e6f0c25c03868726cbab89e23f2d6a
+  metadata.gz: c23410831a8ff4b4f658af06396bd4239a09b44a66a02e797010247c78b6534d56eca63064d267a74ed8ed6b07fdcd3c10c3dc3ec1722dcbad2fe39aae72388f
+  data.tar.gz: e07f42259409e859856a1635d9cd2f3681f8b0bcce3f29a69e128141a43623451126b6dd1f42d01468db0cc5bbcf024d1a9e98c2f2d5fd54a603890cc9103c4a

data/CHANGELOG.md

@@ -1,5 +1,83 @@
 # Changelog
 
+## 0.4.0 (2026-01-27)
+
+Full Changelog: [v0.3.0...v0.4.0](https://github.com/lithic-com/lithic-ruby/compare/v0.3.0...v0.4.0)
+
+### Features
+
+* **api:** Add card state attribute to tokenization rules ([0fe9646](https://github.com/lithic-com/lithic-ruby/commit/0fe9646694e932fddba74b91dcc7cdb1bb565d10))
+* **api:** Add card.updated event ([80369fe](https://github.com/lithic-com/lithic-ruby/commit/80369fe89f4bfb7255bfa05a2035c77238debe3a))
+* **api:** Add event_type to ASA request and 3DS decisioning request ([0fe9646](https://github.com/lithic-com/lithic-ruby/commit/0fe9646694e932fddba74b91dcc7cdb1bb565d10))
+* **api:** Add idempotency key to cards POST and PATCH endpoints ([51321d8](https://github.com/lithic-com/lithic-ruby/commit/51321d8d84f5e1fcb4e9161dd607f01dc9d5cf5d))
+* **api:** Add merchant location fields to simulator endpoints ([d983a60](https://github.com/lithic-com/lithic-ruby/commit/d983a608526955b2699b151e71d14adab72a1a7d))
+* **api:** Add tags field to card transactions ([edf8fbc](https://github.com/lithic-com/lithic-ruby/commit/edf8fbccb53de602bc52be916d6c80498ae4e390))
+* **api:** Add user defined status to ledger accounts ([0fe9646](https://github.com/lithic-com/lithic-ruby/commit/0fe9646694e932fddba74b91dcc7cdb1bb565d10))
+* **api:** Expose Payment Allocation Details ([0fe9646](https://github.com/lithic-com/lithic-ruby/commit/0fe9646694e932fddba74b91dcc7cdb1bb565d10))
+* **api:** make filter optional for Spend Velocity Auth Rules ([3e09d4a](https://github.com/lithic-com/lithic-ruby/commit/3e09d4a5488c83ad8122c973baf5eb4e18de29b0))
+
+
+### Bug Fixes
+
+* **api:** Correct field name from ach_hold__period to ach_hold_period ([16b6555](https://github.com/lithic-com/lithic-ruby/commit/16b65553840cfad0d39eb52d9770ca394a893c44))
+* **api:** mark AppleWebPushProvisioningResponse fields required ([4105b29](https://github.com/lithic-com/lithic-ruby/commit/4105b29d27ce48c60180c5b7166e664fdd1c0e46))
+* **api:** rename WIRE_DRAWDOWN_REQUEST to WIRE_INBOUND_DRAWDOWN_REQUEST ([3e09d4a](https://github.com/lithic-com/lithic-ruby/commit/3e09d4a5488c83ad8122c973baf5eb4e18de29b0))
+
+
+### Chores
+
+* Add spec linter for YAML and folded style multiline strings ([35a67d3](https://github.com/lithic-com/lithic-ruby/commit/35a67d3154e8f54d374c53d8b3b53b9485272878))
+* configure new SDK language ([ba770b2](https://github.com/lithic-com/lithic-ruby/commit/ba770b2cd5f50ba1871c539f89036ff4538b1df2))
+* **internal:** codegen related update ([ef965b2](https://github.com/lithic-com/lithic-ruby/commit/ef965b2fc0cfebc92a3d2317b7201318bcd500aa))
+* **internal:** codegen related update ([143a5ea](https://github.com/lithic-com/lithic-ruby/commit/143a5ea456ee1e6db32fd923ddb68f749ceed53b))
+* **internal:** update `actions/checkout` version ([830ae4a](https://github.com/lithic-com/lithic-ruby/commit/830ae4ad28662e5be21860d14ea86d2f1fa25ec0))
+* Rework event type generation to support spec splitting ([fdb9960](https://github.com/lithic-com/lithic-ruby/commit/fdb9960d08f95f161da8abf310509d594a0d2957))
+* update code formatting ([0fe9646](https://github.com/lithic-com/lithic-ruby/commit/0fe9646694e932fddba74b91dcc7cdb1bb565d10))
+
+
+### Documentation
+
+* Remove deprecated tag from MERCHANT_LOCKED card type ([b3104df](https://github.com/lithic-com/lithic-ruby/commit/b3104df92ab8f161c92c1136b86a1a734576f574))
+* Update language for Google Web Push Provisioning docs ([0fe9646](https://github.com/lithic-com/lithic-ruby/commit/0fe9646694e932fddba74b91dcc7cdb1bb565d10))
+
+## 0.3.0 (2026-01-08)
+
+Full Changelog: [v0.2.0...v0.3.0](https://github.com/lithic-com/lithic-ruby/compare/v0.2.0...v0.3.0)
+
+### Features
+
+* **api:** Add card state attribute to tokenization rules ([24f042b](https://github.com/lithic-com/lithic-ruby/commit/24f042b70a1b3b6f30639fe6d04dbc7d566ea187))
+* **api:** Add event_type to ASA request and 3DS decisioning request ([24f042b](https://github.com/lithic-com/lithic-ruby/commit/24f042b70a1b3b6f30639fe6d04dbc7d566ea187))
+* **api:** add external_id to payment_event ([0bad1d9](https://github.com/lithic-com/lithic-ruby/commit/0bad1d9ef7b439a1be19b68af67abb6e66e5c53f))
+* **api:** add get /v1/transfer_limits endpoint ([0bad1d9](https://github.com/lithic-com/lithic-ruby/commit/0bad1d9ef7b439a1be19b68af67abb6e66e5c53f))
+* **api:** add post /v1/book_transfers/{book_transfer_token}/retry endpoint ([0bad1d9](https://github.com/lithic-com/lithic-ruby/commit/0bad1d9ef7b439a1be19b68af67abb6e66e5c53f))
+* **api:** Add user defined status to ledger accounts ([24f042b](https://github.com/lithic-com/lithic-ruby/commit/24f042b70a1b3b6f30639fe6d04dbc7d566ea187))
+* **api:** add WIRE_DRAWDOWN_REQUEST transfer type ([832895f](https://github.com/lithic-com/lithic-ruby/commit/832895fdf5d4e72f9fc1ce62e9acfb6bcbdfdc14))
+* **api:** Expose Payment Allocation Details ([24f042b](https://github.com/lithic-com/lithic-ruby/commit/24f042b70a1b3b6f30639fe6d04dbc7d566ea187))
+* **api:** remove unnecessary X-Lithic-Pagination header ([832895f](https://github.com/lithic-com/lithic-ruby/commit/832895fdf5d4e72f9fc1ce62e9acfb6bcbdfdc14))
+* **api:** remove v1/aggregate_balances and related models ([c66d75e](https://github.com/lithic-com/lithic-ruby/commit/c66d75ed7b10521d5f73efeafb9dbcd6ff7a7f0c))
+
+
+### Bug Fixes
+
+* calling `break` out of streams should be instantaneous ([86db080](https://github.com/lithic-com/lithic-ruby/commit/86db080240382ba1cd73af9a01c89379cfb8e330))
+* issue where json.parse errors when receiving HTTP 204 with nobody ([9c9d63b](https://github.com/lithic-com/lithic-ruby/commit/9c9d63b07badd9fdd107314ac0bd5c8c23ddd0c3))
+
+
+### Chores
+
+* formatting ([e736094](https://github.com/lithic-com/lithic-ruby/commit/e736094a8bcf11007a6ea2666cfc6a646aca6972))
+* **internal:** codegen related update ([6bacc68](https://github.com/lithic-com/lithic-ruby/commit/6bacc684b578951ece05155697ec0b68c2d8d4e0))
+* Simplify custom code ([67dc77a](https://github.com/lithic-com/lithic-ruby/commit/67dc77a78348d9d910cca58ffba483992b738f30))
+* Simplify custom code - same for rbs file ([3438ceb](https://github.com/lithic-com/lithic-ruby/commit/3438cebfd4899c87d06a2bc42d4a76af709ea21f))
+* update code formatting ([24f042b](https://github.com/lithic-com/lithic-ruby/commit/24f042b70a1b3b6f30639fe6d04dbc7d566ea187))
+
+
+### Documentation
+
+* **api:** clarify description of token /  retry_token when it serves as idempotency key ([832895f](https://github.com/lithic-com/lithic-ruby/commit/832895fdf5d4e72f9fc1ce62e9acfb6bcbdfdc14))
+* Update language for Google Web Push Provisioning docs ([24f042b](https://github.com/lithic-com/lithic-ruby/commit/24f042b70a1b3b6f30639fe6d04dbc7d566ea187))
+
 ## 0.2.0 (2025-12-10)
 
 Full Changelog: [v0.1.0...v0.2.0](https://github.com/lithic-com/lithic-ruby/compare/v0.1.0...v0.2.0)

data/README.md

@@ -15,7 +15,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "lithic", "~> 0.2.0"
+gem "lithic", "~> 0.4.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/lithic/client.rb

@@ -50,9 +50,6 @@ module Lithic
     # @return [Lithic::Resources::Balances]
     attr_reader :balances
 
-    # @return [Lithic::Resources::AggregateBalances]
-    attr_reader :aggregate_balances
-
     # @return [Lithic::Resources::Disputes]
     attr_reader :disputes
 
@@ -119,6 +116,9 @@ module Lithic
     # @return [Lithic::Resources::AccountActivity]
     attr_reader :account_activity
 
+    # @return [Lithic::Resources::TransferLimits]
+    attr_reader :transfer_limits
+
     # @return [Lithic::Resources::Webhooks]
     attr_reader :webhooks
 
@@ -181,10 +181,6 @@ module Lithic
         raise ArgumentError.new("api_key is required, and can be set via environ: \"LITHIC_API_KEY\"")
       end
 
-      headers = {
-        "x-lithic-pagination" => "cursor"
-      }
-
       @api_key = api_key.to_s
 
       super(
@@ -192,8 +188,7 @@ module Lithic
         timeout: timeout,
         max_retries: max_retries,
         initial_retry_delay: initial_retry_delay,
-        max_retry_delay: max_retry_delay,
-        headers: headers
+        max_retry_delay: max_retry_delay
       )
 
       @accounts = Lithic::Resources::Accounts.new(client: self)
@@ -205,7 +200,6 @@ module Lithic
       @cards = Lithic::Resources::Cards.new(client: self)
       @card_bulk_orders = Lithic::Resources::CardBulkOrders.new(client: self)
       @balances = Lithic::Resources::Balances.new(client: self)
-      @aggregate_balances = Lithic::Resources::AggregateBalances.new(client: self)
       @disputes = Lithic::Resources::Disputes.new(client: self)
       @disputes_v2 = Lithic::Resources::DisputesV2.new(client: self)
       @events = Lithic::Resources::Events.new(client: self)
@@ -228,6 +222,7 @@ module Lithic
       @fraud = Lithic::Resources::Fraud.new(client: self)
       @network_programs = Lithic::Resources::NetworkPrograms.new(client: self)
       @account_activity = Lithic::Resources::AccountActivity.new(client: self)
+      @transfer_limits = Lithic::Resources::TransferLimits.new(client: self)
       @webhooks = Lithic::Resources::Webhooks.new(client: self)
     end
   end

data/lib/lithic/internal/transport/pooled_net_requester.rb

@@ -153,17 +153,19 @@ module Lithic
                   end
 
                   self.class.calibrate_socket_timeout(conn, deadline)
-                  conn.request(req) do |rsp|
-                    y << [req, rsp]
-                    break if finished
-
-                    rsp.read_body do |bytes|
-                      y << bytes.force_encoding(Encoding::BINARY)
-                      break if finished
-
-                      self.class.calibrate_socket_timeout(conn, deadline)
+                  ::Kernel.catch(:jump) do
+                    conn.request(req) do |rsp|
+                      y << [req, rsp]
+                      ::Kernel.throw(:jump) if finished
+
+                      rsp.read_body do |bytes|
+                        y << bytes.force_encoding(Encoding::BINARY)
+                        ::Kernel.throw(:jump) if finished
+
+                        self.class.calibrate_socket_timeout(conn, deadline)
+                      end
+                      eof = true
                     end
-                    eof = true
                   end
                 end
               ensure

data/lib/lithic/internal/util.rb

@@ -657,7 +657,8 @@ module Lithic
         def decode_content(headers, stream:, suppress_error: false)
           case (content_type = headers["content-type"])
           in Lithic::Internal::Util::JSON_CONTENT
-            json = stream.to_a.join
+            return nil if (json = stream.to_a.join).empty?
+
             begin
               JSON.parse(json, symbolize_names: true)
             rescue JSON::ParserError => e
@@ -667,7 +668,11 @@ module Lithic
           in Lithic::Internal::Util::JSONL_CONTENT
             lines = decode_lines(stream)
             chain_fused(lines) do |y|
-              lines.each { y << JSON.parse(_1, symbolize_names: true) }
+              lines.each do
+                next if _1.empty?
+
+                y << JSON.parse(_1, symbolize_names: true)
+              end
             end
           in %r{^text/event-stream}
             lines = decode_lines(stream)

data/lib/lithic/models/auth_rules/conditional_tokenization_action_parameters.rb

@@ -185,6 +185,8 @@ module Lithic
           #     `TOO_MANY_RECENT_TOKENS`, `UNABLE_TO_ASSESS`.
           #   - `TOKEN_REQUESTOR_ID`: Unique identifier for the entity requesting the token.
           #   - `WALLET_TOKEN_STATUS`: The current status of the wallet token.
+          #   - `CARD_STATE`: The state of the card being tokenized. Valid values are
+          #     `CLOSED`, `OPEN`, `PAUSED`, `PENDING_ACTIVATION`, `PENDING_FULFILLMENT`.
           #
           #   @return [Symbol, Lithic::Models::AuthRules::ConditionalTokenizationActionParameters::Condition::Attribute]
           required :attribute,
@@ -245,6 +247,8 @@ module Lithic
           #   `TOO_MANY_RECENT_TOKENS`, `UNABLE_TO_ASSESS`.
           # - `TOKEN_REQUESTOR_ID`: Unique identifier for the entity requesting the token.
           # - `WALLET_TOKEN_STATUS`: The current status of the wallet token.
+          # - `CARD_STATE`: The state of the card being tokenized. Valid values are
+          #   `CLOSED`, `OPEN`, `PAUSED`, `PENDING_ACTIVATION`, `PENDING_FULFILLMENT`.
           #
           # @see Lithic::Models::AuthRules::ConditionalTokenizationActionParameters::Condition#attribute
           module Attribute
@@ -260,6 +264,7 @@ module Lithic
             WALLET_RECOMMENDATION_REASONS = :WALLET_RECOMMENDATION_REASONS
             TOKEN_REQUESTOR_ID = :TOKEN_REQUESTOR_ID
             WALLET_TOKEN_STATUS = :WALLET_TOKEN_STATUS
+            CARD_STATE = :CARD_STATE
 
             # @!method self.values
             #   @return [Array<Symbol>]

data/lib/lithic/models/auth_rules/velocity_limit_params.rb

@@ -4,11 +4,6 @@ module Lithic
   module Models
     module AuthRules
       class VelocityLimitParams < Lithic::Internal::Type::BaseModel
-        # @!attribute filters
-        #
-        #   @return [Lithic::Models::AuthRules::VelocityLimitParams::Filters]
-        required :filters, -> { Lithic::AuthRules::VelocityLimitParams::Filters }
-
         # @!attribute period
         #   Velocity over the current day since 00:00 / 12 AM in Eastern Time
         #
@@ -21,6 +16,11 @@ module Lithic
         #   @return [Symbol, Lithic::Models::AuthRules::VelocityLimitParams::Scope]
         required :scope, enum: -> { Lithic::AuthRules::VelocityLimitParams::Scope }
 
+        # @!attribute filters
+        #
+        #   @return [Lithic::Models::AuthRules::VelocityLimitParams::Filters, nil]
+        optional :filters, -> { Lithic::AuthRules::VelocityLimitParams::Filters }
+
         # @!attribute limit_amount
         #   The maximum amount of spend velocity allowed in the period in minor units (the
         #   smallest unit of a currency, e.g. cents for USD). Transactions exceeding this
@@ -39,20 +39,33 @@ module Lithic
         #   @return [Integer, nil]
         optional :limit_count, Integer, nil?: true
 
-        # @!method initialize(filters:, period:, scope:, limit_amount: nil, limit_count: nil)
+        # @!method initialize(period:, scope:, filters: nil, limit_amount: nil, limit_count: nil)
         #   Some parameter documentations has been truncated, see
         #   {Lithic::Models::AuthRules::VelocityLimitParams} for more details.
         #
-        #   @param filters [Lithic::Models::AuthRules::VelocityLimitParams::Filters]
-        #
         #   @param period [Lithic::Models::AuthRules::VelocityLimitPeriod::TrailingWindowObject, Lithic::Models::AuthRules::VelocityLimitPeriod::FixedWindowDay, Lithic::Models::AuthRules::VelocityLimitPeriod::FixedWindowWeek, Lithic::Models::AuthRules::VelocityLimitPeriod::FixedWindowMonth, Lithic::Models::AuthRules::VelocityLimitPeriod::FixedWindowYear] Velocity over the current day since 00:00 / 12 AM in Eastern Time
         #
         #   @param scope [Symbol, Lithic::Models::AuthRules::VelocityLimitParams::Scope] The scope the velocity is calculated for
         #
+        #   @param filters [Lithic::Models::AuthRules::VelocityLimitParams::Filters]
+        #
         #   @param limit_amount [Integer, nil] The maximum amount of spend velocity allowed in the period in minor units (the s
         #
         #   @param limit_count [Integer, nil] The number of spend velocity impacting transactions may not exceed this limit in
 
+        # The scope the velocity is calculated for
+        #
+        # @see Lithic::Models::AuthRules::VelocityLimitParams#scope
+        module Scope
+          extend Lithic::Internal::Type::Enum
+
+          CARD = :CARD
+          ACCOUNT = :ACCOUNT
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
         # @see Lithic::Models::AuthRules::VelocityLimitParams#filters
         class Filters < Lithic::Internal::Type::BaseModel
           # @!attribute exclude_countries
@@ -133,19 +146,6 @@ module Lithic
             #   @return [Array<Symbol>]
           end
         end
-
-        # The scope the velocity is calculated for
-        #
-        # @see Lithic::Models::AuthRules::VelocityLimitParams#scope
-        module Scope
-          extend Lithic::Internal::Type::Enum
-
-          CARD = :CARD
-          ACCOUNT = :ACCOUNT
-
-          # @!method self.values
-          #   @return [Array<Symbol>]
-        end
       end
     end
   end

data/lib/lithic/models/book_transfer_retry_params.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Lithic
+  module Models
+    # @see Lithic::Resources::BookTransfers#retry_
+    class BookTransferRetryParams < Lithic::Internal::Type::BaseModel
+      extend Lithic::Internal::Type::RequestParameters::Converter
+      include Lithic::Internal::Type::RequestParameters
+
+      # @!attribute retry_token
+      #   Customer-provided token that will serve as an idempotency token. This token will
+      #   become the transaction token.
+      #
+      #   @return [String]
+      required :retry_token, String
+
+      # @!method initialize(retry_token:, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Lithic::Models::BookTransferRetryParams} for more details.
+      #
+      #   @param retry_token [String] Customer-provided token that will serve as an idempotency token. This token will
+      #
+      #   @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end