chore(internal): codegen related update

Author: stainless-app[bot]

.github/workflows/ci.yml

@@ -13,6 +13,40 @@ on:
       - 'stl-preview-base/**'
 
 jobs:
+  build:
+    timeout-minutes: 10
+    name: build
+    permissions:
+      contents: read
+      id-token: write
+    runs-on: ${{ github.repository == 'stainless-sdks/finch-ruby' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
+    if: |-
+      github.repository == 'stainless-sdks/finch-ruby' &&
+      (github.event_name == 'push' || github.event.pull_request.head.repo.fork)
+    steps:
+      - uses: actions/checkout@v6
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          bundler-cache: false
+      - run: |-
+          bundle install
+
+      - name: Get GitHub OIDC Token
+        if: github.repository == 'stainless-sdks/finch-ruby'
+        id: github-oidc
+        uses: actions/github-script@v8
+        with:
+          script: core.setOutput('github_token', await core.getIDToken());
+
+      - name: Build and upload gem artifacts
+        if: github.repository == 'stainless-sdks/finch-ruby'
+        env:
+          URL: https://pkg.stainless.com/s
+          AUTH: ${{ steps.github-oidc.outputs.github_token }}
+          SHA: ${{ github.sha }}
+          PACKAGE_NAME: finch_api
+        run: ./scripts/utils/upload-artifact.sh
   lint:
     timeout-minutes: 10
     name: lint

lib/finch_api/internal/util.rb

@@ -490,6 +490,37 @@ def writable_enum(&blk)
       JSONL_CONTENT = %r{^application/(:?x-(?:n|l)djson)|(:?(?:x-)?jsonl)}
 
       class << self
+        # @api private
+        #
+        # @param query [Hash{Symbol=>Object}]
+        #
+        # @return [Hash{Symbol=>Object}]
+        def encode_query_params(query)
+          out = {}
+          query.each { write_query_param_element!(out, _1, _2) }
+          out
+        end
+
+        # @api private
+        #
+        # @param collection [Hash{Symbol=>Object}]
+        # @param key [String]
+        # @param element [Object]
+        #
+        # @return [nil]
+        private def write_query_param_element!(collection, key, element)
+          case element
+          in Hash
+            element.each do |name, value|
+              write_query_param_element!(collection, "#{key}[#{name}]", value)
+            end
+          in Array
+            collection["#{key}[]"] = element.map(&:to_s)
+          else
+            collection[key] = element.to_s
+          end
+        end
+
         # @api private
         #
         # @param y [Enumerator::Yielder]

lib/finch_api/models/hris/benefit_retrieve_params.rb

@@ -8,13 +8,20 @@ class BenefitRetrieveParams < FinchAPI::Internal::Type::BaseModel
         extend FinchAPI::Internal::Type::RequestParameters::Converter
         include FinchAPI::Internal::Type::RequestParameters
 
+        # @!attribute benefit_id
+        #
+        #   @return [String]
+        required :benefit_id, String
+
         # @!attribute entity_ids
         #   The entity IDs to specify which entities' data to access.
         #
         #   @return [Array<String>, nil]
         optional :entity_ids, FinchAPI::Internal::Type::ArrayOf[String]
 
-        # @!method initialize(entity_ids: nil, request_options: {})
+        # @!method initialize(benefit_id:, entity_ids: nil, request_options: {})
+        #   @param benefit_id [String]
+        #
         #   @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access.
         #
         #   @param request_options [FinchAPI::RequestOptions, Hash{Symbol=>Object}]

lib/finch_api/models/hris/benefit_update_params.rb

@@ -8,6 +8,11 @@ class BenefitUpdateParams < FinchAPI::Internal::Type::BaseModel
         extend FinchAPI::Internal::Type::RequestParameters::Converter
         include FinchAPI::Internal::Type::RequestParameters
 
+        # @!attribute benefit_id
+        #
+        #   @return [String]
+        required :benefit_id, String
+
         # @!attribute entity_ids
         #   The entity IDs to specify which entities' data to access.
         #
@@ -20,7 +25,9 @@ class BenefitUpdateParams < FinchAPI::Internal::Type::BaseModel
         #   @return [String, nil]
         optional :description, String
 
-        # @!method initialize(entity_ids: nil, description: nil, request_options: {})
+        # @!method initialize(benefit_id:, entity_ids: nil, description: nil, request_options: {})
+        #   @param benefit_id [String]
+        #
         #   @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access.
         #
         #   @param description [String] Updated name or description.

lib/finch_api/models/hris/benefits/individual_enroll_many_params.rb

@@ -9,6 +9,11 @@ class IndividualEnrollManyParams < FinchAPI::Internal::Type::BaseModel
           extend FinchAPI::Internal::Type::RequestParameters::Converter
           include FinchAPI::Internal::Type::RequestParameters
 
+          # @!attribute benefit_id
+          #
+          #   @return [String]
+          required :benefit_id, String
+
           # @!attribute entity_ids
           #   The entity IDs to specify which entities' data to access.
           #
@@ -22,7 +27,9 @@ class IndividualEnrollManyParams < FinchAPI::Internal::Type::BaseModel
           optional :individuals,
                    -> { FinchAPI::Internal::Type::ArrayOf[FinchAPI::HRIS::Benefits::IndividualEnrollManyParams::Individual] }
 
-          # @!method initialize(entity_ids: nil, individuals: nil, request_options: {})
+          # @!method initialize(benefit_id:, entity_ids: nil, individuals: nil, request_options: {})
+          #   @param benefit_id [String]
+          #
           #   @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access.
           #
           #   @param individuals [Array<FinchAPI::Models::HRIS::Benefits::IndividualEnrollManyParams::Individual>] Array of the individual_id to enroll and a configuration object.

lib/finch_api/models/hris/benefits/individual_enrolled_ids_params.rb

@@ -9,13 +9,20 @@ class IndividualEnrolledIDsParams < FinchAPI::Internal::Type::BaseModel
           extend FinchAPI::Internal::Type::RequestParameters::Converter
           include FinchAPI::Internal::Type::RequestParameters
 
+          # @!attribute benefit_id
+          #
+          #   @return [String]
+          required :benefit_id, String
+
           # @!attribute entity_ids
           #   The entity IDs to specify which entities' data to access.
           #
           #   @return [Array<String>, nil]
           optional :entity_ids, FinchAPI::Internal::Type::ArrayOf[String]
 
-          # @!method initialize(entity_ids: nil, request_options: {})
+          # @!method initialize(benefit_id:, entity_ids: nil, request_options: {})
+          #   @param benefit_id [String]
+          #
           #   @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access.
           #
           #   @param request_options [FinchAPI::RequestOptions, Hash{Symbol=>Object}]

lib/finch_api/models/hris/benefits/individual_retrieve_many_benefits_params.rb

@@ -9,6 +9,11 @@ class IndividualRetrieveManyBenefitsParams < FinchAPI::Internal::Type::BaseModel
           extend FinchAPI::Internal::Type::RequestParameters::Converter
           include FinchAPI::Internal::Type::RequestParameters
 
+          # @!attribute benefit_id
+          #
+          #   @return [String]
+          required :benefit_id, String
+
           # @!attribute entity_ids
           #   The entity IDs to specify which entities' data to access.
           #
@@ -22,11 +27,13 @@ class IndividualRetrieveManyBenefitsParams < FinchAPI::Internal::Type::BaseModel
           #   @return [String, nil]
           optional :individual_ids, String
 
-          # @!method initialize(entity_ids: nil, individual_ids: nil, request_options: {})
+          # @!method initialize(benefit_id:, entity_ids: nil, individual_ids: nil, request_options: {})
           #   Some parameter documentations has been truncated, see
           #   {FinchAPI::Models::HRIS::Benefits::IndividualRetrieveManyBenefitsParams} for
           #   more details.
           #
+          #   @param benefit_id [String]
+          #
           #   @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access.
           #
           #   @param individual_ids [String] comma-delimited list of stable Finch uuids for each individual. If empty, defaul

lib/finch_api/models/hris/benefits/individual_unenroll_many_params.rb

@@ -9,6 +9,11 @@ class IndividualUnenrollManyParams < FinchAPI::Internal::Type::BaseModel
           extend FinchAPI::Internal::Type::RequestParameters::Converter
           include FinchAPI::Internal::Type::RequestParameters
 
+          # @!attribute benefit_id
+          #
+          #   @return [String]
+          required :benefit_id, String
+
           # @!attribute entity_ids
           #   The entity IDs to specify which entities' data to access.
           #
@@ -21,7 +26,9 @@ class IndividualUnenrollManyParams < FinchAPI::Internal::Type::BaseModel
           #   @return [Array<String>, nil]
           optional :individual_ids, FinchAPI::Internal::Type::ArrayOf[String]
 
-          # @!method initialize(entity_ids: nil, individual_ids: nil, request_options: {})
+          # @!method initialize(benefit_id:, entity_ids: nil, individual_ids: nil, request_options: {})
+          #   @param benefit_id [String]
+          #
           #   @param entity_ids [Array<String>] The entity IDs to specify which entities' data to access.
           #
           #   @param individual_ids [Array<String>] Array of individual_ids to unenroll.

lib/finch_api/models/hris/company/pay_statement_item/rule_delete_params.rb

@@ -10,13 +10,20 @@ class RuleDeleteParams < FinchAPI::Internal::Type::BaseModel
             extend FinchAPI::Internal::Type::RequestParameters::Converter
             include FinchAPI::Internal::Type::RequestParameters
 
+            # @!attribute rule_id
+            #
+            #   @return [String]
+            required :rule_id, String
+
             # @!attribute entity_ids
             #   The entity IDs to delete the rule for.
             #
             #   @return [Array<String>, nil]
             optional :entity_ids, FinchAPI::Internal::Type::ArrayOf[String]
 
-            # @!method initialize(entity_ids: nil, request_options: {})
+            # @!method initialize(rule_id:, entity_ids: nil, request_options: {})
+            #   @param rule_id [String]
+            #
             #   @param entity_ids [Array<String>] The entity IDs to delete the rule for.
             #
             #   @param request_options [FinchAPI::RequestOptions, Hash{Symbol=>Object}]

lib/finch_api/models/hris/company/pay_statement_item/rule_update_params.rb

@@ -10,6 +10,11 @@ class RuleUpdateParams < FinchAPI::Internal::Type::BaseModel
             extend FinchAPI::Internal::Type::RequestParameters::Converter
             include FinchAPI::Internal::Type::RequestParameters
 
+            # @!attribute rule_id
+            #
+            #   @return [String]
+            required :rule_id, String
+
             # @!attribute entity_ids
             #   The entity IDs to update the rule for.
             #
@@ -21,7 +26,9 @@ class RuleUpdateParams < FinchAPI::Internal::Type::BaseModel
             #   @return [Object, nil]
             optional :optional_property, FinchAPI::Internal::Type::Unknown, api_name: :optionalProperty
 
-            # @!method initialize(entity_ids: nil, optional_property: nil, request_options: {})
+            # @!method initialize(rule_id:, entity_ids: nil, optional_property: nil, request_options: {})
+            #   @param rule_id [String]
+            #
             #   @param entity_ids [Array<String>] The entity IDs to update the rule for.
             #
             #   @param optional_property [Object]