lithic 0.1.0.pre.alpha.39 → 0.1.0.pre.alpha.41

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 24bcc946862d8309f1d3bcd0073c3d54c40f81bae248f0ca22b06acaacde673a
-  data.tar.gz: 6e7fc36ec06802ae0602381e4cc0b37b9b2685183ceed95c1e834e6bc34cbcd7
+  metadata.gz: a208b34c598732ce4f147c6e0a3ae38ef6adebe54875becd3b460ce855ff60e3
+  data.tar.gz: e3e81b2a51a92df94ea610568991df2d7df601637a983aaa4a8b1f98af89cdd6
 SHA512:
-  metadata.gz: cf1aadf77aa0aa1c0b4f1d8840ef7ca9e83ea44f4aba1a194d9c54d26b3d227f6c4e87769dba814564de27e494167a4db80a47129e351782c20a2a25722e0362
-  data.tar.gz: 77321cee941eb6dac08e8d43a1d74b4f4413ff7ffc44f5126108b930c93e6e71312f3a64416e4551adb29bb1a1e2c2a85f50afce03e7a75e90c9452d40009f64
+  metadata.gz: 0cb88495ccbb5f4778c68fa55df15f0ff9a8f3cdddb8a2c6578a8649a409c977a23596f93780e2df064b2825ef71e655e48a3d325b62b34d6c9a2670eed13424
+  data.tar.gz: fe8ad4d5e0f88b3eaf0f9d407d2a6303fe3c22fd6b7ee0f8dc742cc0460123c589b2bf1ee29ddb54f3793e1d3dbeaf4fec69d447d263a7f375687e8dc456a6c4

data/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## 0.1.0-alpha.41 (2025-09-03)
+
+Full Changelog: [v0.1.0-alpha.40...v0.1.0-alpha.41](https://github.com/lithic-com/lithic-ruby/compare/v0.1.0-alpha.40...v0.1.0-alpha.41)
+
+### Features
+
+* **api:** adds support for delegated KYB onboarding and more device details in 3DS Authentications ([37126bc](https://github.com/lithic-com/lithic-ruby/commit/37126bc6c52176bee9e1a6c645a4033d7b48b81a))
+
+
+### Chores
+
+* add json schema comment for rubocop.yml ([d5f9cf9](https://github.com/lithic-com/lithic-ruby/commit/d5f9cf9a5a4b9c2450c9ac65c5ec0708466c8331))
+* sync repo ([bc9dd5c](https://github.com/lithic-com/lithic-ruby/commit/bc9dd5c574eb24959f3760ff9bd9f3c5240064cc))
+
+## 0.1.0-alpha.40 (2025-07-15)
+
+Full Changelog: [v0.1.0-alpha.39...v0.1.0-alpha.40](https://github.com/lithic-com/lithic-ruby/compare/v0.1.0-alpha.39...v0.1.0-alpha.40)
+
+### Features
+
+* **api:** adds Network Programs and Account/Card Sub-statuses ([b5e5077](https://github.com/lithic-com/lithic-ruby/commit/b5e5077794684767a425d31f746cee2ed69d8ba7))
+* **api:** api update ([b8de03e](https://github.com/lithic-com/lithic-ruby/commit/b8de03e418647489f4e34b4a55ca4256f34c52fe))
+* **api:** api update ([72d4aab](https://github.com/lithic-com/lithic-ruby/commit/72d4aabb27fe144144c10899e64c863785d6595b))
+
 ## 0.1.0-alpha.39 (2025-07-03)
 
 Full Changelog: [v0.1.0-alpha.38...v0.1.0-alpha.39](https://github.com/lithic-com/lithic-ruby/compare/v0.1.0-alpha.38...v0.1.0-alpha.39)

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.1.0.pre.alpha.39"
+gem "lithic", "~> 0.1.0.pre.alpha.41"
 ```
 
 <!-- x-release-please-end -->

data/lib/lithic/client.rb

@@ -104,6 +104,12 @@ module Lithic
     # @return [Lithic::Resources::Fraud]
     attr_reader :fraud
 
+    # @return [Lithic::Resources::NetworkPrograms]
+    attr_reader :network_programs
+
+    # @return [Lithic::Resources::AccountActivity]
+    attr_reader :account_activity
+
     # Status of api
     #
     # @overload api_status(request_options: {})
@@ -205,6 +211,8 @@ module Lithic
       @management_operations = Lithic::Resources::ManagementOperations.new(client: self)
       @funding_events = Lithic::Resources::FundingEvents.new(client: self)
       @fraud = Lithic::Resources::Fraud.new(client: self)
+      @network_programs = Lithic::Resources::NetworkPrograms.new(client: self)
+      @account_activity = Lithic::Resources::AccountActivity.new(client: self)
     end
   end
 end

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

@@ -365,7 +365,7 @@ module Lithic
         #
         # @raise [Lithic::Errors::APIError]
         # @return [Array(Integer, Net::HTTPResponse, Enumerable<String>)]
-        private def send_request(request, redirect_count:, retry_count:, send_retry_header:)
+        def send_request(request, redirect_count:, retry_count:, send_retry_header:)
           url, headers, max_retries, timeout = request.fetch_values(:url, :headers, :max_retries, :timeout)
           input = {**request.except(:timeout), deadline: Lithic::Internal::Util.monotonic_secs + timeout}
 

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

@@ -193,15 +193,7 @@ module Lithic
         end
 
         define_sorbet_constant!(:Request) do
-          T.type_alias do
-            {
-              method: Symbol,
-              url: URI::Generic,
-              headers: T::Hash[String, String],
-              body: T.anything,
-              deadline: Float
-            }
-          end
+          T.type_alias { {method: Symbol, url: URI::Generic, headers: T::Hash[String, String], body: T.anything, deadline: Float} }
         end
       end
     end

data/lib/lithic/internal/type/array_of.rb

@@ -148,6 +148,7 @@ module Lithic
         #   @option spec [Boolean] :"nil?"
         def initialize(type_info, spec = {})
           @item_type_fn = Lithic::Internal::Type::Converter.type_info(type_info || spec)
+          @meta = Lithic::Internal::Type::Converter.meta_info(type_info, spec)
           @nilable = spec.fetch(:nil?, false)
         end
 

data/lib/lithic/internal/type/base_model.rb

@@ -52,6 +52,7 @@ module Lithic
           #
           #   @option spec [Boolean] :"nil?"
           private def add_field(name_sym, required:, type_info:, spec:)
+            meta = Lithic::Internal::Type::Converter.meta_info(type_info, spec)
             type_fn, info =
               case type_info
               in Proc | Lithic::Internal::Type::Converter | Class
@@ -74,7 +75,8 @@ module Lithic
                 required: required,
                 nilable: nilable,
                 const: const,
-                type_fn: type_fn
+                type_fn: type_fn,
+                meta: meta
               }
 
             define_method(setter) do |value|

data/lib/lithic/internal/type/converter.rb

@@ -98,6 +98,33 @@ module Lithic
             end
           end
 
+          # @api private
+          #
+          # @param type_info [Hash{Symbol=>Object}, Proc, Lithic::Internal::Type::Converter, Class] .
+          #
+          #   @option type_info [NilClass, TrueClass, FalseClass, Integer, Float, Symbol] :const
+          #
+          #   @option type_info [Proc] :enum
+          #
+          #   @option type_info [Proc] :union
+          #
+          #   @option type_info [Boolean] :"nil?"
+          #
+          # @param spec [Hash{Symbol=>Object}, Proc, Lithic::Internal::Type::Converter, Class] .
+          #
+          #   @option spec [NilClass, TrueClass, FalseClass, Integer, Float, Symbol] :const
+          #
+          #   @option spec [Proc] :enum
+          #
+          #   @option spec [Proc] :union
+          #
+          #   @option spec [Boolean] :"nil?"
+          #
+          # @return [Hash{Symbol=>Object}]
+          def meta_info(type_info, spec)
+            [spec, type_info].grep(Hash).first.to_h.except(:const, :enum, :union, :nil?)
+          end
+
           # @api private
           #
           # @param translate_names [Boolean]

data/lib/lithic/internal/type/hash_of.rb

@@ -168,6 +168,7 @@ module Lithic
         #   @option spec [Boolean] :"nil?"
         def initialize(type_info, spec = {})
           @item_type_fn = Lithic::Internal::Type::Converter.type_info(type_info || spec)
+          @meta = Lithic::Internal::Type::Converter.meta_info(type_info, spec)
           @nilable = spec.fetch(:nil?, false)
         end
 

data/lib/lithic/internal/type/union.rb

@@ -23,20 +23,20 @@ module Lithic
         #
         # All of the specified variant info for this union.
         #
-        # @return [Array<Array(Symbol, Proc)>]
+        # @return [Array<Array(Symbol, Proc, Hash{Symbol=>Object})>]
         private def known_variants = (@known_variants ||= [])
 
         # @api private
         #
-        # @return [Array<Array(Symbol, Object)>]
+        # @return [Array<Array(Symbol, Object, Hash{Symbol=>Object})>]
         protected def derefed_variants
-          known_variants.map { |key, variant_fn| [key, variant_fn.call] }
+          known_variants.map { |key, variant_fn, meta| [key, variant_fn.call, meta] }
         end
 
         # All of the specified variants for this union.
         #
         # @return [Array<Object>]
-        def variants = derefed_variants.map(&:last)
+        def variants = derefed_variants.map { _2 }
 
         # @api private
         #
@@ -62,12 +62,13 @@ module Lithic
         #
         #   @option spec [Boolean] :"nil?"
         private def variant(key, spec = nil)
+          meta = Lithic::Internal::Type::Converter.meta_info(nil, spec)
           variant_info =
             case key
             in Symbol
-              [key, Lithic::Internal::Type::Converter.type_info(spec)]
+              [key, Lithic::Internal::Type::Converter.type_info(spec), meta]
             in Proc | Lithic::Internal::Type::Converter | Class | Hash
-              [nil, Lithic::Internal::Type::Converter.type_info(key)]
+              [nil, Lithic::Internal::Type::Converter.type_info(key), meta]
             end
 
           known_variants << variant_info
@@ -90,7 +91,8 @@ module Lithic
             return nil if key == Lithic::Internal::OMIT
 
             key = key.to_sym if key.is_a?(String)
-            known_variants.find { |k,| k == key }&.last&.call
+            _, found = known_variants.find { |k,| k == key }
+            found&.call
           else
             nil
           end

data/lib/lithic/internal/util.rb

@@ -244,7 +244,7 @@ module Lithic
         #
         # @return [String]
         def uri_origin(uri)
-          "#{uri.scheme}://#{uri.host}#{uri.port == uri.default_port ? '' : ":#{uri.port}"}"
+          "#{uri.scheme}://#{uri.host}#{":#{uri.port}" unless uri.port == uri.default_port}"
         end
 
         # @api private

data/lib/lithic/models/account.rb

@@ -66,13 +66,51 @@ module Lithic
       #   @return [String, nil]
       optional :cardholder_currency, String
 
+      # @!attribute comment
+      #   Additional context or information related to the account.
+      #
+      #   @return [String, nil]
+      optional :comment, String
+
+      # @!attribute substatus
+      #   Account state substatus values:
+      #
+      #   - `FRAUD_IDENTIFIED` - The account has been recognized as being created or used
+      #     with stolen or fabricated identity information, encompassing both true
+      #     identity theft and synthetic identities.
+      #   - `SUSPICIOUS_ACTIVITY` - The account has exhibited suspicious behavior, such as
+      #     unauthorized access or fraudulent transactions, necessitating further
+      #     investigation.
+      #   - `RISK_VIOLATION` - The account has been involved in deliberate misuse by the
+      #     legitimate account holder. Examples include disputing valid transactions
+      #     without cause, falsely claiming non-receipt of goods, or engaging in
+      #     intentional bust-out schemes to exploit account services.
+      #   - `END_USER_REQUEST` - The account holder has voluntarily requested the closure
+      #     of the account for personal reasons. This encompasses situations such as
+      #     bankruptcy, other financial considerations, or the account holder's death.
+      #   - `ISSUER_REQUEST` - The issuer has initiated the closure of the account due to
+      #     business strategy, risk management, inactivity, product changes, regulatory
+      #     concerns, or violations of terms and conditions.
+      #   - `NOT_ACTIVE` - The account has not had any transactions or payment activity
+      #     within a specified period. This status applies to accounts that are paused or
+      #     closed due to inactivity.
+      #   - `INTERNAL_REVIEW` - The account is temporarily paused pending further internal
+      #     review. In future implementations, this status may prevent clients from
+      #     activating the account via APIs until the review is completed.
+      #   - `OTHER` - The reason for the account's current status does not fall into any
+      #     of the above categories. A comment should be provided to specify the
+      #     particular reason.
+      #
+      #   @return [Symbol, Lithic::Models::Account::Substatus, nil]
+      optional :substatus, enum: -> { Lithic::Account::Substatus }
+
       # @!attribute verification_address
       #   @deprecated
       #
       #   @return [Lithic::Models::Account::VerificationAddress, nil]
       optional :verification_address, -> { Lithic::Account::VerificationAddress }
 
-      # @!method initialize(token:, created:, spend_limit:, state:, account_holder: nil, auth_rule_tokens: nil, cardholder_currency: nil, verification_address: nil)
+      # @!method initialize(token:, created:, spend_limit:, state:, account_holder: nil, auth_rule_tokens: nil, cardholder_currency: nil, comment: nil, substatus: nil, verification_address: nil)
       #   Some parameter documentations has been truncated, see {Lithic::Models::Account}
       #   for more details.
       #
@@ -90,6 +128,10 @@ module Lithic
       #
       #   @param cardholder_currency [String] 3-character alphabetic ISO 4217 code for the currency of the cardholder.
       #
+      #   @param comment [String] Additional context or information related to the account.
+      #
+      #   @param substatus [Symbol, Lithic::Models::Account::Substatus] Account state substatus values:
+      #
       #   @param verification_address [Lithic::Models::Account::VerificationAddress]
 
       # @see Lithic::Models::Account#spend_limit
@@ -191,6 +233,51 @@ module Lithic
         #   @param phone_number [String] Phone number of the individual.
       end
 
+      # Account state substatus values:
+      #
+      # - `FRAUD_IDENTIFIED` - The account has been recognized as being created or used
+      #   with stolen or fabricated identity information, encompassing both true
+      #   identity theft and synthetic identities.
+      # - `SUSPICIOUS_ACTIVITY` - The account has exhibited suspicious behavior, such as
+      #   unauthorized access or fraudulent transactions, necessitating further
+      #   investigation.
+      # - `RISK_VIOLATION` - The account has been involved in deliberate misuse by the
+      #   legitimate account holder. Examples include disputing valid transactions
+      #   without cause, falsely claiming non-receipt of goods, or engaging in
+      #   intentional bust-out schemes to exploit account services.
+      # - `END_USER_REQUEST` - The account holder has voluntarily requested the closure
+      #   of the account for personal reasons. This encompasses situations such as
+      #   bankruptcy, other financial considerations, or the account holder's death.
+      # - `ISSUER_REQUEST` - The issuer has initiated the closure of the account due to
+      #   business strategy, risk management, inactivity, product changes, regulatory
+      #   concerns, or violations of terms and conditions.
+      # - `NOT_ACTIVE` - The account has not had any transactions or payment activity
+      #   within a specified period. This status applies to accounts that are paused or
+      #   closed due to inactivity.
+      # - `INTERNAL_REVIEW` - The account is temporarily paused pending further internal
+      #   review. In future implementations, this status may prevent clients from
+      #   activating the account via APIs until the review is completed.
+      # - `OTHER` - The reason for the account's current status does not fall into any
+      #   of the above categories. A comment should be provided to specify the
+      #   particular reason.
+      #
+      # @see Lithic::Models::Account#substatus
+      module Substatus
+        extend Lithic::Internal::Type::Enum
+
+        FRAUD_IDENTIFIED = :FRAUD_IDENTIFIED
+        SUSPICIOUS_ACTIVITY = :SUSPICIOUS_ACTIVITY
+        RISK_VIOLATION = :RISK_VIOLATION
+        END_USER_REQUEST = :END_USER_REQUEST
+        ISSUER_REQUEST = :ISSUER_REQUEST
+        NOT_ACTIVE = :NOT_ACTIVE
+        INTERNAL_REVIEW = :INTERNAL_REVIEW
+        OTHER = :OTHER
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
       # @deprecated
       #
       # @see Lithic::Models::Account#verification_address

data/lib/lithic/models/account_activity_list_params.rb

@@ -0,0 +1,156 @@
+# frozen_string_literal: true
+
+module Lithic
+  module Models
+    # @see Lithic::Resources::AccountActivity#list
+    class AccountActivityListParams < Lithic::Internal::Type::BaseModel
+      extend Lithic::Internal::Type::RequestParameters::Converter
+      include Lithic::Internal::Type::RequestParameters
+
+      # @!attribute account_token
+      #   Filter by account token
+      #
+      #   @return [String, nil]
+      optional :account_token, String
+
+      # @!attribute begin_
+      #   Date string in RFC 3339 format. Only entries created after the specified time
+      #   will be included. UTC time zone.
+      #
+      #   @return [Time, nil]
+      optional :begin_, Time
+
+      # @!attribute business_account_token
+      #   Filter by business account token
+      #
+      #   @return [String, nil]
+      optional :business_account_token, String
+
+      # @!attribute category
+      #   Filter by transaction category
+      #
+      #   @return [Symbol, Lithic::Models::AccountActivityListParams::Category, nil]
+      optional :category, enum: -> { Lithic::AccountActivityListParams::Category }
+
+      # @!attribute end_
+      #   Date string in RFC 3339 format. Only entries created before the specified time
+      #   will be included. UTC time zone.
+      #
+      #   @return [Time, nil]
+      optional :end_, Time
+
+      # @!attribute ending_before
+      #   A cursor representing an item's token before which a page of results should end.
+      #   Used to retrieve the previous page of results before this item.
+      #
+      #   @return [String, nil]
+      optional :ending_before, String
+
+      # @!attribute financial_account_token
+      #   Filter by financial account token
+      #
+      #   @return [String, nil]
+      optional :financial_account_token, String
+
+      # @!attribute page_size
+      #   Page size (for pagination).
+      #
+      #   @return [Integer, nil]
+      optional :page_size, Integer
+
+      # @!attribute result
+      #   Filter by transaction result
+      #
+      #   @return [Array<Symbol, Lithic::Models::AccountActivityListParams::Result>, nil]
+      optional :result, -> { Lithic::Internal::Type::ArrayOf[enum: Lithic::AccountActivityListParams::Result] }
+
+      # @!attribute starting_after
+      #   A cursor representing an item's token after which a page of results should
+      #   begin. Used to retrieve the next page of results after this item.
+      #
+      #   @return [String, nil]
+      optional :starting_after, String
+
+      # @!attribute status
+      #   Filter by transaction status
+      #
+      #   @return [Array<Symbol, Lithic::Models::AccountActivityListParams::Status>, nil]
+      optional :status, -> { Lithic::Internal::Type::ArrayOf[enum: Lithic::AccountActivityListParams::Status] }
+
+      # @!method initialize(account_token: nil, begin_: nil, business_account_token: nil, category: nil, end_: nil, ending_before: nil, financial_account_token: nil, page_size: nil, result: nil, starting_after: nil, status: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Lithic::Models::AccountActivityListParams} for more details.
+      #
+      #   @param account_token [String] Filter by account token
+      #
+      #   @param begin_ [Time] Date string in RFC 3339 format. Only entries created after the specified time wi
+      #
+      #   @param business_account_token [String] Filter by business account token
+      #
+      #   @param category [Symbol, Lithic::Models::AccountActivityListParams::Category] Filter by transaction category
+      #
+      #   @param end_ [Time] Date string in RFC 3339 format. Only entries created before the specified time w
+      #
+      #   @param ending_before [String] A cursor representing an item's token before which a page of results should end.
+      #
+      #   @param financial_account_token [String] Filter by financial account token
+      #
+      #   @param page_size [Integer] Page size (for pagination).
+      #
+      #   @param result [Array<Symbol, Lithic::Models::AccountActivityListParams::Result>] Filter by transaction result
+      #
+      #   @param starting_after [String] A cursor representing an item's token after which a page of results should begin
+      #
+      #   @param status [Array<Symbol, Lithic::Models::AccountActivityListParams::Status>] Filter by transaction status
+      #
+      #   @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}]
+
+      # Filter by transaction category
+      module Category
+        extend Lithic::Internal::Type::Enum
+
+        ACH = :ACH
+        BALANCE_OR_FUNDING = :BALANCE_OR_FUNDING
+        CARD = :CARD
+        EXTERNAL_ACH = :EXTERNAL_ACH
+        EXTERNAL_CHECK = :EXTERNAL_CHECK
+        EXTERNAL_TRANSFER = :EXTERNAL_TRANSFER
+        EXTERNAL_WIRE = :EXTERNAL_WIRE
+        MANAGEMENT_ADJUSTMENT = :MANAGEMENT_ADJUSTMENT
+        MANAGEMENT_DISPUTE = :MANAGEMENT_DISPUTE
+        MANAGEMENT_FEE = :MANAGEMENT_FEE
+        MANAGEMENT_REWARD = :MANAGEMENT_REWARD
+        MANAGEMENT_DISBURSEMENT = :MANAGEMENT_DISBURSEMENT
+        PROGRAM_FUNDING = :PROGRAM_FUNDING
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      module Result
+        extend Lithic::Internal::Type::Enum
+
+        APPROVED = :APPROVED
+        DECLINED = :DECLINED
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      module Status
+        extend Lithic::Internal::Type::Enum
+
+        DECLINED = :DECLINED
+        EXPIRED = :EXPIRED
+        PENDING = :PENDING
+        SETTLED = :SETTLED
+        VOIDED = :VOIDED
+        RETURNED = :RETURNED
+        REVERSED = :REVERSED
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end