finch-api 0.1.0.pre.alpha.1 → 0.1.0.pre.alpha.3

data/rbi/lib/finch-api/models/sandbox/directory_create_response.rbi

@@ -3,7 +3,7 @@
 module FinchAPI
   module Models
     module Sandbox
-      DirectoryCreateResponse = T.type_alias { T::Array[T.anything] }
+      DirectoryCreateResponse = T.let(FinchAPI::ArrayOf[FinchAPI::Unknown], FinchAPI::Converter)
     end
   end
 end

data/rbi/lib/finch-api/models/sandbox/employment_update_params.rbi

@@ -7,190 +7,144 @@ module FinchAPI
         extend FinchAPI::RequestParameters::Converter
         include FinchAPI::RequestParameters
 
+        # Worker's compensation classification code for this employee
         sig { returns(T.nilable(String)) }
-        def class_code
-        end
-
-        sig { params(_: T.nilable(String)).returns(T.nilable(String)) }
-        def class_code=(_)
-        end
+        attr_accessor :class_code
 
+        # Custom fields for the individual. These are fields which are defined by the
+        #   employer in the system. Custom fields are not currently supported for assisted
+        #   connections.
         sig { returns(T.nilable(T::Array[FinchAPI::Models::Sandbox::EmploymentUpdateParams::CustomField])) }
-        def custom_fields
-        end
+        attr_reader :custom_fields
 
         sig do
-          params(_: T::Array[FinchAPI::Models::Sandbox::EmploymentUpdateParams::CustomField])
-            .returns(T::Array[FinchAPI::Models::Sandbox::EmploymentUpdateParams::CustomField])
-        end
-        def custom_fields=(_)
+          params(
+            custom_fields: T::Array[T.any(FinchAPI::Models::Sandbox::EmploymentUpdateParams::CustomField, FinchAPI::Util::AnyHash)]
+          )
+            .void
         end
+        attr_writer :custom_fields
 
+        # The department object.
         sig { returns(T.nilable(FinchAPI::Models::Sandbox::EmploymentUpdateParams::Department)) }
-        def department
-        end
+        attr_reader :department
 
         sig do
-          params(_: T.nilable(FinchAPI::Models::Sandbox::EmploymentUpdateParams::Department))
-            .returns(T.nilable(FinchAPI::Models::Sandbox::EmploymentUpdateParams::Department))
-        end
-        def department=(_)
+          params(
+            department: T.nilable(T.any(FinchAPI::Models::Sandbox::EmploymentUpdateParams::Department, FinchAPI::Util::AnyHash))
+          )
+            .void
         end
+        attr_writer :department
 
+        # The employment object.
         sig { returns(T.nilable(FinchAPI::Models::Sandbox::EmploymentUpdateParams::Employment)) }
-        def employment
-        end
+        attr_reader :employment
 
         sig do
-          params(_: T.nilable(FinchAPI::Models::Sandbox::EmploymentUpdateParams::Employment))
-            .returns(T.nilable(FinchAPI::Models::Sandbox::EmploymentUpdateParams::Employment))
-        end
-        def employment=(_)
-        end
-
-        sig { returns(T.nilable(Symbol)) }
-        def employment_status
+          params(
+            employment: T.nilable(T.any(FinchAPI::Models::Sandbox::EmploymentUpdateParams::Employment, FinchAPI::Util::AnyHash))
+          )
+            .void
         end
+        attr_writer :employment
 
-        sig { params(_: T.nilable(Symbol)).returns(T.nilable(Symbol)) }
-        def employment_status=(_)
-        end
+        # The detailed employment status of the individual.
+        sig { returns(T.nilable(FinchAPI::Models::Sandbox::EmploymentUpdateParams::EmploymentStatus::OrSymbol)) }
+        attr_accessor :employment_status
 
         sig { returns(T.nilable(String)) }
-        def end_date
-        end
-
-        sig { params(_: T.nilable(String)).returns(T.nilable(String)) }
-        def end_date=(_)
-        end
+        attr_accessor :end_date
 
+        # The legal first name of the individual.
         sig { returns(T.nilable(String)) }
-        def first_name
-        end
-
-        sig { params(_: T.nilable(String)).returns(T.nilable(String)) }
-        def first_name=(_)
-        end
+        attr_accessor :first_name
 
+        # The employee's income as reported by the provider. This may not always be
+        #   annualized income, but may be in units of bi-weekly, semi-monthly, daily, etc,
+        #   depending on what information the provider returns.
         sig { returns(T.nilable(FinchAPI::Models::Income)) }
-        def income
-        end
+        attr_reader :income
 
-        sig { params(_: T.nilable(FinchAPI::Models::Income)).returns(T.nilable(FinchAPI::Models::Income)) }
-        def income=(_)
-        end
+        sig { params(income: T.nilable(T.any(FinchAPI::Models::Income, FinchAPI::Util::AnyHash))).void }
+        attr_writer :income
 
+        # The array of income history.
         sig { returns(T.nilable(T::Array[T.nilable(FinchAPI::Models::Income)])) }
-        def income_history
-        end
-
-        sig do
-          params(_: T.nilable(T::Array[T.nilable(FinchAPI::Models::Income)]))
-            .returns(T.nilable(T::Array[T.nilable(FinchAPI::Models::Income)]))
-        end
-        def income_history=(_)
-        end
+        attr_accessor :income_history
 
+        # `true` if the individual an an active employee or contractor at the company.
         sig { returns(T.nilable(T::Boolean)) }
-        def is_active
-        end
-
-        sig { params(_: T.nilable(T::Boolean)).returns(T.nilable(T::Boolean)) }
-        def is_active=(_)
-        end
+        attr_accessor :is_active
 
+        # The legal last name of the individual.
         sig { returns(T.nilable(String)) }
-        def last_name
-        end
-
-        sig { params(_: T.nilable(String)).returns(T.nilable(String)) }
-        def last_name=(_)
-        end
+        attr_accessor :last_name
 
         sig { returns(T.nilable(String)) }
-        def latest_rehire_date
-        end
-
-        sig { params(_: T.nilable(String)).returns(T.nilable(String)) }
-        def latest_rehire_date=(_)
-        end
+        attr_accessor :latest_rehire_date
 
         sig { returns(T.nilable(FinchAPI::Models::Location)) }
-        def location
-        end
+        attr_reader :location
 
-        sig { params(_: T.nilable(FinchAPI::Models::Location)).returns(T.nilable(FinchAPI::Models::Location)) }
-        def location=(_)
-        end
+        sig { params(location: T.nilable(T.any(FinchAPI::Models::Location, FinchAPI::Util::AnyHash))).void }
+        attr_writer :location
 
+        # The manager object representing the manager of the individual within the org.
         sig { returns(T.nilable(FinchAPI::Models::Sandbox::EmploymentUpdateParams::Manager)) }
-        def manager
-        end
+        attr_reader :manager
 
         sig do
-          params(_: T.nilable(FinchAPI::Models::Sandbox::EmploymentUpdateParams::Manager))
-            .returns(T.nilable(FinchAPI::Models::Sandbox::EmploymentUpdateParams::Manager))
-        end
-        def manager=(_)
+          params(
+            manager: T.nilable(T.any(FinchAPI::Models::Sandbox::EmploymentUpdateParams::Manager, FinchAPI::Util::AnyHash))
+          )
+            .void
         end
+        attr_writer :manager
 
+        # The legal middle name of the individual.
         sig { returns(T.nilable(String)) }
-        def middle_name
-        end
-
-        sig { params(_: T.nilable(String)).returns(T.nilable(String)) }
-        def middle_name=(_)
-        end
+        attr_accessor :middle_name
 
+        # The source system's unique employment identifier for this individual
         sig { returns(T.nilable(String)) }
-        def source_id
-        end
+        attr_reader :source_id
 
-        sig { params(_: String).returns(String) }
-        def source_id=(_)
-        end
+        sig { params(source_id: String).void }
+        attr_writer :source_id
 
         sig { returns(T.nilable(String)) }
-        def start_date
-        end
-
-        sig { params(_: T.nilable(String)).returns(T.nilable(String)) }
-        def start_date=(_)
-        end
+        attr_accessor :start_date
 
+        # The current title of the individual.
         sig { returns(T.nilable(String)) }
-        def title
-        end
-
-        sig { params(_: T.nilable(String)).returns(T.nilable(String)) }
-        def title=(_)
-        end
+        attr_accessor :title
 
         sig do
           params(
             class_code: T.nilable(String),
-            custom_fields: T::Array[FinchAPI::Models::Sandbox::EmploymentUpdateParams::CustomField],
-            department: T.nilable(FinchAPI::Models::Sandbox::EmploymentUpdateParams::Department),
-            employment: T.nilable(FinchAPI::Models::Sandbox::EmploymentUpdateParams::Employment),
-            employment_status: T.nilable(Symbol),
+            custom_fields: T::Array[T.any(FinchAPI::Models::Sandbox::EmploymentUpdateParams::CustomField, FinchAPI::Util::AnyHash)],
+            department: T.nilable(T.any(FinchAPI::Models::Sandbox::EmploymentUpdateParams::Department, FinchAPI::Util::AnyHash)),
+            employment: T.nilable(T.any(FinchAPI::Models::Sandbox::EmploymentUpdateParams::Employment, FinchAPI::Util::AnyHash)),
+            employment_status: T.nilable(FinchAPI::Models::Sandbox::EmploymentUpdateParams::EmploymentStatus::OrSymbol),
             end_date: T.nilable(String),
             first_name: T.nilable(String),
-            income: T.nilable(FinchAPI::Models::Income),
-            income_history: T.nilable(T::Array[T.nilable(FinchAPI::Models::Income)]),
+            income: T.nilable(T.any(FinchAPI::Models::Income, FinchAPI::Util::AnyHash)),
+            income_history: T.nilable(T::Array[T.nilable(T.any(FinchAPI::Models::Income, FinchAPI::Util::AnyHash))]),
             is_active: T.nilable(T::Boolean),
             last_name: T.nilable(String),
             latest_rehire_date: T.nilable(String),
-            location: T.nilable(FinchAPI::Models::Location),
-            manager: T.nilable(FinchAPI::Models::Sandbox::EmploymentUpdateParams::Manager),
+            location: T.nilable(T.any(FinchAPI::Models::Location, FinchAPI::Util::AnyHash)),
+            manager: T.nilable(T.any(FinchAPI::Models::Sandbox::EmploymentUpdateParams::Manager, FinchAPI::Util::AnyHash)),
             middle_name: T.nilable(String),
             source_id: String,
             start_date: T.nilable(String),
             title: T.nilable(String),
-            request_options: T.any(FinchAPI::RequestOptions, T::Hash[Symbol, T.anything])
+            request_options: T.any(FinchAPI::RequestOptions, FinchAPI::Util::AnyHash)
           )
-            .void
+            .returns(T.attached_class)
         end
-        def initialize(
+        def self.new(
           class_code: nil,
           custom_fields: nil,
           department: nil,
@@ -221,7 +175,7 @@ module FinchAPI
                 custom_fields: T::Array[FinchAPI::Models::Sandbox::EmploymentUpdateParams::CustomField],
                 department: T.nilable(FinchAPI::Models::Sandbox::EmploymentUpdateParams::Department),
                 employment: T.nilable(FinchAPI::Models::Sandbox::EmploymentUpdateParams::Employment),
-                employment_status: T.nilable(Symbol),
+                employment_status: T.nilable(FinchAPI::Models::Sandbox::EmploymentUpdateParams::EmploymentStatus::OrSymbol),
                 end_date: T.nilable(String),
                 first_name: T.nilable(String),
                 income: T.nilable(FinchAPI::Models::Income),
@@ -244,23 +198,16 @@ module FinchAPI
 
         class CustomField < FinchAPI::BaseModel
           sig { returns(T.nilable(String)) }
-          def name
-          end
-
-          sig { params(_: T.nilable(String)).returns(T.nilable(String)) }
-          def name=(_)
-          end
+          attr_accessor :name
 
           sig { returns(T.nilable(T.anything)) }
-          def value
-          end
+          attr_reader :value
 
-          sig { params(_: T.anything).returns(T.anything) }
-          def value=(_)
-          end
+          sig { params(value: T.anything).void }
+          attr_writer :value
 
-          sig { params(name: T.nilable(String), value: T.anything).void }
-          def initialize(name: nil, value: nil)
+          sig { params(name: T.nilable(String), value: T.anything).returns(T.attached_class) }
+          def self.new(name: nil, value: nil)
           end
 
           sig { override.returns({name: T.nilable(String), value: T.anything}) }
@@ -269,16 +216,13 @@ module FinchAPI
         end
 
         class Department < FinchAPI::BaseModel
+          # The name of the department associated with the individual.
           sig { returns(T.nilable(String)) }
-          def name
-          end
-
-          sig { params(_: T.nilable(String)).returns(T.nilable(String)) }
-          def name=(_)
-          end
+          attr_accessor :name
 
-          sig { params(name: T.nilable(String)).void }
-          def initialize(name: nil)
+          # The department object.
+          sig { params(name: T.nilable(String)).returns(T.attached_class) }
+          def self.new(name: nil)
           end
 
           sig { override.returns({name: T.nilable(String)}) }
@@ -287,84 +231,136 @@ module FinchAPI
         end
 
         class Employment < FinchAPI::BaseModel
-          sig { returns(T.nilable(Symbol)) }
-          def subtype
-          end
-
-          sig { params(_: T.nilable(Symbol)).returns(T.nilable(Symbol)) }
-          def subtype=(_)
-          end
-
-          sig { returns(T.nilable(Symbol)) }
-          def type
+          # The secondary employment type of the individual. Options: `full_time`,
+          #   `part_time`, `intern`, `temp`, `seasonal` and `individual_contractor`.
+          sig { returns(T.nilable(FinchAPI::Models::Sandbox::EmploymentUpdateParams::Employment::Subtype::OrSymbol)) }
+          attr_accessor :subtype
+
+          # The main employment type of the individual.
+          sig { returns(T.nilable(FinchAPI::Models::Sandbox::EmploymentUpdateParams::Employment::Type::OrSymbol)) }
+          attr_accessor :type
+
+          # The employment object.
+          sig do
+            params(
+              subtype: T.nilable(FinchAPI::Models::Sandbox::EmploymentUpdateParams::Employment::Subtype::OrSymbol),
+              type: T.nilable(FinchAPI::Models::Sandbox::EmploymentUpdateParams::Employment::Type::OrSymbol)
+            )
+              .returns(T.attached_class)
           end
-
-          sig { params(_: T.nilable(Symbol)).returns(T.nilable(Symbol)) }
-          def type=(_)
+          def self.new(subtype: nil, type: nil)
           end
 
-          sig { params(subtype: T.nilable(Symbol), type: T.nilable(Symbol)).void }
-          def initialize(subtype: nil, type: nil)
+          sig do
+            override
+              .returns(
+                {
+                  subtype: T.nilable(FinchAPI::Models::Sandbox::EmploymentUpdateParams::Employment::Subtype::OrSymbol),
+                  type: T.nilable(FinchAPI::Models::Sandbox::EmploymentUpdateParams::Employment::Type::OrSymbol)
+                }
+              )
           end
-
-          sig { override.returns({subtype: T.nilable(Symbol), type: T.nilable(Symbol)}) }
           def to_hash
           end
 
-          class Subtype < FinchAPI::Enum
-            abstract!
-
-            FULL_TIME = T.let(:full_time, T.nilable(Symbol))
-            INTERN = T.let(:intern, T.nilable(Symbol))
-            PART_TIME = T.let(:part_time, T.nilable(Symbol))
-            TEMP = T.let(:temp, T.nilable(Symbol))
-            SEASONAL = T.let(:seasonal, T.nilable(Symbol))
-            INDIVIDUAL_CONTRACTOR = T.let(:individual_contractor, T.nilable(Symbol))
-
-            sig { override.returns(T::Array[Symbol]) }
+          # The secondary employment type of the individual. Options: `full_time`,
+          #   `part_time`, `intern`, `temp`, `seasonal` and `individual_contractor`.
+          module Subtype
+            extend FinchAPI::Enum
+
+            TaggedSymbol =
+              T.type_alias { T.all(Symbol, FinchAPI::Models::Sandbox::EmploymentUpdateParams::Employment::Subtype) }
+            OrSymbol =
+              T.type_alias { T.any(Symbol, FinchAPI::Models::Sandbox::EmploymentUpdateParams::Employment::Subtype::TaggedSymbol) }
+
+            FULL_TIME =
+              T.let(:full_time, FinchAPI::Models::Sandbox::EmploymentUpdateParams::Employment::Subtype::TaggedSymbol)
+            INTERN =
+              T.let(:intern, FinchAPI::Models::Sandbox::EmploymentUpdateParams::Employment::Subtype::TaggedSymbol)
+            PART_TIME =
+              T.let(:part_time, FinchAPI::Models::Sandbox::EmploymentUpdateParams::Employment::Subtype::TaggedSymbol)
+            TEMP = T.let(:temp, FinchAPI::Models::Sandbox::EmploymentUpdateParams::Employment::Subtype::TaggedSymbol)
+            SEASONAL =
+              T.let(:seasonal, FinchAPI::Models::Sandbox::EmploymentUpdateParams::Employment::Subtype::TaggedSymbol)
+            INDIVIDUAL_CONTRACTOR =
+              T.let(
+                :individual_contractor,
+                FinchAPI::Models::Sandbox::EmploymentUpdateParams::Employment::Subtype::TaggedSymbol
+              )
+
+            sig do
+              override
+                .returns(T::Array[FinchAPI::Models::Sandbox::EmploymentUpdateParams::Employment::Subtype::TaggedSymbol])
+            end
             def self.values
             end
           end
 
-          class Type < FinchAPI::Enum
-            abstract!
+          # The main employment type of the individual.
+          module Type
+            extend FinchAPI::Enum
+
+            TaggedSymbol =
+              T.type_alias { T.all(Symbol, FinchAPI::Models::Sandbox::EmploymentUpdateParams::Employment::Type) }
+            OrSymbol =
+              T.type_alias { T.any(Symbol, FinchAPI::Models::Sandbox::EmploymentUpdateParams::Employment::Type::TaggedSymbol) }
 
-            EMPLOYEE = T.let(:employee, T.nilable(Symbol))
-            CONTRACTOR = T.let(:contractor, T.nilable(Symbol))
+            EMPLOYEE =
+              T.let(:employee, FinchAPI::Models::Sandbox::EmploymentUpdateParams::Employment::Type::TaggedSymbol)
+            CONTRACTOR =
+              T.let(:contractor, FinchAPI::Models::Sandbox::EmploymentUpdateParams::Employment::Type::TaggedSymbol)
 
-            sig { override.returns(T::Array[Symbol]) }
+            sig do
+              override
+                .returns(T::Array[FinchAPI::Models::Sandbox::EmploymentUpdateParams::Employment::Type::TaggedSymbol])
+            end
             def self.values
             end
           end
         end
 
-        class EmploymentStatus < FinchAPI::Enum
-          abstract!
-
-          ACTIVE = T.let(:active, T.nilable(Symbol))
-          DECEASED = T.let(:deceased, T.nilable(Symbol))
-          LEAVE = T.let(:leave, T.nilable(Symbol))
-          ONBOARDING = T.let(:onboarding, T.nilable(Symbol))
-          PREHIRE = T.let(:prehire, T.nilable(Symbol))
-          RETIRED = T.let(:retired, T.nilable(Symbol))
-          TERMINATED = T.let(:terminated, T.nilable(Symbol))
-
-          sig { override.returns(T::Array[Symbol]) }
+        # The detailed employment status of the individual.
+        module EmploymentStatus
+          extend FinchAPI::Enum
+
+          TaggedSymbol =
+            T.type_alias { T.all(Symbol, FinchAPI::Models::Sandbox::EmploymentUpdateParams::EmploymentStatus) }
+          OrSymbol =
+            T.type_alias { T.any(Symbol, FinchAPI::Models::Sandbox::EmploymentUpdateParams::EmploymentStatus::TaggedSymbol) }
+
+          ACTIVE =
+            T.let(:active, FinchAPI::Models::Sandbox::EmploymentUpdateParams::EmploymentStatus::TaggedSymbol)
+          DECEASED =
+            T.let(:deceased, FinchAPI::Models::Sandbox::EmploymentUpdateParams::EmploymentStatus::TaggedSymbol)
+          LEAVE = T.let(:leave, FinchAPI::Models::Sandbox::EmploymentUpdateParams::EmploymentStatus::TaggedSymbol)
+          ONBOARDING =
+            T.let(:onboarding, FinchAPI::Models::Sandbox::EmploymentUpdateParams::EmploymentStatus::TaggedSymbol)
+          PREHIRE =
+            T.let(:prehire, FinchAPI::Models::Sandbox::EmploymentUpdateParams::EmploymentStatus::TaggedSymbol)
+          RETIRED =
+            T.let(:retired, FinchAPI::Models::Sandbox::EmploymentUpdateParams::EmploymentStatus::TaggedSymbol)
+          TERMINATED =
+            T.let(:terminated, FinchAPI::Models::Sandbox::EmploymentUpdateParams::EmploymentStatus::TaggedSymbol)
+
+          sig do
+            override
+              .returns(T::Array[FinchAPI::Models::Sandbox::EmploymentUpdateParams::EmploymentStatus::TaggedSymbol])
+          end
           def self.values
           end
         end
 
         class Manager < FinchAPI::BaseModel
+          # A stable Finch `id` (UUID v4) for an individual in the company.
           sig { returns(T.nilable(String)) }
-          def id
-          end
-
-          sig { params(_: String).returns(String) }
-          def id=(_)
-          end
+          attr_reader :id
 
           sig { params(id: String).void }
-          def initialize(id: nil)
+          attr_writer :id
+
+          # The manager object representing the manager of the individual within the org.
+          sig { params(id: String).returns(T.attached_class) }
+          def self.new(id: nil)
           end
 
           sig { override.returns({id: String}) }