vitable-connect 0.4.0 → 0.6.0

data/rbi/vitable_connect/resources/enrollments.rbi

@@ -18,6 +18,67 @@ module VitableConnect
       )
       end
 
+      # Closes the targeted enrollment and creates a new unanswered enrollment for the
+      # same member and plan year. VPC never requires a qualifying life event; other
+      # products require an accepted, member-owned event outside open enrollment.
+      # User-backed callers must provide a reason; it is optional for userless
+      # organization callers. API keys and unbound access tokens may act across the
+      # caller organization's book. Employer-bound access tokens may act only on that
+      # employer's enrollments, and employee-bound access tokens may act only on that
+      # employee's enrollment. Tenant or token-scope mismatches return the same
+      # non-disclosing 404 before the request body is validated.
+      sig do
+        params(
+          enrollment_id: String,
+          qualifying_life_event_id: T.nilable(String),
+          reason: T.nilable(String),
+          ticket_number: T.nilable(String),
+          request_options: VitableConnect::RequestOptions::OrHash
+        ).returns(VitableConnect::Models::EnrollmentReissueResponse)
+      end
+      def reissue(
+        # Unique enrollment identifier (enrl\_\*)
+        enrollment_id,
+        # Accepted member qualifying life event identifier (qle\_\*)
+        qualifying_life_event_id: nil,
+        # Audit reason for the reissue; required for user-backed callers and optional for
+        # userless organization callers
+        reason: nil,
+        # Optional support or operational ticket number
+        ticket_number: nil,
+        request_options: {}
+      )
+      end
+
+      # Terminates enrolled coverage immediately. An accepted qualifying life event
+      # owned by the enrollment member is required unless the plan is VPC or ICHRA.
+      # User-backed callers must provide a reason; it is optional for userless
+      # organization callers. API keys may act across the caller organization's book.
+      # Tenant mismatches return the same non-disclosing 404 before the request body is
+      # validated.
+      sig do
+        params(
+          enrollment_id: String,
+          qualifying_life_event_id: T.nilable(String),
+          reason: T.nilable(String),
+          ticket_number: T.nilable(String),
+          request_options: VitableConnect::RequestOptions::OrHash
+        ).void
+      end
+      def terminate(
+        # Unique enrollment identifier (enrl\_\*)
+        enrollment_id,
+        # Accepted member qualifying life event identifier (qle\_\*)
+        qualifying_life_event_id: nil,
+        # Audit reason for the termination; required for user-backed callers and optional
+        # for userless organization callers
+        reason: nil,
+        # Optional support or operational ticket number
+        ticket_number: nil,
+        request_options: {}
+      )
+      end
+
       # @api private
       sig { params(client: VitableConnect::Client).returns(T.attached_class) }
       def self.new(client:)

data/rbi/vitable_connect/resources/members.rbi

@@ -0,0 +1,169 @@
+# typed: strong
+
+module VitableConnect
+  module Resources
+    # Browse the members covered across your book and read a member's profile
+    class Members
+      # Retrieves a member's profile by ID — identity, demographics, address, contact
+      # details, tobacco status, and profile status. Access is scoped to the
+      # authenticated principal; a member not visible to the caller returns a 404.
+      sig do
+        params(
+          member_id: String,
+          request_options: VitableConnect::RequestOptions::OrHash
+        ).returns(VitableConnect::Models::MemberRetrieveResponse)
+      end
+      def retrieve(member_id, request_options: {})
+      end
+
+      # Retrieves a paginated list of the members in the authenticated organization's
+      # book — identity, contact details, and address. The book covers members reached
+      # through an employer in the organization's book as well as members of a group it
+      # owns. Supports free-text search (name, email, or exact member id).
+      sig do
+        params(
+          limit: Integer,
+          page: Integer,
+          search: String,
+          request_options: VitableConnect::RequestOptions::OrHash
+        ).returns(
+          VitableConnect::Internal::PageNumberPage[
+            VitableConnect::Models::MemberListResponse
+          ]
+        )
+      end
+      def list(
+        # Items per page (default: 20, max: 100)
+        limit: nil,
+        # Page number (default: 1)
+        page: nil,
+        # Case-insensitive search across member name and email; exact match on member id
+        search: nil,
+        request_options: {}
+      )
+      end
+
+      # Lists a member's active legal dependents — name, relationship, date of birth,
+      # age, and sex at birth. Access is scoped to the authenticated principal; a member
+      # not visible to the caller returns a 404.
+      sig do
+        params(
+          member_id: String,
+          request_options: VitableConnect::RequestOptions::OrHash
+        ).returns(VitableConnect::Models::MemberListDependentsResponse)
+      end
+      def list_dependents(member_id, request_options: {})
+      end
+
+      # Lists a member's employment across every employer — the same employee record
+      # shape as the employer's employees list, plus the employer name. For an
+      # organization caller the rows are scoped to companies in that organization's
+      # book; a member (self/household) or Vitable Admin sees all employments. A member
+      # not visible to the caller returns a 404.
+      sig do
+        params(
+          member_id: String,
+          request_options: VitableConnect::RequestOptions::OrHash
+        ).returns(VitableConnect::Models::MemberListEmploymentsResponse)
+      end
+      def list_employments(member_id, request_options: {})
+      end
+
+      # Lists a member's benefit enrollments across every employer — benefit type and
+      # product, employer, carrier, plan, tier, employee deduction, employer
+      # contribution and total premium, the individual enrollment coverage boundary
+      # (`coverage_end`), the distinct benefit plan-year boundary
+      # (`plan_year_coverage_end`) used to determine whether the plan year itself has
+      # ended, whether a qualifying life event would currently be required for reissue
+      # under the product/open-enrollment rule, enrollment/open-enrollment window, and
+      # two statuses: `election_status` (what the member answered) and `policy_status`
+      # (what became of their coverage, null unless they enrolled). Every row includes a
+      # stable enrollment ID that can be used to target enrollment actions. The full
+      # list is returned across all states so the client derives active plans (effective
+      # and upcoming) and the enrollment history from those per-row statuses. For an
+      # organization caller the rows are scoped to companies in that organization's
+      # book; a member (self/household) or Vitable Admin sees all enrollments. A member
+      # not visible to the caller returns a 404.
+      sig do
+        params(
+          member_id: String,
+          request_options: VitableConnect::RequestOptions::OrHash
+        ).returns(VitableConnect::Models::MemberListEnrollmentsResponse)
+      end
+      def list_enrollments(member_id, request_options: {})
+      end
+
+      # Lists a member's benefit ID cards — card type (medical, dental, vision, or rx),
+      # employer, plan, provider network, claims payer, carrier contact details, and the
+      # disclaimers printed on the card. Medical, dental and vision cards come from the
+      # member's active digital benefit cards; the rx card from the member's Ventegra
+      # pharmacy benefit (omitted when the member has no free-medication coverage),
+      # which carries no plan, network, or carrier details. Access is scoped to the
+      # authenticated principal, and an organization caller sees only cards from
+      # employers in its book; a member not visible to the caller returns a 404.
+      sig do
+        params(
+          member_id: String,
+          request_options: VitableConnect::RequestOptions::OrHash
+        ).returns(VitableConnect::Models::MemberListIDCardsResponse)
+      end
+      def list_id_cards(member_id, request_options: {})
+      end
+
+      # Lists a member's qualifying life events, including events already used for
+      # another enrollment. Returns all statuses by default; pass the status query param
+      # to filter to one (e.g. approved). Events are ordered newest submission first
+      # with stable paging. Custom text is present only when submitted and is otherwise
+      # null. A member not visible to the caller returns a 404. API keys and unbound
+      # access tokens have organization-wide access. Employer-bound tokens require
+      # employment at the bound employer, and employee-bound tokens require the exact
+      # employee-member relationship. Organization or scope mismatches return a 404
+      # before pagination is validated.
+      sig do
+        params(
+          member_id: String,
+          limit: Integer,
+          page: Integer,
+          status:
+            VitableConnect::MemberListQualifyingLifeEventsParams::Status::OrSymbol,
+          request_options: VitableConnect::RequestOptions::OrHash
+        ).returns(
+          VitableConnect::Internal::PageNumberPage[
+            VitableConnect::Models::MemberListQualifyingLifeEventsResponse
+          ]
+        )
+      end
+      def list_qualifying_life_events(
+        # Unique member identifier (mbr\_\*)
+        member_id,
+        # Items per page (default: 20, max: 100)
+        limit: nil,
+        # Page number (default: 1)
+        page: nil,
+        # Optional. Filter to a single QLE status; omit to return all statuses.
+        status: nil,
+        request_options: {}
+      )
+      end
+
+      # Lists a member's household as a per-participant table — the account holder plus
+      # each active household member, with name, relationship, member type, date of
+      # birth, and household-admin flag. Access is scoped to the authenticated
+      # principal; a member not visible to the caller (or with no household) returns
+      # a 404.
+      sig do
+        params(
+          member_id: String,
+          request_options: VitableConnect::RequestOptions::OrHash
+        ).returns(VitableConnect::Models::MemberRetrieveHouseholdResponse)
+      end
+      def retrieve_household(member_id, request_options: {})
+      end
+
+      # @api private
+      sig { params(client: VitableConnect::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/vitable_connect/resources/organizations.rbi

@@ -0,0 +1,48 @@
+# typed: strong
+
+module VitableConnect
+  module Resources
+    class Organizations
+      # Onboards the authenticated user's partner Organization: creates the local
+      # Organization + the creator's admin membership atomically, then mirrors it to
+      # WorkOS (creates the WorkOS org and binds the creator as admin). 409
+      # `organization_already_exists` when the user already has an organization (v0: one
+      # organization per user).
+      sig do
+        params(
+          name: String,
+          type:
+            T.nilable(VitableConnect::OrganizationCreateParams::Type::OrSymbol),
+          request_options: VitableConnect::RequestOptions::OrHash
+        ).returns(VitableConnect::Models::OrganizationCreateResponse)
+      end
+      def create(
+        name:,
+        # - `BROKERAGE` - BROKERAGE
+        # - `TPA` - TPA
+        # - `GENERAL_AGENT` - GENERAL_AGENT
+        # - `CHANNEL_PARTNER` - CHANNEL_PARTNER
+        # - `CONSULTING_FIRM` - CONSULTING_FIRM
+        # - `API_PLATFORM` - API_PLATFORM
+        type: nil,
+        request_options: {}
+      )
+      end
+
+      # Lists the organizations the authenticated caller is an active member of
+      # (paginated). Returns an empty list when the caller belongs to no organizations.
+      sig do
+        params(request_options: VitableConnect::RequestOptions::OrHash).returns(
+          VitableConnect::Models::OrganizationListResponse
+        )
+      end
+      def list(request_options: {})
+      end
+
+      # @api private
+      sig { params(client: VitableConnect::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/vitable_connect/resources/webhook_events.rbi

@@ -37,6 +37,7 @@ module VitableConnect
         created_before: nil,
         # - `enrollment.accepted` - Enrollment Accepted
         # - `enrollment.terminated` - Enrollment Terminated
+        # - `enrollment.termination_rescheduled` - Enrollment Termination Rescheduled
         # - `enrollment.elected` - Enrollment Elected
         # - `enrollment.granted` - Enrollment Granted
         # - `enrollment.waived` - Enrollment Waived
@@ -44,7 +45,6 @@ module VitableConnect
         # - `employee.eligibility_granted` - Employee Eligibility Granted
         # - `employee.eligibility_terminated` - Employee Eligibility Terminated
         # - `employee.deactivated` - Employee Deactivated
-        # - `employer.eligibility_policy_created` - Employer Eligibility Policy Created
         # - `employee.deduction_created` - Employee Deduction Created
         event_name: nil,
         # Items per page (default: 20, max: 100)

data/sig/vitable_connect/client.rbs

@@ -17,8 +17,6 @@ module VitableConnect
 
     attr_reader auth: VitableConnect::Resources::Auth
 
-    attr_reader benefit_eligibility_policies: VitableConnect::Resources::BenefitEligibilityPolicies
-
     attr_reader employees: VitableConnect::Resources::Employees
 
     attr_reader employers: VitableConnect::Resources::Employers
@@ -29,9 +27,17 @@ module VitableConnect
 
     attr_reader groups: VitableConnect::Resources::Groups
 
+    attr_reader members: VitableConnect::Resources::Members
+
+    attr_reader organizations: VitableConnect::Resources::Organizations
+
     attr_reader plans: VitableConnect::Resources::Plans
 
-    private def auth_headers: -> ::Hash[String, String]
+    private def auth_headers: (
+      security: { api_key_auth: bool }
+    ) -> ::Hash[String, String]
+
+    private def api_key_auth: -> ::Hash[String, String]
 
     def initialize: (
       ?api_key: String?,

data/sig/vitable_connect/internal/transport/base_client.rbs

@@ -20,6 +20,7 @@ module VitableConnect
             page: Class?,
             stream: Class?,
             model: VitableConnect::Internal::Type::Converter::input?,
+            security: { api_key_auth: bool }?,
             options: VitableConnect::request_opts?
           }
         type request_input =
@@ -123,6 +124,7 @@ module VitableConnect
           ?page: Class?,
           ?stream: Class?,
           ?model: VitableConnect::Internal::Type::Converter::input?,
+          ?security: { api_key_auth: bool }?,
           ?options: VitableConnect::request_opts?
         ) -> top
 

data/sig/vitable_connect/models/auth_issue_access_token_params.rbs

@@ -37,19 +37,37 @@ module VitableConnect
         def self?.values: -> ::Array[VitableConnect::Models::AuthIssueAccessTokenParams::grant_type]
       end
 
-      type bound_entity = { id: String, type: VitableConnect::Models::type_ }
+      type bound_entity =
+        {
+          id: String,
+          type: VitableConnect::Models::AuthIssueAccessTokenParams::BoundEntity::type_
+        }
 
       class BoundEntity < VitableConnect::Internal::Type::BaseModel
         attr_accessor id: String
 
-        attr_accessor type: VitableConnect::Models::type_
+        attr_accessor type: VitableConnect::Models::AuthIssueAccessTokenParams::BoundEntity::type_
 
         def initialize: (
           id: String,
-          type: VitableConnect::Models::type_
+          type: VitableConnect::Models::AuthIssueAccessTokenParams::BoundEntity::type_
         ) -> void
 
-        def to_hash: -> { id: String, type: VitableConnect::Models::type_ }
+        def to_hash: -> {
+          id: String,
+          type: VitableConnect::Models::AuthIssueAccessTokenParams::BoundEntity::type_
+        }
+
+        type type_ = :employer | :employee
+
+        module Type
+          extend VitableConnect::Internal::Type::Enum
+
+          EMPLOYER: :employer
+          EMPLOYEE: :employee
+
+          def self?.values: -> ::Array[VitableConnect::Models::AuthIssueAccessTokenParams::BoundEntity::type_]
+        end
       end
     end
   end

data/sig/vitable_connect/models/auth_issue_access_token_response.rbs

@@ -31,19 +31,37 @@ module VitableConnect
         bound_entity: VitableConnect::Models::AuthIssueAccessTokenResponse::BoundEntity?
       }
 
-      type bound_entity = { id: String, type: VitableConnect::Models::type_ }
+      type bound_entity =
+        {
+          id: String,
+          type: VitableConnect::Models::AuthIssueAccessTokenResponse::BoundEntity::type_
+        }
 
       class BoundEntity < VitableConnect::Internal::Type::BaseModel
         attr_accessor id: String
 
-        attr_accessor type: VitableConnect::Models::type_
+        attr_accessor type: VitableConnect::Models::AuthIssueAccessTokenResponse::BoundEntity::type_
 
         def initialize: (
           id: String,
-          type: VitableConnect::Models::type_
+          type: VitableConnect::Models::AuthIssueAccessTokenResponse::BoundEntity::type_
         ) -> void
 
-        def to_hash: -> { id: String, type: VitableConnect::Models::type_ }
+        def to_hash: -> {
+          id: String,
+          type: VitableConnect::Models::AuthIssueAccessTokenResponse::BoundEntity::type_
+        }
+
+        type type_ = :employer | :employee
+
+        module Type
+          extend VitableConnect::Internal::Type::Enum
+
+          EMPLOYER: :employer
+          EMPLOYEE: :employee
+
+          def self?.values: -> ::Array[VitableConnect::Models::AuthIssueAccessTokenResponse::BoundEntity::type_]
+        end
       end
     end
   end

data/sig/vitable_connect/models/employee.rbs

@@ -3,20 +3,25 @@ module VitableConnect
     type employee =
       {
         id: String,
+        classification_effective_date: Date,
+        compensation_type: VitableConnect::Models::Employee::compensation_type?,
+        compensation_type_effective_date: Date,
         created_at: Time,
         date_of_birth: Date,
         deductions: ::Array[VitableConnect::Employee::Deduction],
         email: String,
+        employee_class: VitableConnect::Models::employee_class,
+        employer_id: String,
         first_name: String,
         last_name: String,
         member_id: String,
-        status: String,
+        phone: String?,
+        start_date: Date,
+        status: VitableConnect::Models::Employee::status,
         updated_at: Time,
         address: VitableConnect::Employee::Address?,
-        employee_class: VitableConnect::Models::employee_class?,
+        employer_name: String?,
         gender: String?,
-        hire_date: Date?,
-        phone: String?,
         reference_id: String?,
         suffix: String?,
         termination_date: Date?
@@ -31,6 +36,8 @@ module VitableConnect
 
       attr_accessor email: String
 
+      attr_accessor employee_class: VitableConnect::Models::employee_class
+
       attr_accessor first_name: String
 
       attr_accessor last_name: String
@@ -39,14 +46,10 @@ module VitableConnect
 
       attr_accessor address: VitableConnect::Employee::Address?
 
-      attr_accessor employee_class: VitableConnect::Models::employee_class?
+      attr_accessor employer_name: String?
 
       attr_accessor gender: String?
 
-      attr_accessor hire_date: Date?
-
-      attr_accessor phone: String?
-
       attr_accessor reference_id: String?
 
       attr_accessor suffix: String?
@@ -55,26 +58,43 @@ module VitableConnect
 
       attr_accessor id: String
 
+      attr_accessor classification_effective_date: Date
+
+      attr_accessor compensation_type: VitableConnect::Models::Employee::compensation_type?
+
+      attr_accessor compensation_type_effective_date: Date
+
+      attr_accessor employer_id: String
+
       attr_accessor member_id: String
 
-      attr_accessor status: String
+      attr_accessor phone: String?
+
+      attr_accessor start_date: Date
+
+      attr_accessor status: VitableConnect::Models::Employee::status
 
       def initialize: (
         id: String,
+        classification_effective_date: Date,
+        compensation_type: VitableConnect::Models::Employee::compensation_type?,
+        compensation_type_effective_date: Date,
         created_at: Time,
         date_of_birth: Date,
         deductions: ::Array[VitableConnect::Employee::Deduction],
         email: String,
+        employee_class: VitableConnect::Models::employee_class,
+        employer_id: String,
         first_name: String,
         last_name: String,
         member_id: String,
-        status: String,
+        phone: String?,
+        start_date: Date,
+        status: VitableConnect::Models::Employee::status,
         updated_at: Time,
         ?address: VitableConnect::Employee::Address?,
-        ?employee_class: VitableConnect::Models::employee_class?,
+        ?employer_name: String?,
         ?gender: String?,
-        ?hire_date: Date?,
-        ?phone: String?,
         ?reference_id: String?,
         ?suffix: String?,
         ?termination_date: Date?
@@ -82,25 +102,41 @@ module VitableConnect
 
       def to_hash: -> {
         id: String,
+        classification_effective_date: Date,
+        compensation_type: VitableConnect::Models::Employee::compensation_type?,
+        compensation_type_effective_date: Date,
         created_at: Time,
         date_of_birth: Date,
         deductions: ::Array[VitableConnect::Employee::Deduction],
         email: String,
+        employee_class: VitableConnect::Models::employee_class,
+        employer_id: String,
         first_name: String,
         last_name: String,
         member_id: String,
-        status: String,
+        phone: String?,
+        start_date: Date,
+        status: VitableConnect::Models::Employee::status,
         updated_at: Time,
         address: VitableConnect::Employee::Address?,
-        employee_class: VitableConnect::Models::employee_class?,
+        employer_name: String?,
         gender: String?,
-        hire_date: Date?,
-        phone: String?,
         reference_id: String?,
         suffix: String?,
         termination_date: Date?
       }
 
+      type compensation_type = :Salary | :Hourly
+
+      module CompensationType
+        extend VitableConnect::Internal::Type::Enum
+
+        SALARY: :Salary
+        HOURLY: :Hourly
+
+        def self?.values: -> ::Array[VitableConnect::Models::Employee::compensation_type]
+      end
+
       type deduction =
         {
           benefit_name: String,
@@ -173,6 +209,17 @@ module VitableConnect
         end
       end
 
+      type status = :active | :terminated
+
+      module Status
+        extend VitableConnect::Internal::Type::Enum
+
+        ACTIVE: :active
+        TERMINATED: :terminated
+
+        def self?.values: -> ::Array[VitableConnect::Models::Employee::status]
+      end
+
       type address =
         {
           :address_line_1 => String,