merge_ruby_client 0.0.3 → 0.1.0

data/lib/merge_ruby_client/hris/time_off/client.rb

@@ -20,12 +20,12 @@ require "async"
 module Merge
   module Hris
     class TimeOffClient
+      # @return [Merge::RequestClient]
       attr_reader :request_client
 
-      # @param request_client [RequestClient]
-      # @return [Hris::TimeOffClient]
+      # @param request_client [Merge::RequestClient]
+      # @return [Merge::Hris::TimeOffClient]
       def initialize(request_client:)
-        # @type [RequestClient]
         @request_client = request_client
       end
 
@@ -36,33 +36,51 @@ module Merge
       # @param created_before [DateTime] If provided, will only return objects created before this datetime.
       # @param cursor [String] The pagination cursor value.
       # @param employee_id [String] If provided, will only return time off for this employee.
-      # @param expand [TIME_OFF_LIST_REQUEST_EXPAND] Which relations should be returned in expanded form. Multiple relation names should be comma separated without spaces.
+      # @param ended_after [DateTime] If provided, will only return employees that ended after this datetime.
+      # @param ended_before [DateTime] If provided, will only return time-offs that ended before this datetime.
+      # @param expand [Merge::Hris::TimeOff::TimeOffListRequestExpand] Which relations should be returned in expanded form. Multiple relation names
+      #  should be comma separated without spaces.
       # @param include_deleted_data [Boolean] Whether to include data that was marked as deleted by third party webhooks.
-      # @param include_remote_data [Boolean] Whether to include the original data Merge fetched from the third-party to produce these models.
+      # @param include_remote_data [Boolean] Whether to include the original data Merge fetched from the third-party to
+      #  produce these models.
       # @param modified_after [DateTime] If provided, only objects synced by Merge after this date time will be returned.
-      # @param modified_before [DateTime] If provided, only objects synced by Merge before this date time will be returned.
+      # @param modified_before [DateTime] If provided, only objects synced by Merge before this date time will be
+      #  returned.
       # @param page_size [Integer] Number of results to return per page.
-      # @param remote_fields [TIME_OFF_LIST_REQUEST_REMOTE_FIELDS] Deprecated. Use show_enum_origins.
+      # @param remote_fields [Merge::Hris::TimeOff::TimeOffListRequestRemoteFields] Deprecated. Use show_enum_origins.
       # @param remote_id [String] The API provider's ID for the given object.
-      # @param request_type [TIME_OFF_LIST_REQUEST_REQUEST_TYPE] If provided, will only return TimeOff with this request type. Options: ('VACATION', 'SICK', 'PERSONAL', 'JURY_DUTY', 'VOLUNTEER', 'BEREAVEMENT')
-      #   - `VACATION` - VACATION
-      #   - `SICK` - SICK
-      #   - `PERSONAL` - PERSONAL
-      #   - `JURY_DUTY` - JURY_DUTY
-      #   - `VOLUNTEER` - VOLUNTEER
-      #   - `BEREAVEMENT` - BEREAVEMENT
-      # @param show_enum_origins [TIME_OFF_LIST_REQUEST_SHOW_ENUM_ORIGINS] Which fields should be returned in non-normalized form.
-      # @param status [TIME_OFF_LIST_REQUEST_STATUS] If provided, will only return TimeOff with this status. Options: ('REQUESTED', 'APPROVED', 'DECLINED', 'CANCELLED', 'DELETED')
-      #   - `REQUESTED` - REQUESTED
-      #   - `APPROVED` - APPROVED
-      #   - `DECLINED` - DECLINED
-      #   - `CANCELLED` - CANCELLED
-      #   - `DELETED` - DELETED
-      # @param request_options [RequestOptions]
-      # @return [Hris::PaginatedTimeOffList]
-      def list(approver_id: nil, created_after: nil, created_before: nil, cursor: nil, employee_id: nil, expand: nil,
-               include_deleted_data: nil, include_remote_data: nil, modified_after: nil, modified_before: nil, page_size: nil, remote_fields: nil, remote_id: nil, request_type: nil, show_enum_origins: nil, status: nil, request_options: nil)
-        response = @request_client.conn.get("/api/hris/v1/time-off") do |req|
+      # @param request_type [Merge::Hris::TimeOff::TimeOffListRequestRequestType] If provided, will only return TimeOff with this request type. Options:
+      #  ('VACATION', 'SICK', 'PERSONAL', 'JURY_DUTY', 'VOLUNTEER', 'BEREAVEMENT')
+      #  - `VACATION` - VACATION
+      #  - `SICK` - SICK
+      #  - `PERSONAL` - PERSONAL
+      #  - `JURY_DUTY` - JURY_DUTY
+      #  - `VOLUNTEER` - VOLUNTEER
+      #  - `BEREAVEMENT` - BEREAVEMENT
+      # @param show_enum_origins [Merge::Hris::TimeOff::TimeOffListRequestShowEnumOrigins] A comma separated list of enum field names for which you'd like the original
+      #  values to be returned, instead of Merge's normalized enum values. [Learn
+      #  e](https://help.merge.dev/en/articles/8950958-show_enum_origins-query-parameter)
+      # @param started_after [DateTime] If provided, will only return time-offs that started after this datetime.
+      # @param started_before [DateTime] If provided, will only return time-offs that started before this datetime.
+      # @param status [Merge::Hris::TimeOff::TimeOffListRequestStatus] If provided, will only return TimeOff with this status. Options: ('REQUESTED',
+      #  'APPROVED', 'DECLINED', 'CANCELLED', 'DELETED')
+      #  - `REQUESTED` - REQUESTED
+      #  - `APPROVED` - APPROVED
+      #  - `DECLINED` - DECLINED
+      #  - `CANCELLED` - CANCELLED
+      #  - `DELETED` - DELETED
+      # @param request_options [Merge::RequestOptions]
+      # @return [Merge::Hris::PaginatedTimeOffList]
+      # @example
+      #  api = Merge::Client.new(
+      #    environment: Environment::PRODUCTION,
+      #    base_url: "https://api.example.com",
+      #    api_key: "YOUR_AUTH_TOKEN"
+      #  )
+      #  api.hris.list
+      def list(approver_id: nil, created_after: nil, created_before: nil, cursor: nil, employee_id: nil,
+               ended_after: nil, ended_before: nil, expand: nil, include_deleted_data: nil, include_remote_data: nil, modified_after: nil, modified_before: nil, page_size: nil, remote_fields: nil, remote_id: nil, request_type: nil, show_enum_origins: nil, started_after: nil, started_before: nil, status: nil, request_options: nil)
+        response = @request_client.conn.get do |req|
           req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
           req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
           req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
@@ -74,6 +92,8 @@ module Merge
             "created_before": created_before,
             "cursor": cursor,
             "employee_id": employee_id,
+            "ended_after": ended_after,
+            "ended_before": ended_before,
             "expand": expand,
             "include_deleted_data": include_deleted_data,
             "include_remote_data": include_remote_data,
@@ -84,32 +104,42 @@ module Merge
             "remote_id": remote_id,
             "request_type": request_type,
             "show_enum_origins": show_enum_origins,
+            "started_after": started_after,
+            "started_before": started_before,
             "status": status
           }.compact
+          req.url "#{@request_client.get_url(request_options: request_options)}/hris/v1/time-off"
         end
-        Hris::PaginatedTimeOffList.from_json(json_object: response.body)
+        Merge::Hris::PaginatedTimeOffList.from_json(json_object: response.body)
       end
 
       # Creates a `TimeOff` object with the given values.
       #
       # @param is_debug_mode [Boolean] Whether to include debug fields (such as log file links) in the response.
       # @param run_async [Boolean] Whether or not third-party updates should be run asynchronously.
-      # @param model [Hash] Request of type Hris::TimeOffRequest, as a Hash
+      # @param model [Hash] Request of type Merge::Hris::TimeOffRequest, as a Hash
       #   * :employee (Hash)
       #   * :approver (Hash)
-      #   * :status (TIME_OFF_STATUS_ENUM)
+      #   * :status (Merge::Hris::TimeOffStatusEnum)
       #   * :employee_note (String)
-      #   * :units (UNITS_ENUM)
+      #   * :units (Merge::Hris::UnitsEnum)
       #   * :amount (Float)
-      #   * :request_type (REQUEST_TYPE_ENUM)
+      #   * :request_type (Merge::Hris::RequestTypeEnum)
       #   * :start_time (DateTime)
       #   * :end_time (DateTime)
-      #   * :integration_params (Hash{String => String})
-      #   * :linked_account_params (Hash{String => String})
-      # @param request_options [RequestOptions]
-      # @return [Hris::TimeOffResponse]
+      #   * :integration_params (Hash{String => Object})
+      #   * :linked_account_params (Hash{String => Object})
+      # @param request_options [Merge::RequestOptions]
+      # @return [Merge::Hris::TimeOffResponse]
+      # @example
+      #  api = Merge::Client.new(
+      #    environment: Environment::PRODUCTION,
+      #    base_url: "https://api.example.com",
+      #    api_key: "YOUR_AUTH_TOKEN"
+      #  )
+      #  api.hris.create(model: {  })
       def create(model:, is_debug_mode: nil, run_async: nil, request_options: nil)
-        response = @request_client.conn.post("/api/hris/v1/time-off") do |req|
+        response = @request_client.conn.post do |req|
           req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
           req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
           req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
@@ -120,22 +150,34 @@ module Merge
             "run_async": run_async
           }.compact
           req.body = { **(request_options&.additional_body_parameters || {}), model: model }.compact
+          req.url "#{@request_client.get_url(request_options: request_options)}/hris/v1/time-off"
         end
-        Hris::TimeOffResponse.from_json(json_object: response.body)
+        Merge::Hris::TimeOffResponse.from_json(json_object: response.body)
       end
 
       # Returns a `TimeOff` object with the given `id`.
       #
       # @param id [String]
-      # @param expand [TIME_OFF_RETRIEVE_REQUEST_EXPAND] Which relations should be returned in expanded form. Multiple relation names should be comma separated without spaces.
-      # @param include_remote_data [Boolean] Whether to include the original data Merge fetched from the third-party to produce these models.
-      # @param remote_fields [TIME_OFF_RETRIEVE_REQUEST_REMOTE_FIELDS] Deprecated. Use show_enum_origins.
-      # @param show_enum_origins [TIME_OFF_RETRIEVE_REQUEST_SHOW_ENUM_ORIGINS] Which fields should be returned in non-normalized form.
-      # @param request_options [RequestOptions]
-      # @return [Hris::TimeOff]
+      # @param expand [Merge::Hris::TimeOff::TimeOffRetrieveRequestExpand] Which relations should be returned in expanded form. Multiple relation names
+      #  should be comma separated without spaces.
+      # @param include_remote_data [Boolean] Whether to include the original data Merge fetched from the third-party to
+      #  produce these models.
+      # @param remote_fields [Merge::Hris::TimeOff::TimeOffRetrieveRequestRemoteFields] Deprecated. Use show_enum_origins.
+      # @param show_enum_origins [Merge::Hris::TimeOff::TimeOffRetrieveRequestShowEnumOrigins] A comma separated list of enum field names for which you'd like the original
+      #  values to be returned, instead of Merge's normalized enum values. [Learn
+      #  e](https://help.merge.dev/en/articles/8950958-show_enum_origins-query-parameter)
+      # @param request_options [Merge::RequestOptions]
+      # @return [Merge::Hris::TimeOff]
+      # @example
+      #  api = Merge::Client.new(
+      #    environment: Environment::PRODUCTION,
+      #    base_url: "https://api.example.com",
+      #    api_key: "YOUR_AUTH_TOKEN"
+      #  )
+      #  api.hris.retrieve(id: "id")
       def retrieve(id:, expand: nil, include_remote_data: nil, remote_fields: nil, show_enum_origins: nil,
                    request_options: nil)
-        response = @request_client.conn.get("/api/hris/v1/time-off/#{id}") do |req|
+        response = @request_client.conn.get do |req|
           req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
           req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
           req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
@@ -147,32 +189,41 @@ module Merge
             "remote_fields": remote_fields,
             "show_enum_origins": show_enum_origins
           }.compact
+          req.url "#{@request_client.get_url(request_options: request_options)}/hris/v1/time-off/#{id}"
         end
-        Hris::TimeOff.from_json(json_object: response.body)
+        Merge::Hris::TimeOff.from_json(json_object: response.body)
       end
 
       # Returns metadata for `TimeOff` POSTs.
       #
-      # @param request_options [RequestOptions]
-      # @return [Hris::MetaResponse]
+      # @param request_options [Merge::RequestOptions]
+      # @return [Merge::Hris::MetaResponse]
+      # @example
+      #  api = Merge::Client.new(
+      #    environment: Environment::PRODUCTION,
+      #    base_url: "https://api.example.com",
+      #    api_key: "YOUR_AUTH_TOKEN"
+      #  )
+      #  api.hris.meta_post_retrieve
       def meta_post_retrieve(request_options: nil)
-        response = @request_client.conn.get("/api/hris/v1/time-off/meta/post") do |req|
+        response = @request_client.conn.get do |req|
           req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
           req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
           req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
           req.headers = { **req.headers, **(request_options&.additional_headers || {}) }.compact
+          req.url "#{@request_client.get_url(request_options: request_options)}/hris/v1/time-off/meta/post"
         end
-        Hris::MetaResponse.from_json(json_object: response.body)
+        Merge::Hris::MetaResponse.from_json(json_object: response.body)
       end
     end
 
     class AsyncTimeOffClient
+      # @return [Merge::AsyncRequestClient]
       attr_reader :request_client
 
-      # @param request_client [AsyncRequestClient]
-      # @return [Hris::AsyncTimeOffClient]
+      # @param request_client [Merge::AsyncRequestClient]
+      # @return [Merge::Hris::AsyncTimeOffClient]
       def initialize(request_client:)
-        # @type [AsyncRequestClient]
         @request_client = request_client
       end
 
@@ -183,34 +234,52 @@ module Merge
       # @param created_before [DateTime] If provided, will only return objects created before this datetime.
       # @param cursor [String] The pagination cursor value.
       # @param employee_id [String] If provided, will only return time off for this employee.
-      # @param expand [TIME_OFF_LIST_REQUEST_EXPAND] Which relations should be returned in expanded form. Multiple relation names should be comma separated without spaces.
+      # @param ended_after [DateTime] If provided, will only return employees that ended after this datetime.
+      # @param ended_before [DateTime] If provided, will only return time-offs that ended before this datetime.
+      # @param expand [Merge::Hris::TimeOff::TimeOffListRequestExpand] Which relations should be returned in expanded form. Multiple relation names
+      #  should be comma separated without spaces.
       # @param include_deleted_data [Boolean] Whether to include data that was marked as deleted by third party webhooks.
-      # @param include_remote_data [Boolean] Whether to include the original data Merge fetched from the third-party to produce these models.
+      # @param include_remote_data [Boolean] Whether to include the original data Merge fetched from the third-party to
+      #  produce these models.
       # @param modified_after [DateTime] If provided, only objects synced by Merge after this date time will be returned.
-      # @param modified_before [DateTime] If provided, only objects synced by Merge before this date time will be returned.
+      # @param modified_before [DateTime] If provided, only objects synced by Merge before this date time will be
+      #  returned.
       # @param page_size [Integer] Number of results to return per page.
-      # @param remote_fields [TIME_OFF_LIST_REQUEST_REMOTE_FIELDS] Deprecated. Use show_enum_origins.
+      # @param remote_fields [Merge::Hris::TimeOff::TimeOffListRequestRemoteFields] Deprecated. Use show_enum_origins.
       # @param remote_id [String] The API provider's ID for the given object.
-      # @param request_type [TIME_OFF_LIST_REQUEST_REQUEST_TYPE] If provided, will only return TimeOff with this request type. Options: ('VACATION', 'SICK', 'PERSONAL', 'JURY_DUTY', 'VOLUNTEER', 'BEREAVEMENT')
-      #   - `VACATION` - VACATION
-      #   - `SICK` - SICK
-      #   - `PERSONAL` - PERSONAL
-      #   - `JURY_DUTY` - JURY_DUTY
-      #   - `VOLUNTEER` - VOLUNTEER
-      #   - `BEREAVEMENT` - BEREAVEMENT
-      # @param show_enum_origins [TIME_OFF_LIST_REQUEST_SHOW_ENUM_ORIGINS] Which fields should be returned in non-normalized form.
-      # @param status [TIME_OFF_LIST_REQUEST_STATUS] If provided, will only return TimeOff with this status. Options: ('REQUESTED', 'APPROVED', 'DECLINED', 'CANCELLED', 'DELETED')
-      #   - `REQUESTED` - REQUESTED
-      #   - `APPROVED` - APPROVED
-      #   - `DECLINED` - DECLINED
-      #   - `CANCELLED` - CANCELLED
-      #   - `DELETED` - DELETED
-      # @param request_options [RequestOptions]
-      # @return [Hris::PaginatedTimeOffList]
-      def list(approver_id: nil, created_after: nil, created_before: nil, cursor: nil, employee_id: nil, expand: nil,
-               include_deleted_data: nil, include_remote_data: nil, modified_after: nil, modified_before: nil, page_size: nil, remote_fields: nil, remote_id: nil, request_type: nil, show_enum_origins: nil, status: nil, request_options: nil)
+      # @param request_type [Merge::Hris::TimeOff::TimeOffListRequestRequestType] If provided, will only return TimeOff with this request type. Options:
+      #  ('VACATION', 'SICK', 'PERSONAL', 'JURY_DUTY', 'VOLUNTEER', 'BEREAVEMENT')
+      #  - `VACATION` - VACATION
+      #  - `SICK` - SICK
+      #  - `PERSONAL` - PERSONAL
+      #  - `JURY_DUTY` - JURY_DUTY
+      #  - `VOLUNTEER` - VOLUNTEER
+      #  - `BEREAVEMENT` - BEREAVEMENT
+      # @param show_enum_origins [Merge::Hris::TimeOff::TimeOffListRequestShowEnumOrigins] A comma separated list of enum field names for which you'd like the original
+      #  values to be returned, instead of Merge's normalized enum values. [Learn
+      #  e](https://help.merge.dev/en/articles/8950958-show_enum_origins-query-parameter)
+      # @param started_after [DateTime] If provided, will only return time-offs that started after this datetime.
+      # @param started_before [DateTime] If provided, will only return time-offs that started before this datetime.
+      # @param status [Merge::Hris::TimeOff::TimeOffListRequestStatus] If provided, will only return TimeOff with this status. Options: ('REQUESTED',
+      #  'APPROVED', 'DECLINED', 'CANCELLED', 'DELETED')
+      #  - `REQUESTED` - REQUESTED
+      #  - `APPROVED` - APPROVED
+      #  - `DECLINED` - DECLINED
+      #  - `CANCELLED` - CANCELLED
+      #  - `DELETED` - DELETED
+      # @param request_options [Merge::RequestOptions]
+      # @return [Merge::Hris::PaginatedTimeOffList]
+      # @example
+      #  api = Merge::Client.new(
+      #    environment: Environment::PRODUCTION,
+      #    base_url: "https://api.example.com",
+      #    api_key: "YOUR_AUTH_TOKEN"
+      #  )
+      #  api.hris.list
+      def list(approver_id: nil, created_after: nil, created_before: nil, cursor: nil, employee_id: nil,
+               ended_after: nil, ended_before: nil, expand: nil, include_deleted_data: nil, include_remote_data: nil, modified_after: nil, modified_before: nil, page_size: nil, remote_fields: nil, remote_id: nil, request_type: nil, show_enum_origins: nil, started_after: nil, started_before: nil, status: nil, request_options: nil)
         Async do
-          response = @request_client.conn.get("/api/hris/v1/time-off") do |req|
+          response = @request_client.conn.get do |req|
             req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
             req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
             req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
@@ -222,6 +291,8 @@ module Merge
               "created_before": created_before,
               "cursor": cursor,
               "employee_id": employee_id,
+              "ended_after": ended_after,
+              "ended_before": ended_before,
               "expand": expand,
               "include_deleted_data": include_deleted_data,
               "include_remote_data": include_remote_data,
@@ -232,10 +303,13 @@ module Merge
               "remote_id": remote_id,
               "request_type": request_type,
               "show_enum_origins": show_enum_origins,
+              "started_after": started_after,
+              "started_before": started_before,
               "status": status
             }.compact
+            req.url "#{@request_client.get_url(request_options: request_options)}/hris/v1/time-off"
           end
-          Hris::PaginatedTimeOffList.from_json(json_object: response.body)
+          Merge::Hris::PaginatedTimeOffList.from_json(json_object: response.body)
         end
       end
 
@@ -243,23 +317,30 @@ module Merge
       #
       # @param is_debug_mode [Boolean] Whether to include debug fields (such as log file links) in the response.
       # @param run_async [Boolean] Whether or not third-party updates should be run asynchronously.
-      # @param model [Hash] Request of type Hris::TimeOffRequest, as a Hash
+      # @param model [Hash] Request of type Merge::Hris::TimeOffRequest, as a Hash
       #   * :employee (Hash)
       #   * :approver (Hash)
-      #   * :status (TIME_OFF_STATUS_ENUM)
+      #   * :status (Merge::Hris::TimeOffStatusEnum)
       #   * :employee_note (String)
-      #   * :units (UNITS_ENUM)
+      #   * :units (Merge::Hris::UnitsEnum)
       #   * :amount (Float)
-      #   * :request_type (REQUEST_TYPE_ENUM)
+      #   * :request_type (Merge::Hris::RequestTypeEnum)
       #   * :start_time (DateTime)
       #   * :end_time (DateTime)
-      #   * :integration_params (Hash{String => String})
-      #   * :linked_account_params (Hash{String => String})
-      # @param request_options [RequestOptions]
-      # @return [Hris::TimeOffResponse]
+      #   * :integration_params (Hash{String => Object})
+      #   * :linked_account_params (Hash{String => Object})
+      # @param request_options [Merge::RequestOptions]
+      # @return [Merge::Hris::TimeOffResponse]
+      # @example
+      #  api = Merge::Client.new(
+      #    environment: Environment::PRODUCTION,
+      #    base_url: "https://api.example.com",
+      #    api_key: "YOUR_AUTH_TOKEN"
+      #  )
+      #  api.hris.create(model: {  })
       def create(model:, is_debug_mode: nil, run_async: nil, request_options: nil)
         Async do
-          response = @request_client.conn.post("/api/hris/v1/time-off") do |req|
+          response = @request_client.conn.post do |req|
             req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
             req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
             req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
@@ -270,24 +351,36 @@ module Merge
               "run_async": run_async
             }.compact
             req.body = { **(request_options&.additional_body_parameters || {}), model: model }.compact
+            req.url "#{@request_client.get_url(request_options: request_options)}/hris/v1/time-off"
           end
-          Hris::TimeOffResponse.from_json(json_object: response.body)
+          Merge::Hris::TimeOffResponse.from_json(json_object: response.body)
         end
       end
 
       # Returns a `TimeOff` object with the given `id`.
       #
       # @param id [String]
-      # @param expand [TIME_OFF_RETRIEVE_REQUEST_EXPAND] Which relations should be returned in expanded form. Multiple relation names should be comma separated without spaces.
-      # @param include_remote_data [Boolean] Whether to include the original data Merge fetched from the third-party to produce these models.
-      # @param remote_fields [TIME_OFF_RETRIEVE_REQUEST_REMOTE_FIELDS] Deprecated. Use show_enum_origins.
-      # @param show_enum_origins [TIME_OFF_RETRIEVE_REQUEST_SHOW_ENUM_ORIGINS] Which fields should be returned in non-normalized form.
-      # @param request_options [RequestOptions]
-      # @return [Hris::TimeOff]
+      # @param expand [Merge::Hris::TimeOff::TimeOffRetrieveRequestExpand] Which relations should be returned in expanded form. Multiple relation names
+      #  should be comma separated without spaces.
+      # @param include_remote_data [Boolean] Whether to include the original data Merge fetched from the third-party to
+      #  produce these models.
+      # @param remote_fields [Merge::Hris::TimeOff::TimeOffRetrieveRequestRemoteFields] Deprecated. Use show_enum_origins.
+      # @param show_enum_origins [Merge::Hris::TimeOff::TimeOffRetrieveRequestShowEnumOrigins] A comma separated list of enum field names for which you'd like the original
+      #  values to be returned, instead of Merge's normalized enum values. [Learn
+      #  e](https://help.merge.dev/en/articles/8950958-show_enum_origins-query-parameter)
+      # @param request_options [Merge::RequestOptions]
+      # @return [Merge::Hris::TimeOff]
+      # @example
+      #  api = Merge::Client.new(
+      #    environment: Environment::PRODUCTION,
+      #    base_url: "https://api.example.com",
+      #    api_key: "YOUR_AUTH_TOKEN"
+      #  )
+      #  api.hris.retrieve(id: "id")
       def retrieve(id:, expand: nil, include_remote_data: nil, remote_fields: nil, show_enum_origins: nil,
                    request_options: nil)
         Async do
-          response = @request_client.conn.get("/api/hris/v1/time-off/#{id}") do |req|
+          response = @request_client.conn.get do |req|
             req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
             req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
             req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
@@ -299,24 +392,33 @@ module Merge
               "remote_fields": remote_fields,
               "show_enum_origins": show_enum_origins
             }.compact
+            req.url "#{@request_client.get_url(request_options: request_options)}/hris/v1/time-off/#{id}"
           end
-          Hris::TimeOff.from_json(json_object: response.body)
+          Merge::Hris::TimeOff.from_json(json_object: response.body)
         end
       end
 
       # Returns metadata for `TimeOff` POSTs.
       #
-      # @param request_options [RequestOptions]
-      # @return [Hris::MetaResponse]
+      # @param request_options [Merge::RequestOptions]
+      # @return [Merge::Hris::MetaResponse]
+      # @example
+      #  api = Merge::Client.new(
+      #    environment: Environment::PRODUCTION,
+      #    base_url: "https://api.example.com",
+      #    api_key: "YOUR_AUTH_TOKEN"
+      #  )
+      #  api.hris.meta_post_retrieve
       def meta_post_retrieve(request_options: nil)
         Async do
-          response = @request_client.conn.get("/api/hris/v1/time-off/meta/post") do |req|
+          response = @request_client.conn.get do |req|
             req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
             req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
             req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
             req.headers = { **req.headers, **(request_options&.additional_headers || {}) }.compact
+            req.url "#{@request_client.get_url(request_options: request_options)}/hris/v1/time-off/meta/post"
           end
-          Hris::MetaResponse.from_json(json_object: response.body)
+          Merge::Hris::MetaResponse.from_json(json_object: response.body)
         end
       end
     end

data/lib/merge_ruby_client/hris/time_off/types/time_off_list_request_expand.rb

@@ -3,12 +3,11 @@
 module Merge
   module Hris
     class TimeOff
-      # @type [TIME_OFF_LIST_REQUEST_EXPAND]
-      TIME_OFF_LIST_REQUEST_EXPAND = {
-        approver: "approver",
-        employee: "employee",
-        employee_approver: "employee,approver"
-      }.freeze
+      class TimeOffListRequestExpand
+        APPROVER = "approver"
+        EMPLOYEE = "employee"
+        EMPLOYEE_APPROVER = "employee,approver"
+      end
     end
   end
 end

data/lib/merge_ruby_client/hris/time_off/types/time_off_list_request_remote_fields.rb

@@ -3,16 +3,15 @@
 module Merge
   module Hris
     class TimeOff
-      # @type [TIME_OFF_LIST_REQUEST_REMOTE_FIELDS]
-      TIME_OFF_LIST_REQUEST_REMOTE_FIELDS = {
-        request_type: "request_type",
-        request_type_status: "request_type,status",
-        request_type_status_units: "request_type,status,units",
-        request_type_units: "request_type,units",
-        status: "status",
-        status_units: "status,units",
-        units: "units"
-      }.freeze
+      class TimeOffListRequestRemoteFields
+        REQUEST_TYPE = "request_type"
+        REQUEST_TYPE_STATUS = "request_type,status"
+        REQUEST_TYPE_STATUS_UNITS = "request_type,status,units"
+        REQUEST_TYPE_UNITS = "request_type,units"
+        STATUS = "status"
+        STATUS_UNITS = "status,units"
+        UNITS = "units"
+      end
     end
   end
 end

data/lib/merge_ruby_client/hris/time_off/types/time_off_list_request_request_type.rb

@@ -3,15 +3,14 @@
 module Merge
   module Hris
     class TimeOff
-      # @type [TIME_OFF_LIST_REQUEST_REQUEST_TYPE]
-      TIME_OFF_LIST_REQUEST_REQUEST_TYPE = {
-        bereavement: "BEREAVEMENT",
-        jury_duty: "JURY_DUTY",
-        personal: "PERSONAL",
-        sick: "SICK",
-        vacation: "VACATION",
-        volunteer: "VOLUNTEER"
-      }.freeze
+      class TimeOffListRequestRequestType
+        BEREAVEMENT = "BEREAVEMENT"
+        JURY_DUTY = "JURY_DUTY"
+        PERSONAL = "PERSONAL"
+        SICK = "SICK"
+        VACATION = "VACATION"
+        VOLUNTEER = "VOLUNTEER"
+      end
     end
   end
 end

data/lib/merge_ruby_client/hris/time_off/types/time_off_list_request_show_enum_origins.rb

@@ -3,16 +3,15 @@
 module Merge
   module Hris
     class TimeOff
-      # @type [TIME_OFF_LIST_REQUEST_SHOW_ENUM_ORIGINS]
-      TIME_OFF_LIST_REQUEST_SHOW_ENUM_ORIGINS = {
-        request_type: "request_type",
-        request_type_status: "request_type,status",
-        request_type_status_units: "request_type,status,units",
-        request_type_units: "request_type,units",
-        status: "status",
-        status_units: "status,units",
-        units: "units"
-      }.freeze
+      class TimeOffListRequestShowEnumOrigins
+        REQUEST_TYPE = "request_type"
+        REQUEST_TYPE_STATUS = "request_type,status"
+        REQUEST_TYPE_STATUS_UNITS = "request_type,status,units"
+        REQUEST_TYPE_UNITS = "request_type,units"
+        STATUS = "status"
+        STATUS_UNITS = "status,units"
+        UNITS = "units"
+      end
     end
   end
 end

data/lib/merge_ruby_client/hris/time_off/types/time_off_list_request_status.rb

@@ -3,14 +3,13 @@
 module Merge
   module Hris
     class TimeOff
-      # @type [TIME_OFF_LIST_REQUEST_STATUS]
-      TIME_OFF_LIST_REQUEST_STATUS = {
-        approved: "APPROVED",
-        cancelled: "CANCELLED",
-        declined: "DECLINED",
-        deleted: "DELETED",
-        requested: "REQUESTED"
-      }.freeze
+      class TimeOffListRequestStatus
+        APPROVED = "APPROVED"
+        CANCELLED = "CANCELLED"
+        DECLINED = "DECLINED"
+        DELETED = "DELETED"
+        REQUESTED = "REQUESTED"
+      end
     end
   end
 end

data/lib/merge_ruby_client/hris/time_off/types/time_off_retrieve_request_expand.rb

@@ -3,12 +3,11 @@
 module Merge
   module Hris
     class TimeOff
-      # @type [TIME_OFF_RETRIEVE_REQUEST_EXPAND]
-      TIME_OFF_RETRIEVE_REQUEST_EXPAND = {
-        approver: "approver",
-        employee: "employee",
-        employee_approver: "employee,approver"
-      }.freeze
+      class TimeOffRetrieveRequestExpand
+        APPROVER = "approver"
+        EMPLOYEE = "employee"
+        EMPLOYEE_APPROVER = "employee,approver"
+      end
     end
   end
 end