feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 46
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/finch%2Ffinch-6d0c6a1feba5ccb895a6779cd98c2a0ae87d6394f5e98a9da51f17258c4eb297.yml
-openapi_spec_hash: ac3be0c8a992103e5f467fe1bcb20a81
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/finch%2Ffinch-bf86910e96e83e583689cf5d1a5c583268754026ec68288994fa6a969dc248f2.yml
+openapi_spec_hash: 195038e056891afec204c49dadce3b95
 config_hash: 5146b12344dae76238940989dac1e8a0

lib/finch_api/models/introspection.rb

@@ -99,6 +99,18 @@ class Introspection < FinchAPI::Internal::Type::BaseModel
       #   @return [String, nil]
       optional :customer_name, String, nil?: true
 
+      # @!attribute entity_ids
+      #   Array of entity IDs associated with this connection.
+      #
+      #   @return [Array<String>, nil]
+      optional :entity_ids, FinchAPI::Internal::Type::ArrayOf[String]
+
+      # @!attribute entity_mode
+      #   Indicates whether this connection manages a single entity or multiple entities.
+      #
+      #   @return [Symbol, FinchAPI::Models::Introspection::EntityMode, nil]
+      optional :entity_mode, enum: -> { FinchAPI::Introspection::EntityMode }
+
       # @!attribute manual
       #   Whether the connection associated with the `access_token` uses the Assisted
       #   Connect Flow. (`true` if using Assisted Connect, `false` if connection is
@@ -122,7 +134,7 @@ class Introspection < FinchAPI::Internal::Type::BaseModel
       #   @return [String, nil]
       optional :username, String, nil?: true
 
-      # @!method initialize(id:, client_id:, client_type:, connection_id:, connection_status:, connection_type:, products:, provider_id:, account_id: nil, authentication_methods: nil, company_id: nil, customer_email: nil, customer_id: nil, customer_name: nil, manual: nil, payroll_provider_id: nil, username: nil)
+      # @!method initialize(id:, client_id:, client_type:, connection_id:, connection_status:, connection_type:, products:, provider_id:, account_id: nil, authentication_methods: nil, company_id: nil, customer_email: nil, customer_id: nil, customer_name: nil, entity_ids: nil, entity_mode: nil, manual: nil, payroll_provider_id: nil, username: nil)
       #   Some parameter documentations has been truncated, see
       #   {FinchAPI::Models::Introspection} for more details.
       #
@@ -154,6 +166,10 @@ class Introspection < FinchAPI::Internal::Type::BaseModel
       #
       #   @param customer_name [String, nil] The name of your customer you provided to Finch when a connect session was creat
       #
+      #   @param entity_ids [Array<String>] Array of entity IDs associated with this connection.
+      #
+      #   @param entity_mode [Symbol, FinchAPI::Models::Introspection::EntityMode] Indicates whether this connection manages a single entity or multiple entities.
+      #
       #   @param manual [Boolean] Whether the connection associated with the `access_token` uses the Assisted Conn
       #
       #   @param payroll_provider_id [String] [DEPRECATED] Use `provider_id` to identify the provider instead of this payroll
@@ -317,6 +333,19 @@ module LastSuccessfulSync
           end
         end
       end
+
+      # Indicates whether this connection manages a single entity or multiple entities.
+      #
+      # @see FinchAPI::Models::Introspection#entity_mode
+      module EntityMode
+        extend FinchAPI::Internal::Type::Enum
+
+        SINGLE = :single
+        MULTI = :multi
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
     end
   end
 end

rbi/finch_api/models/introspection.rbi

@@ -95,6 +95,24 @@ module FinchAPI
       sig { returns(T.nilable(String)) }
       attr_accessor :customer_name
 
+      # Array of entity IDs associated with this connection.
+      sig { returns(T.nilable(T::Array[String])) }
+      attr_reader :entity_ids
+
+      sig { params(entity_ids: T::Array[String]).void }
+      attr_writer :entity_ids
+
+      # Indicates whether this connection manages a single entity or multiple entities.
+      sig do
+        returns(T.nilable(FinchAPI::Introspection::EntityMode::TaggedSymbol))
+      end
+      attr_reader :entity_mode
+
+      sig do
+        params(entity_mode: FinchAPI::Introspection::EntityMode::OrSymbol).void
+      end
+      attr_writer :entity_mode
+
       # Whether the connection associated with the `access_token` uses the Assisted
       # Connect Flow. (`true` if using Assisted Connect, `false` if connection is
       # automated)
@@ -133,6 +151,8 @@ module FinchAPI
           customer_email: T.nilable(String),
           customer_id: T.nilable(String),
           customer_name: T.nilable(String),
+          entity_ids: T::Array[String],
+          entity_mode: FinchAPI::Introspection::EntityMode::OrSymbol,
           manual: T::Boolean,
           payroll_provider_id: String,
           username: T.nilable(String)
@@ -173,6 +193,10 @@ module FinchAPI
         # The name of your customer you provided to Finch when a connect session was
         # created for this connection
         customer_name: nil,
+        # Array of entity IDs associated with this connection.
+        entity_ids: nil,
+        # Indicates whether this connection manages a single entity or multiple entities.
+        entity_mode: nil,
         # Whether the connection associated with the `access_token` uses the Assisted
         # Connect Flow. (`true` if using Assisted Connect, `false` if connection is
         # automated)
@@ -204,6 +228,8 @@ module FinchAPI
             customer_email: T.nilable(String),
             customer_id: T.nilable(String),
             customer_name: T.nilable(String),
+            entity_ids: T::Array[String],
+            entity_mode: FinchAPI::Introspection::EntityMode::TaggedSymbol,
             manual: T::Boolean,
             payroll_provider_id: String,
             username: T.nilable(String)
@@ -544,6 +570,27 @@ module FinchAPI
           end
         end
       end
+
+      # Indicates whether this connection manages a single entity or multiple entities.
+      module EntityMode
+        extend FinchAPI::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, FinchAPI::Introspection::EntityMode) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        SINGLE =
+          T.let(:single, FinchAPI::Introspection::EntityMode::TaggedSymbol)
+        MULTI = T.let(:multi, FinchAPI::Introspection::EntityMode::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[FinchAPI::Introspection::EntityMode::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
     end
   end
 end

sig/finch_api/models/introspection.rbs

@@ -16,6 +16,8 @@ module FinchAPI
         customer_email: String?,
         customer_id: String?,
         customer_name: String?,
+        entity_ids: ::Array[String],
+        entity_mode: FinchAPI::Models::Introspection::entity_mode,
         manual: bool,
         payroll_provider_id: String,
         username: String?
@@ -58,6 +60,16 @@ module FinchAPI
 
       attr_accessor customer_name: String?
 
+      attr_reader entity_ids: ::Array[String]?
+
+      def entity_ids=: (::Array[String]) -> ::Array[String]
+
+      attr_reader entity_mode: FinchAPI::Models::Introspection::entity_mode?
+
+      def entity_mode=: (
+        FinchAPI::Models::Introspection::entity_mode
+      ) -> FinchAPI::Models::Introspection::entity_mode
+
       attr_reader manual: bool?
 
       def manual=: (bool) -> bool
@@ -83,6 +95,8 @@ module FinchAPI
         ?customer_email: String?,
         ?customer_id: String?,
         ?customer_name: String?,
+        ?entity_ids: ::Array[String],
+        ?entity_mode: FinchAPI::Models::Introspection::entity_mode,
         ?manual: bool,
         ?payroll_provider_id: String,
         ?username: String?
@@ -103,6 +117,8 @@ module FinchAPI
         customer_email: String?,
         customer_id: String?,
         customer_name: String?,
+        entity_ids: ::Array[String],
+        entity_mode: FinchAPI::Models::Introspection::entity_mode,
         manual: bool,
         payroll_provider_id: String,
         username: String?
@@ -252,6 +268,17 @@ module FinchAPI
           end
         end
       end
+
+      type entity_mode = :single | :multi
+
+      module EntityMode
+        extend FinchAPI::Internal::Type::Enum
+
+        SINGLE: :single
+        MULTI: :multi
+
+        def self?.values: -> ::Array[FinchAPI::Models::Introspection::entity_mode]
+      end
     end
   end
 end

test/finch_api/resources/account_test.rb

@@ -40,6 +40,8 @@ def test_introspect
         customer_email: String | nil,
         customer_id: String | nil,
         customer_name: String | nil,
+        entity_ids: ^(FinchAPI::Internal::Type::ArrayOf[String]) | nil,
+        entity_mode: FinchAPI::Introspection::EntityMode | nil,
         manual: FinchAPI::Internal::Type::Boolean | nil,
         payroll_provider_id: String | nil,
         username: String | nil