finch-api 0.1.0.pre.alpha.27 → 0.1.0.pre.alpha.29

data/rbi/finch_api/resources/access_tokens.rbi

@@ -6,17 +6,21 @@ module FinchAPI
       # Exchange the authorization code for an access token
       sig do
         params(
-          code: String,
           client_id: String,
           client_secret: String,
+          code: String,
           redirect_uri: String,
           request_options: FinchAPI::RequestOptions::OrHash
         ).returns(FinchAPI::CreateAccessTokenResponse)
       end
       def create(
+        # The client ID for your application
+        client_id:,
+        # The client secret for your application
+        client_secret:,
+        # The authorization code received from the authorization server
         code:,
-        client_id: nil,
-        client_secret: nil,
+        # The redirect URI used in the authorization request (optional)
         redirect_uri: nil,
         request_options: {}
       )

data/sig/finch_api/models/access_token_create_params.rbs

@@ -2,9 +2,9 @@ module FinchAPI
   module Models
     type access_token_create_params =
       {
-        code: String,
         client_id: String,
         client_secret: String,
+        code: String,
         redirect_uri: String
       }
       & FinchAPI::Internal::Type::request_parameters
@@ -13,32 +13,28 @@ module FinchAPI
       extend FinchAPI::Internal::Type::RequestParameters::Converter
       include FinchAPI::Internal::Type::RequestParameters
 
-      attr_accessor code: String
-
-      attr_reader client_id: String?
-
-      def client_id=: (String) -> String
+      attr_accessor client_id: String
 
-      attr_reader client_secret: String?
+      attr_accessor client_secret: String
 
-      def client_secret=: (String) -> String
+      attr_accessor code: String
 
       attr_reader redirect_uri: String?
 
       def redirect_uri=: (String) -> String
 
       def initialize: (
+        client_id: String,
+        client_secret: String,
         code: String,
-        ?client_id: String,
-        ?client_secret: String,
         ?redirect_uri: String,
         ?request_options: FinchAPI::request_opts
       ) -> void
 
       def to_hash: -> {
-        code: String,
         client_id: String,
         client_secret: String,
+        code: String,
         redirect_uri: String,
         request_options: FinchAPI::RequestOptions
       }

data/sig/finch_api/models/create_access_token_response.rbs

@@ -3,26 +3,22 @@ module FinchAPI
     type create_access_token_response =
       {
         access_token: String,
-        account_id: String,
         client_type: FinchAPI::Models::CreateAccessTokenResponse::client_type,
-        company_id: String,
         connection_id: String,
         connection_type: FinchAPI::Models::CreateAccessTokenResponse::connection_type,
         products: ::Array[String],
         provider_id: String,
-        customer_id: String?,
-        token_type: String
+        token_type: String,
+        account_id: String,
+        company_id: String,
+        customer_id: String?
       }
 
     class CreateAccessTokenResponse < FinchAPI::Internal::Type::BaseModel
       attr_accessor access_token: String
 
-      attr_accessor account_id: String
-
       attr_accessor client_type: FinchAPI::Models::CreateAccessTokenResponse::client_type
 
-      attr_accessor company_id: String
-
       attr_accessor connection_id: String
 
       attr_accessor connection_type: FinchAPI::Models::CreateAccessTokenResponse::connection_type
@@ -31,57 +27,63 @@ module FinchAPI
 
       attr_accessor provider_id: String
 
-      attr_accessor customer_id: String?
+      attr_accessor token_type: String
+
+      attr_reader account_id: String?
+
+      def account_id=: (String) -> String
 
-      attr_reader token_type: String?
+      attr_reader company_id: String?
 
-      def token_type=: (String) -> String
+      def company_id=: (String) -> String
+
+      attr_accessor customer_id: String?
 
       def initialize: (
         access_token: String,
-        account_id: String,
         client_type: FinchAPI::Models::CreateAccessTokenResponse::client_type,
-        company_id: String,
         connection_id: String,
         connection_type: FinchAPI::Models::CreateAccessTokenResponse::connection_type,
         products: ::Array[String],
         provider_id: String,
-        ?customer_id: String?,
-        ?token_type: String
+        token_type: String,
+        ?account_id: String,
+        ?company_id: String,
+        ?customer_id: String?
       ) -> void
 
       def to_hash: -> {
         access_token: String,
-        account_id: String,
         client_type: FinchAPI::Models::CreateAccessTokenResponse::client_type,
-        company_id: String,
         connection_id: String,
         connection_type: FinchAPI::Models::CreateAccessTokenResponse::connection_type,
         products: ::Array[String],
         provider_id: String,
-        customer_id: String?,
-        token_type: String
+        token_type: String,
+        account_id: String,
+        company_id: String,
+        customer_id: String?
       }
 
-      type client_type = :production | :development | :sandbox
+      type client_type = :development | :production | :sandbox
 
       module ClientType
         extend FinchAPI::Internal::Type::Enum
 
-        PRODUCTION: :production
         DEVELOPMENT: :development
+        PRODUCTION: :production
         SANDBOX: :sandbox
 
         def self?.values: -> ::Array[FinchAPI::Models::CreateAccessTokenResponse::client_type]
       end
 
-      type connection_type = :provider | :finch
+      type connection_type = :finch | :provider
 
       module ConnectionType
         extend FinchAPI::Internal::Type::Enum
 
-        PROVIDER: :provider
         FINCH: :finch
+        PROVIDER: :provider
 
         def self?.values: -> ::Array[FinchAPI::Models::CreateAccessTokenResponse::connection_type]
       end

data/sig/finch_api/models/introspection.rbs

@@ -3,107 +3,197 @@ module FinchAPI
     type introspection =
       {
         id: String,
-        account_id: String,
-        authentication_methods: ::Array[FinchAPI::Introspection::AuthenticationMethod],
         client_id: String,
         client_type: FinchAPI::Models::Introspection::client_type,
-        company_id: String,
         connection_id: String,
         connection_status: FinchAPI::Introspection::ConnectionStatus,
         connection_type: FinchAPI::Models::Introspection::connection_type,
+        products: ::Array[String],
+        provider_id: String,
+        account_id: String,
+        authentication_methods: ::Array[FinchAPI::Introspection::AuthenticationMethod],
+        company_id: String,
         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,
-        products: ::Array[String],
-        provider_id: String,
-        username: String
+        username: String?
       }
 
     class Introspection < FinchAPI::Internal::Type::BaseModel
       attr_accessor id: String
 
-      attr_accessor account_id: String
-
-      attr_accessor authentication_methods: ::Array[FinchAPI::Introspection::AuthenticationMethod]
-
       attr_accessor client_id: String
 
       attr_accessor client_type: FinchAPI::Models::Introspection::client_type
 
-      attr_accessor company_id: String
-
       attr_accessor connection_id: String
 
       attr_accessor connection_status: FinchAPI::Introspection::ConnectionStatus
 
       attr_accessor connection_type: FinchAPI::Models::Introspection::connection_type
 
+      attr_accessor products: ::Array[String]
+
+      attr_accessor provider_id: String
+
+      attr_reader account_id: String?
+
+      def account_id=: (String) -> String
+
+      attr_reader authentication_methods: ::Array[FinchAPI::Introspection::AuthenticationMethod]?
+
+      def authentication_methods=: (
+        ::Array[FinchAPI::Introspection::AuthenticationMethod]
+      ) -> ::Array[FinchAPI::Introspection::AuthenticationMethod]
+
+      attr_reader company_id: String?
+
+      def company_id=: (String) -> String
+
       attr_accessor customer_email: String?
 
       attr_accessor customer_id: String?
 
       attr_accessor customer_name: String?
 
-      attr_accessor manual: bool
+      attr_reader entity_ids: ::Array[String]?
 
-      attr_accessor payroll_provider_id: String
+      def entity_ids=: (::Array[String]) -> ::Array[String]
 
-      attr_accessor products: ::Array[String]
+      attr_reader entity_mode: FinchAPI::Models::Introspection::entity_mode?
 
-      attr_accessor provider_id: String
+      def entity_mode=: (
+        FinchAPI::Models::Introspection::entity_mode
+      ) -> FinchAPI::Models::Introspection::entity_mode
+
+      attr_reader manual: bool?
+
+      def manual=: (bool) -> bool
 
-      attr_accessor username: String
+      attr_reader payroll_provider_id: String?
+
+      def payroll_provider_id=: (String) -> String
+
+      attr_accessor username: String?
 
       def initialize: (
         id: String,
-        account_id: String,
-        authentication_methods: ::Array[FinchAPI::Introspection::AuthenticationMethod],
         client_id: String,
         client_type: FinchAPI::Models::Introspection::client_type,
-        company_id: String,
         connection_id: String,
         connection_status: FinchAPI::Introspection::ConnectionStatus,
         connection_type: FinchAPI::Models::Introspection::connection_type,
-        customer_email: String?,
-        customer_id: String?,
-        customer_name: String?,
-        manual: bool,
-        payroll_provider_id: String,
         products: ::Array[String],
         provider_id: String,
-        username: String
+        ?account_id: String,
+        ?authentication_methods: ::Array[FinchAPI::Introspection::AuthenticationMethod],
+        ?company_id: String,
+        ?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?
       ) -> void
 
       def to_hash: -> {
         id: String,
-        account_id: String,
-        authentication_methods: ::Array[FinchAPI::Introspection::AuthenticationMethod],
         client_id: String,
         client_type: FinchAPI::Models::Introspection::client_type,
-        company_id: String,
         connection_id: String,
         connection_status: FinchAPI::Introspection::ConnectionStatus,
         connection_type: FinchAPI::Models::Introspection::connection_type,
+        products: ::Array[String],
+        provider_id: String,
+        account_id: String,
+        authentication_methods: ::Array[FinchAPI::Introspection::AuthenticationMethod],
+        company_id: String,
         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,
-        products: ::Array[String],
-        provider_id: String,
-        username: String
+        username: String?
       }
 
+      type client_type = :development | :production | :sandbox
+
+      module ClientType
+        extend FinchAPI::Internal::Type::Enum
+
+        DEVELOPMENT: :development
+        PRODUCTION: :production
+        SANDBOX: :sandbox
+
+        def self?.values: -> ::Array[FinchAPI::Models::Introspection::client_type]
+      end
+
+      type connection_status =
+        {
+          status: FinchAPI::Models::connection_status_type,
+          last_successful_sync: FinchAPI::Models::Introspection::ConnectionStatus::last_successful_sync?,
+          message: String
+        }
+
+      class ConnectionStatus < FinchAPI::Internal::Type::BaseModel
+        attr_accessor status: FinchAPI::Models::connection_status_type
+
+        attr_accessor last_successful_sync: FinchAPI::Models::Introspection::ConnectionStatus::last_successful_sync?
+
+        attr_reader message: String?
+
+        def message=: (String) -> String
+
+        def initialize: (
+          status: FinchAPI::Models::connection_status_type,
+          ?last_successful_sync: FinchAPI::Models::Introspection::ConnectionStatus::last_successful_sync?,
+          ?message: String
+        ) -> void
+
+        def to_hash: -> {
+          status: FinchAPI::Models::connection_status_type,
+          last_successful_sync: FinchAPI::Models::Introspection::ConnectionStatus::last_successful_sync?,
+          message: String
+        }
+
+        type last_successful_sync = Time | String
+
+        module LastSuccessfulSync
+          extend FinchAPI::Internal::Type::Union
+
+          def self?.variants: -> ::Array[FinchAPI::Models::Introspection::ConnectionStatus::last_successful_sync]
+        end
+      end
+
+      type connection_type = :finch | :provider
+
+      module ConnectionType
+        extend FinchAPI::Internal::Type::Enum
+
+        FINCH: :finch
+        PROVIDER: :provider
+
+        def self?.values: -> ::Array[FinchAPI::Models::Introspection::connection_type]
+      end
+
       type authentication_method =
         {
+          type: FinchAPI::Models::Introspection::AuthenticationMethod::type_,
           connection_status: FinchAPI::Introspection::AuthenticationMethod::ConnectionStatus,
-          products: ::Array[String],
-          type: FinchAPI::Models::Introspection::AuthenticationMethod::type_
+          products: ::Array[String]
         }
 
       class AuthenticationMethod < FinchAPI::Internal::Type::BaseModel
+        attr_accessor type: FinchAPI::Models::Introspection::AuthenticationMethod::type_
+
         attr_reader connection_status: FinchAPI::Introspection::AuthenticationMethod::ConnectionStatus?
 
         def connection_status=: (
@@ -114,49 +204,18 @@ module FinchAPI
 
         def products=: (::Array[String]) -> ::Array[String]
 
-        attr_reader type: FinchAPI::Models::Introspection::AuthenticationMethod::type_?
-
-        def type=: (
-          FinchAPI::Models::Introspection::AuthenticationMethod::type_
-        ) -> FinchAPI::Models::Introspection::AuthenticationMethod::type_
-
         def initialize: (
+          type: FinchAPI::Models::Introspection::AuthenticationMethod::type_,
           ?connection_status: FinchAPI::Introspection::AuthenticationMethod::ConnectionStatus,
-          ?products: ::Array[String],
-          ?type: FinchAPI::Models::Introspection::AuthenticationMethod::type_
+          ?products: ::Array[String]
         ) -> void
 
         def to_hash: -> {
+          type: FinchAPI::Models::Introspection::AuthenticationMethod::type_,
           connection_status: FinchAPI::Introspection::AuthenticationMethod::ConnectionStatus,
-          products: ::Array[String],
-          type: FinchAPI::Models::Introspection::AuthenticationMethod::type_
+          products: ::Array[String]
         }
 
-        type connection_status =
-          { message: String, status: FinchAPI::Models::connection_status_type }
-
-        class ConnectionStatus < FinchAPI::Internal::Type::BaseModel
-          attr_reader message: String?
-
-          def message=: (String) -> String
-
-          attr_reader status: FinchAPI::Models::connection_status_type?
-
-          def status=: (
-            FinchAPI::Models::connection_status_type
-          ) -> FinchAPI::Models::connection_status_type
-
-          def initialize: (
-            ?message: String,
-            ?status: FinchAPI::Models::connection_status_type
-          ) -> void
-
-          def to_hash: -> {
-            message: String,
-            status: FinchAPI::Models::connection_status_type
-          }
-        end
-
         type type_ =
           :assisted | :credential | :api_token | :api_credential | :oauth
 
@@ -171,64 +230,54 @@ module FinchAPI
 
           def self?.values: -> ::Array[FinchAPI::Models::Introspection::AuthenticationMethod::type_]
         end
-      end
-
-      type client_type = :production | :development | :sandbox
-
-      module ClientType
-        extend FinchAPI::Internal::Type::Enum
-
-        PRODUCTION: :production
-        DEVELOPMENT: :development
-        SANDBOX: :sandbox
 
-        def self?.values: -> ::Array[FinchAPI::Models::Introspection::client_type]
-      end
+        type connection_status =
+          {
+            status: FinchAPI::Models::connection_status_type,
+            last_successful_sync: FinchAPI::Models::Introspection::AuthenticationMethod::ConnectionStatus::last_successful_sync?,
+            message: String
+          }
 
-      type connection_status =
-        {
-          last_successful_sync: Time,
-          message: String,
-          status: FinchAPI::Models::connection_status_type
-        }
+        class ConnectionStatus < FinchAPI::Internal::Type::BaseModel
+          attr_accessor status: FinchAPI::Models::connection_status_type
 
-      class ConnectionStatus < FinchAPI::Internal::Type::BaseModel
-        attr_reader last_successful_sync: Time?
+          attr_accessor last_successful_sync: FinchAPI::Models::Introspection::AuthenticationMethod::ConnectionStatus::last_successful_sync?
 
-        def last_successful_sync=: (Time) -> Time
+          attr_reader message: String?
 
-        attr_reader message: String?
+          def message=: (String) -> String
 
-        def message=: (String) -> String
+          def initialize: (
+            status: FinchAPI::Models::connection_status_type,
+            ?last_successful_sync: FinchAPI::Models::Introspection::AuthenticationMethod::ConnectionStatus::last_successful_sync?,
+            ?message: String
+          ) -> void
 
-        attr_reader status: FinchAPI::Models::connection_status_type?
+          def to_hash: -> {
+            status: FinchAPI::Models::connection_status_type,
+            last_successful_sync: FinchAPI::Models::Introspection::AuthenticationMethod::ConnectionStatus::last_successful_sync?,
+            message: String
+          }
 
-        def status=: (
-          FinchAPI::Models::connection_status_type
-        ) -> FinchAPI::Models::connection_status_type
+          type last_successful_sync = Time | String
 
-        def initialize: (
-          ?last_successful_sync: Time,
-          ?message: String,
-          ?status: FinchAPI::Models::connection_status_type
-        ) -> void
+          module LastSuccessfulSync
+            extend FinchAPI::Internal::Type::Union
 
-        def to_hash: -> {
-          last_successful_sync: Time,
-          message: String,
-          status: FinchAPI::Models::connection_status_type
-        }
+            def self?.variants: -> ::Array[FinchAPI::Models::Introspection::AuthenticationMethod::ConnectionStatus::last_successful_sync]
+          end
+        end
       end
 
-      type connection_type = :provider | :finch
+      type entity_mode = :single | :multi
 
-      module ConnectionType
+      module EntityMode
         extend FinchAPI::Internal::Type::Enum
 
-        PROVIDER: :provider
-        FINCH: :finch
+        SINGLE: :single
+        MULTI: :multi
 
-        def self?.values: -> ::Array[FinchAPI::Models::Introspection::connection_type]
+        def self?.values: -> ::Array[FinchAPI::Models::Introspection::entity_mode]
       end
     end
   end

data/sig/finch_api/resources/access_tokens.rbs

@@ -2,9 +2,9 @@ module FinchAPI
   module Resources
     class AccessTokens
       def create: (
+        client_id: String,
+        client_secret: String,
         code: String,
-        ?client_id: String,
-        ?client_secret: String,
         ?redirect_uri: String,
         ?request_options: FinchAPI::request_opts
       ) -> FinchAPI::CreateAccessTokenResponse

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: finch-api
 version: !ruby/object:Gem::Version
-  version: 0.1.0.pre.alpha.27
+  version: 0.1.0.pre.alpha.29
 platform: ruby
 authors:
 - Finch
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-08-19 00:00:00.000000000 Z
+date: 2025-09-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: connection_pool