vitable-connect 0.5.0 → 1.0.0

data/lib/vitable_connect/resources/groups.rb

@@ -1,114 +0,0 @@
-# frozen_string_literal: true
-
-module VitableConnect
-  module Resources
-    class Groups
-      # @return [VitableConnect::Resources::Groups::Members]
-      attr_reader :members
-
-      # Creates a new group scoped to the authenticated organization.
-      #
-      # @overload create(external_reference_id:, name:, request_options: {})
-      #
-      # @param external_reference_id [String]
-      # @param name [String]
-      # @param request_options [VitableConnect::RequestOptions, Hash{Symbol=>Object}, nil]
-      #
-      # @return [VitableConnect::Models::GroupResponse]
-      #
-      # @see VitableConnect::Models::GroupCreateParams
-      def create(params)
-        parsed, options = VitableConnect::GroupCreateParams.dump_request(params)
-        @client.request(
-          method: :post,
-          path: "v1/groups",
-          body: parsed,
-          model: VitableConnect::GroupResponse,
-          options: options
-        )
-      end
-
-      # Retrieves a single group by its prefixed ID. Returns 404 if the group does not
-      # belong to the authenticated organization.
-      #
-      # @overload retrieve(group_id, request_options: {})
-      #
-      # @param group_id [String] Unique group identifier (grp\_\*)
-      #
-      # @param request_options [VitableConnect::RequestOptions, Hash{Symbol=>Object}, nil]
-      #
-      # @return [VitableConnect::Models::GroupResponse]
-      #
-      # @see VitableConnect::Models::GroupRetrieveParams
-      def retrieve(group_id, params = {})
-        @client.request(
-          method: :get,
-          path: ["v1/groups/%1$s", group_id],
-          model: VitableConnect::GroupResponse,
-          options: params[:request_options]
-        )
-      end
-
-      # Partially updates a group's name or external reference ID. Returns 404 if the
-      # group does not belong to the authenticated organization.
-      #
-      # @overload update(group_id, external_reference_id: nil, name: nil, request_options: {})
-      #
-      # @param group_id [String] Unique group identifier (grp\_\*)
-      #
-      # @param external_reference_id [String, nil]
-      #
-      # @param name [String, nil]
-      #
-      # @param request_options [VitableConnect::RequestOptions, Hash{Symbol=>Object}, nil]
-      #
-      # @return [VitableConnect::Models::GroupResponse]
-      #
-      # @see VitableConnect::Models::GroupUpdateParams
-      def update(group_id, params = {})
-        parsed, options = VitableConnect::GroupUpdateParams.dump_request(params)
-        @client.request(
-          method: :patch,
-          path: ["v1/groups/%1$s", group_id],
-          body: parsed,
-          model: VitableConnect::GroupResponse,
-          options: options
-        )
-      end
-
-      # Returns a paginated list of groups belonging to the authenticated organization.
-      #
-      # @overload list(limit: nil, page: nil, request_options: {})
-      #
-      # @param limit [Integer] Items per page (default: 20, max: 100)
-      #
-      # @param page [Integer] Page number (default: 1)
-      #
-      # @param request_options [VitableConnect::RequestOptions, Hash{Symbol=>Object}, nil]
-      #
-      # @return [VitableConnect::Internal::PageNumberPage<VitableConnect::Models::Group>]
-      #
-      # @see VitableConnect::Models::GroupListParams
-      def list(params = {})
-        parsed, options = VitableConnect::GroupListParams.dump_request(params)
-        query = VitableConnect::Internal::Util.encode_query_params(parsed)
-        @client.request(
-          method: :get,
-          path: "v1/groups",
-          query: query,
-          page: VitableConnect::Internal::PageNumberPage,
-          model: VitableConnect::Group,
-          options: options
-        )
-      end
-
-      # @api private
-      #
-      # @param client [VitableConnect::Client]
-      def initialize(client:)
-        @client = client
-        @members = VitableConnect::Resources::Groups::Members.new(client: client)
-      end
-    end
-  end
-end

data/lib/vitable_connect/resources/plans.rb

@@ -1,41 +0,0 @@
-# frozen_string_literal: true
-
-module VitableConnect
-  module Resources
-    class Plans
-      # Returns a paginated list of benefit plans linked to the authenticated
-      # organization.
-      #
-      # @overload list(limit: nil, page: nil, request_options: {})
-      #
-      # @param limit [Integer] Items per page (default: 20, max: 100)
-      #
-      # @param page [Integer] Page number (default: 1)
-      #
-      # @param request_options [VitableConnect::RequestOptions, Hash{Symbol=>Object}, nil]
-      #
-      # @return [VitableConnect::Internal::PageNumberPage<VitableConnect::Models::PlanListResponse>]
-      #
-      # @see VitableConnect::Models::PlanListParams
-      def list(params = {})
-        parsed, options = VitableConnect::PlanListParams.dump_request(params)
-        query = VitableConnect::Internal::Util.encode_query_params(parsed)
-        @client.request(
-          method: :get,
-          path: "v1/plans",
-          query: query,
-          page: VitableConnect::Internal::PageNumberPage,
-          model: VitableConnect::Models::PlanListResponse,
-          options: options
-        )
-      end
-
-      # @api private
-      #
-      # @param client [VitableConnect::Client]
-      def initialize(client:)
-        @client = client
-      end
-    end
-  end
-end

data/lib/vitable_connect/resources/webhook_events.rb

@@ -1,95 +0,0 @@
-# frozen_string_literal: true
-
-module VitableConnect
-  module Resources
-    class WebhookEvents
-      # Retrieves a single webhook event by its prefixed ID. Returns 404 if the event
-      # does not exist or belongs to a different organization.
-      #
-      # @overload retrieve(event_id, request_options: {})
-      #
-      # @param event_id [String]
-      # @param request_options [VitableConnect::RequestOptions, Hash{Symbol=>Object}, nil]
-      #
-      # @return [VitableConnect::Models::WebhookEventRetrieveResponse]
-      #
-      # @see VitableConnect::Models::WebhookEventRetrieveParams
-      def retrieve(event_id, params = {})
-        @client.request(
-          method: :get,
-          path: ["v1/webhook-events/%1$s", event_id],
-          model: VitableConnect::Models::WebhookEventRetrieveResponse,
-          options: params[:request_options]
-        )
-      end
-
-      # Some parameter documentations has been truncated, see
-      # {VitableConnect::Models::WebhookEventListParams} for more details.
-      #
-      # Retrieves a paginated list of webhook events for the authenticated organization.
-      # Supports filtering by event name, resource type, resource ID, and date range.
-      #
-      # @overload list(created_after: nil, created_before: nil, event_name: nil, limit: nil, page: nil, resource_id: nil, resource_type: nil, request_options: {})
-      #
-      # @param created_after [Time]
-      #
-      # @param created_before [Time]
-      #
-      # @param event_name [Symbol, VitableConnect::Models::WebhookEventListParams::EventName] - `enrollment.accepted` - Enrollment Accepted
-      #
-      # @param limit [Integer] Items per page (default: 20, max: 100)
-      #
-      # @param page [Integer] Page number (default: 1)
-      #
-      # @param resource_id [String]
-      #
-      # @param resource_type [Symbol, VitableConnect::Models::WebhookEventListParams::ResourceType] - `enrollment` - Enrollment
-      #
-      # @param request_options [VitableConnect::RequestOptions, Hash{Symbol=>Object}, nil]
-      #
-      # @return [VitableConnect::Internal::PageNumberPage<VitableConnect::Models::WebhookEvent>]
-      #
-      # @see VitableConnect::Models::WebhookEventListParams
-      def list(params = {})
-        parsed, options = VitableConnect::WebhookEventListParams.dump_request(params)
-        query = VitableConnect::Internal::Util.encode_query_params(parsed)
-        @client.request(
-          method: :get,
-          path: "v1/webhook-events",
-          query: query,
-          page: VitableConnect::Internal::PageNumberPage,
-          model: VitableConnect::WebhookEvent,
-          options: options
-        )
-      end
-
-      # Retrieves all delivery attempts for a webhook event. Returns up to 100
-      # deliveries. Each delivery includes a computed status field (Pending, In
-      # Progress, Delivered, or Failed).
-      #
-      # @overload list_deliveries(event_id, request_options: {})
-      #
-      # @param event_id [String]
-      # @param request_options [VitableConnect::RequestOptions, Hash{Symbol=>Object}, nil]
-      #
-      # @return [VitableConnect::Models::WebhookEventListDeliveriesResponse]
-      #
-      # @see VitableConnect::Models::WebhookEventListDeliveriesParams
-      def list_deliveries(event_id, params = {})
-        @client.request(
-          method: :get,
-          path: ["v1/webhook-events/%1$s/deliveries", event_id],
-          model: VitableConnect::Models::WebhookEventListDeliveriesResponse,
-          options: params[:request_options]
-        )
-      end
-
-      # @api private
-      #
-      # @param client [VitableConnect::Client]
-      def initialize(client:)
-        @client = client
-      end
-    end
-  end
-end

data/manifest.yaml

@@ -1,17 +0,0 @@
-dependencies:
-  - English
-  - base64
-  - cgi
-  - date
-  - erb
-  - etc
-  - json
-  - net/http
-  - openssl
-  - pathname
-  - rbconfig
-  - securerandom
-  - set
-  - stringio
-  - time
-  - uri

data/rbi/vitable_connect/client.rbi

@@ -1,93 +0,0 @@
-# typed: strong
-
-module VitableConnect
-  class Client < VitableConnect::Internal::Transport::BaseClient
-    DEFAULT_MAX_RETRIES = 2
-
-    DEFAULT_TIMEOUT_IN_SECONDS = T.let(60.0, Float)
-
-    DEFAULT_INITIAL_RETRY_DELAY = T.let(0.5, Float)
-
-    DEFAULT_MAX_RETRY_DELAY = T.let(8.0, Float)
-
-    ENVIRONMENTS =
-      T.let(
-        {
-          production: "https://api.vitablehealth.com",
-          environment_1: "https://api.uat.vitablehealth.com"
-        },
-        T::Hash[Symbol, String]
-      )
-
-    # API Key or Access Token authentication using Bearer token in Authorization
-    # header. API keys use the vit*apk* prefix, access tokens use the vit*at* prefix.
-    sig { returns(String) }
-    attr_reader :api_key
-
-    # Issue short-lived access tokens for scoped API access
-    sig { returns(VitableConnect::Resources::Auth) }
-    attr_reader :auth
-
-    sig { returns(VitableConnect::Resources::BenefitEligibilityPolicies) }
-    attr_reader :benefit_eligibility_policies
-
-    sig { returns(VitableConnect::Resources::Employees) }
-    attr_reader :employees
-
-    sig { returns(VitableConnect::Resources::Employers) }
-    attr_reader :employers
-
-    # Manage benefit enrollments and elections for employees
-    sig { returns(VitableConnect::Resources::Enrollments) }
-    attr_reader :enrollments
-
-    sig { returns(VitableConnect::Resources::WebhookEvents) }
-    attr_reader :webhook_events
-
-    sig { returns(VitableConnect::Resources::Groups) }
-    attr_reader :groups
-
-    sig { returns(VitableConnect::Resources::Plans) }
-    attr_reader :plans
-
-    # @api private
-    sig { override.returns(T::Hash[String, String]) }
-    private def auth_headers
-    end
-
-    # Creates and returns a new client for interacting with the API.
-    sig do
-      params(
-        api_key: T.nilable(String),
-        environment: T.nilable(T.any(Symbol, String)),
-        base_url: T.nilable(String),
-        max_retries: Integer,
-        timeout: Float,
-        initial_retry_delay: Float,
-        max_retry_delay: Float
-      ).returns(T.attached_class)
-    end
-    def self.new(
-      # API Key or Access Token authentication using Bearer token in Authorization
-      # header. API keys use the vit*apk* prefix, access tokens use the vit*at* prefix.
-      # Defaults to `ENV["VITABLE_CONNECT_API_KEY"]`
-      api_key: ENV["VITABLE_CONNECT_API_KEY"],
-      # Specifies the environment to use for the API.
-      #
-      # Each environment maps to a different base URL:
-      #
-      # - `production` corresponds to `https://api.vitablehealth.com`
-      # - `environment_1` corresponds to `https://api.uat.vitablehealth.com`
-      environment: nil,
-      # Override the default base URL for the API, e.g.,
-      # `"https://api.example.com/v2/"`. Defaults to `ENV["VITABLE_CONNECT_BASE_URL"]`
-      base_url: ENV["VITABLE_CONNECT_BASE_URL"],
-      # Max number of retries to attempt after a failed retryable request.
-      max_retries: VitableConnect::Client::DEFAULT_MAX_RETRIES,
-      timeout: VitableConnect::Client::DEFAULT_TIMEOUT_IN_SECONDS,
-      initial_retry_delay: VitableConnect::Client::DEFAULT_INITIAL_RETRY_DELAY,
-      max_retry_delay: VitableConnect::Client::DEFAULT_MAX_RETRY_DELAY
-    )
-    end
-  end
-end

data/rbi/vitable_connect/errors.rbi

@@ -1,205 +0,0 @@
-# typed: strong
-
-module VitableConnect
-  module Errors
-    class Error < StandardError
-      sig { returns(T.nilable(StandardError)) }
-      attr_accessor :cause
-    end
-
-    class ConversionError < VitableConnect::Errors::Error
-      sig { returns(T.nilable(StandardError)) }
-      def cause
-      end
-
-      # @api private
-      sig do
-        params(
-          on: T::Class[StandardError],
-          method: Symbol,
-          target: T.anything,
-          value: T.anything,
-          cause: T.nilable(StandardError)
-        ).returns(T.attached_class)
-      end
-      def self.new(on:, method:, target:, value:, cause: nil)
-      end
-    end
-
-    class APIError < VitableConnect::Errors::Error
-      sig { returns(URI::Generic) }
-      attr_accessor :url
-
-      sig { returns(T.nilable(Integer)) }
-      attr_accessor :status
-
-      sig { returns(T.nilable(T::Hash[String, String])) }
-      attr_accessor :headers
-
-      sig { returns(T.nilable(T.anything)) }
-      attr_accessor :body
-
-      # @api private
-      sig do
-        params(
-          url: URI::Generic,
-          status: T.nilable(Integer),
-          headers: T.nilable(T::Hash[String, String]),
-          body: T.nilable(Object),
-          request: NilClass,
-          response: NilClass,
-          message: T.nilable(String)
-        ).returns(T.attached_class)
-      end
-      def self.new(
-        url:,
-        status: nil,
-        headers: nil,
-        body: nil,
-        request: nil,
-        response: nil,
-        message: nil
-      )
-      end
-    end
-
-    class APIConnectionError < VitableConnect::Errors::APIError
-      sig { returns(NilClass) }
-      attr_accessor :status
-
-      sig { returns(NilClass) }
-      attr_accessor :body
-
-      # @api private
-      sig do
-        params(
-          url: URI::Generic,
-          status: NilClass,
-          headers: T.nilable(T::Hash[String, String]),
-          body: NilClass,
-          request: NilClass,
-          response: NilClass,
-          message: T.nilable(String)
-        ).returns(T.attached_class)
-      end
-      def self.new(
-        url:,
-        status: nil,
-        headers: nil,
-        body: nil,
-        request: nil,
-        response: nil,
-        message: "Connection error."
-      )
-      end
-    end
-
-    class APITimeoutError < VitableConnect::Errors::APIConnectionError
-      # @api private
-      sig do
-        params(
-          url: URI::Generic,
-          status: NilClass,
-          headers: T.nilable(T::Hash[String, String]),
-          body: NilClass,
-          request: NilClass,
-          response: NilClass,
-          message: T.nilable(String)
-        ).returns(T.attached_class)
-      end
-      def self.new(
-        url:,
-        status: nil,
-        headers: nil,
-        body: nil,
-        request: nil,
-        response: nil,
-        message: "Request timed out."
-      )
-      end
-    end
-
-    class APIStatusError < VitableConnect::Errors::APIError
-      # @api private
-      sig do
-        params(
-          url: URI::Generic,
-          status: Integer,
-          headers: T.nilable(T::Hash[String, String]),
-          body: T.nilable(Object),
-          request: NilClass,
-          response: NilClass,
-          message: T.nilable(String)
-        ).returns(T.attached_class)
-      end
-      def self.for(
-        url:,
-        status:,
-        headers:,
-        body:,
-        request:,
-        response:,
-        message: nil
-      )
-      end
-
-      sig { returns(Integer) }
-      attr_accessor :status
-
-      # @api private
-      sig do
-        params(
-          url: URI::Generic,
-          status: Integer,
-          headers: T.nilable(T::Hash[String, String]),
-          body: T.nilable(Object),
-          request: NilClass,
-          response: NilClass,
-          message: T.nilable(String)
-        ).returns(T.attached_class)
-      end
-      def self.new(
-        url:,
-        status:,
-        headers:,
-        body:,
-        request:,
-        response:,
-        message: nil
-      )
-      end
-    end
-
-    class BadRequestError < VitableConnect::Errors::APIStatusError
-      HTTP_STATUS = 400
-    end
-
-    class AuthenticationError < VitableConnect::Errors::APIStatusError
-      HTTP_STATUS = 401
-    end
-
-    class PermissionDeniedError < VitableConnect::Errors::APIStatusError
-      HTTP_STATUS = 403
-    end
-
-    class NotFoundError < VitableConnect::Errors::APIStatusError
-      HTTP_STATUS = 404
-    end
-
-    class ConflictError < VitableConnect::Errors::APIStatusError
-      HTTP_STATUS = 409
-    end
-
-    class UnprocessableEntityError < VitableConnect::Errors::APIStatusError
-      HTTP_STATUS = 422
-    end
-
-    class RateLimitError < VitableConnect::Errors::APIStatusError
-      HTTP_STATUS = 429
-    end
-
-    class InternalServerError < VitableConnect::Errors::APIStatusError
-      HTTP_STATUS = T.let((500..), T::Range[Integer])
-    end
-  end
-end

data/rbi/vitable_connect/file_part.rbi

@@ -1,37 +0,0 @@
-# typed: strong
-
-module VitableConnect
-  class FilePart
-    sig { returns(T.any(Pathname, StringIO, IO, String)) }
-    attr_reader :content
-
-    sig { returns(T.nilable(String)) }
-    attr_reader :content_type
-
-    sig { returns(T.nilable(String)) }
-    attr_reader :filename
-
-    # @api private
-    sig { returns(String) }
-    private def read
-    end
-
-    sig { params(a: T.anything).returns(String) }
-    def to_json(*a)
-    end
-
-    sig { params(a: T.anything).returns(String) }
-    def to_yaml(*a)
-    end
-
-    sig do
-      params(
-        content: T.any(Pathname, StringIO, IO, String),
-        filename: T.nilable(T.any(Pathname, String)),
-        content_type: T.nilable(String)
-      ).returns(T.attached_class)
-    end
-    def self.new(content, filename: nil, content_type: nil)
-    end
-  end
-end

data/rbi/vitable_connect/internal/page_number_page.rbi

@@ -1,49 +0,0 @@
-# typed: strong
-
-module VitableConnect
-  module Internal
-    class PageNumberPage
-      include VitableConnect::Internal::Type::BasePage
-
-      Elem = type_member
-
-      sig { returns(T.nilable(T::Array[Elem])) }
-      attr_accessor :data
-
-      sig { returns(Pagination) }
-      attr_accessor :pagination
-
-      # @api private
-      sig { returns(String) }
-      def inspect
-      end
-
-      class Pagination < VitableConnect::Internal::Type::BaseModel
-        OrHash =
-          T.type_alias { T.any(Pagination, VitableConnect::Internal::AnyHash) }
-
-        sig { returns(T.nilable(Integer)) }
-        attr_reader :page
-
-        sig { params(page: Integer).void }
-        attr_writer :page
-
-        sig { returns(T.nilable(Integer)) }
-        attr_reader :total_pages
-
-        sig { params(total_pages: Integer).void }
-        attr_writer :total_pages
-
-        sig do
-          params(page: Integer, total_pages: Integer).returns(T.attached_class)
-        end
-        def self.new(page: nil, total_pages: nil)
-        end
-
-        sig { override.returns({ page: Integer, total_pages: Integer }) }
-        def to_hash
-        end
-      end
-    end
-  end
-end