schematichq 1.4.13 → 1.4.15

data/lib/schematic/internal/http/raw_client.rb

@@ -21,21 +21,32 @@ module Schematic
         # @param max_retries [Integer] The number of times to retry a failed request, defaults to 2.
         # @param timeout [Float] The timeout for the request, defaults to 60.0 seconds.
         # @param headers [Hash] The headers for the request.
-        def initialize(base_url:, max_retries: 2, timeout: 60.0, headers: {})
+        # @param overridable_headers [Array<String>] The names of the client-level headers a request
+        #   may replace via `additional_headers`. Holds the API's global headers; SDK metadata and
+        #   auth headers are absent from it and so stay protected.
+        # @param auth_provider [Object, nil] An optional auth provider responding to
+        #   `auth_headers`. When present its headers are resolved on every request so
+        #   token-based schemes (e.g. OAuth) can refresh an expired token mid-session.
+        def initialize(base_url:, max_retries: 2, timeout: 60.0, headers: {}, overridable_headers: [], auth_provider: nil)
           @base_url = base_url
           @max_retries = max_retries
           @timeout = timeout
+          @auth_provider = auth_provider
           @default_headers = {
             "X-Fern-Language": "Ruby",
             "X-Fern-SDK-Name": "schematic",
             "X-Fern-SDK-Version": "0.0.1"
           }.merge(headers)
+          @overridable_headers = overridable_headers.to_set { |name| name.to_s.downcase }
         end
 
         # @param request [Schematic::Internal::Http::BaseRequest] The HTTP request.
         # @return [HTTP::Response] The HTTP response.
         def send(request)
           url = build_url(request)
+          # Resolve auth headers once per request (not per retry) so token-based
+          # providers refresh at most once here; static providers are cheap.
+          auth_headers = resolve_auth_headers
           attempt = 0
           response = nil
 
@@ -43,8 +54,9 @@ module Schematic
             http_request = build_http_request(
               url:,
               method: request.method,
-              headers: request.encode_headers(protected_keys: @default_headers.keys),
-              body: request.encode_body
+              headers: request.encode_headers(protected_keys: protected_header_keys + auth_headers.keys),
+              body: request.encode_body,
+              auth_headers: auth_headers
             )
 
             conn = connect(url)
@@ -65,6 +77,15 @@ module Schematic
           response
         end
 
+        # The client-level header names that `additional_headers` must not replace: every default
+        # header except the API's global headers, which are overridable per request.
+        # @return [Array<Symbol, String>] The protected header names.
+        def protected_header_keys
+          return @default_headers.keys if @overridable_headers.empty?
+
+          @default_headers.keys.reject { |name| @overridable_headers.include?(name.to_s.downcase) }
+        end
+
         # Determines if a request should be retried based on the response status code.
         # @param response [Net::HTTPResponse] The HTTP response.
         # @param attempt [Integer] The current retry attempt (0-indexed).
@@ -152,16 +173,32 @@ module Schematic
           return if url.scheme != "http"
           return if LOCALHOST_HOSTS.include?(url.host)
 
-          raise ArgumentError, "Refusing to send request to non-HTTPS URL: #{url}. " \
-                               "HTTP is only allowed for localhost. Use HTTPS or pass a localhost URL."
+          raise ArgumentError,
+                "Refusing to send request to non-HTTPS URL: #{url}. " \
+                "HTTP is only allowed for localhost. Use HTTPS or pass a localhost URL."
+        end
+
+        # Resolves the auth headers to send with the next request. Delegates to the
+        # configured auth provider (if any) on every call so that token-based
+        # providers (e.g. OAuth client-credentials) can refresh an expired token
+        # before the request is sent. Returns an empty hash when no provider is set,
+        # which keeps the api-key / basic / bearer / no-auth paths unchanged.
+        # @return [Hash] The auth headers for the current request.
+        def resolve_auth_headers
+          return {} if @auth_provider.nil?
+
+          @auth_provider.auth_headers
         end
 
         # @param url [URI::Generic] The url to the resource.
         # @param method [String] The HTTP method to use.
         # @param headers [Hash] The headers for the request.
         # @param body [String, nil] The body for the request.
+        # @param auth_headers [Hash] The auth headers resolved for this request. These
+        #   take precedence over the static default headers but not over per-request
+        #   headers, mirroring the previous baked-header precedence.
         # @return [HTTP::Request] The HTTP request.
-        def build_http_request(url:, method:, headers: {}, body: nil)
+        def build_http_request(url:, method:, headers: {}, body: nil, auth_headers: {})
           request = Net::HTTPGenericRequest.new(
             method,
             !body.nil?,
@@ -169,13 +206,27 @@ module Schematic
             url
           )
 
-          request_headers = @default_headers.merge(headers)
+          request_headers = @default_headers.merge(auth_headers).merge(headers)
           request_headers.each { |name, value| request[name] = value }
           request.body = body if body
 
+          # Net::HTTP disables its transparent gzip/deflate decoding as soon as an
+          # Accept-Encoding header is set explicitly on the request. Re-enable it so
+          # that compressed response bodies are still inflated.
+          request.extend(DecodeContent) if request_headers.keys.any? { |name| name.to_s.casecmp("accept-encoding").zero? }
+
           request
         end
 
+        # Keeps Net::HTTP's transparent gzip/deflate response decoding enabled
+        # even when an Accept-Encoding header is set explicitly on the request.
+        # @api private
+        module DecodeContent
+          def decode_content # rubocop:disable Naming/PredicateMethod
+            true
+          end
+        end
+
         # @param query [Hash] The query for the request.
         # @return [String, nil] The encoded query.
         def encode_query(query)

data/lib/schematic/internal/iterators/cursor_page_iterator.rb

@@ -5,17 +5,23 @@ module Schematic
     class CursorPageIterator
       include Enumerable
 
+      # The raw HTTP response from the most recent page response.
+      # @return [Net::HTTPResponse, nil]
+      attr_reader :http_response
+
       # Instantiates a CursorPageIterator, an Enumerable class which wraps calls to a cursor-based paginated API and yields pages of items.
       #
       # @param initial_cursor [String] The initial cursor to use when iterating, if any.
       # @param cursor_field [Symbol] The name of the field in API responses to extract the next cursor from.
       # @param block [Proc] A block which is responsible for receiving a cursor to use and returning the given page from the API.
+      #   The block should return a two-element array: [parsed_page, raw_http_response].
       # @return [Schematic::Internal::CursorPageIterator]
       def initialize(initial_cursor:, cursor_field:, &block)
         @need_initial_load = initial_cursor.nil?
         @cursor = initial_cursor
         @cursor_field = cursor_field
         @get_next_page = block
+        @http_response = nil
       end
 
       # Iterates over each page returned by the API.
@@ -37,12 +43,18 @@ module Schematic
 
       # Retrieves the next page from the API.
       #
-      # @return [Boolean]
+      # @return [Object, nil]
       def next_page
         return if !@need_initial_load && @cursor.nil?
 
         @need_initial_load = false
-        fetched_page = @get_next_page.call(@cursor)
+        result = @get_next_page.call(@cursor)
+        if result.is_a?(Array)
+          fetched_page, raw_response = result
+          @http_response = raw_response
+        else
+          fetched_page = result
+        end
         @cursor = fetched_page.send(@cursor_field)
         fetched_page
       end

data/lib/schematic/internal/iterators/item_iterator.rb

@@ -5,6 +5,12 @@ module Schematic
     class ItemIterator
       include Enumerable
 
+      # The raw HTTP response from the most recent page response.
+      # @return [Net::HTTPResponse, nil]
+      def http_response
+        @page_iterator&.http_response
+      end
+
       # Iterates over each item returned by the API.
       #
       # @param block [Proc] The block which each retrieved item is yielded to.

data/lib/schematic/internal/iterators/offset_page_iterator.rb

@@ -5,6 +5,10 @@ module Schematic
     class OffsetPageIterator
       include Enumerable
 
+      # The raw HTTP response from the most recent page response.
+      # @return [Net::HTTPResponse, nil]
+      attr_reader :http_response
+
       # Instantiates an OffsetPageIterator, an Enumerable class which wraps calls to an offset-based paginated API and yields pages of items from it.
       #
       # @param initial_page [Integer] The initial page to use when iterating, if any.
@@ -12,6 +16,7 @@ module Schematic
       # @param has_next_field [Symbol] The field to pull the boolean of whether a next page exists from, if any.
       # @param step [Boolean] If true, treats the page number as a true offset (i.e. increments the page number by the number of items returned from each call rather than just 1)
       # @param block [Proc] A block which is responsible for receiving a page number to use and returning the given page from the API.
+      #   The block should return a two-element array: [parsed_page, raw_http_response].
       # @return [Schematic::Internal::OffsetPageIterator]
       def initialize(initial_page:, item_field:, has_next_field:, step:, &block)
         @page_number = initial_page || (step ? 0 : 1)
@@ -24,6 +29,8 @@ module Schematic
         @next_page = nil
         # ...or the actual next page, preloaded, if it doesn't.
         @has_next_page = nil
+
+        @http_response = nil
       end
 
       # Iterates over each page returned by the API.
@@ -43,7 +50,7 @@ module Schematic
         return @has_next_page unless @has_next_page.nil?
         return true if @next_page
 
-        fetched_page = @get_next_page.call(@page_number)
+        fetched_page = fetch_page(@page_number)
         fetched_page_items = fetched_page&.send(@item_field)
         if fetched_page_items.nil? || fetched_page_items.empty?
           @has_next_page = false
@@ -61,7 +68,7 @@ module Schematic
           this_page = @next_page
           @next_page = nil
         else
-          this_page = @get_next_page.call(@page_number)
+          this_page = fetch_page(@page_number)
         end
 
         @has_next_page = this_page&.send(@has_next_field) if @has_next_field
@@ -78,6 +85,19 @@ module Schematic
 
         this_page
       end
+
+      private
+
+      def fetch_page(page_number)
+        result = @get_next_page.call(page_number)
+        if result.is_a?(Array)
+          fetched_page, raw_response = result
+          @http_response = raw_response
+          fetched_page
+        else
+          result
+        end
+      end
     end
   end
 end

data/lib/schematic/internal/types/utils.rb

@@ -76,8 +76,8 @@ module Schematic
           in Module
             case type
             in ->(t) {
-                 t.singleton_class.include?(Enum) ||
-                   t.singleton_class.include?(Union)
+                 t.singleton_class.included_modules.include?(Enum) ||
+                   t.singleton_class.included_modules.include?(Union)
                }
               return type.coerce(value, strict: strict)
             else

data/lib/schematic/licenses/client.rb

@@ -23,17 +23,24 @@ module Schematic
       # @option params [Integer, nil] :limit
       # @option params [Integer, nil] :offset
       #
+      # @example
+      #   client.licenses.list_licenses(
+      #     feature_ids: ["feature_ids"],
+      #     ids: ["ids"],
+      #     name: "name",
+      #     limit: 1000000,
+      #     offset: 1000000
+      #   )
+      #
       # @return [Schematic::Licenses::Types::ListLicensesResponse]
       def list_licenses(request_options: {}, **params)
         params = Schematic::Internal::Types::Utils.normalize_keys(params)
-        query_param_names = %i[feature_ids ids name limit offset]
         query_params = {}
         query_params["feature_ids"] = params[:feature_ids] if params.key?(:feature_ids)
         query_params["ids"] = params[:ids] if params.key?(:ids)
         query_params["name"] = params[:name] if params.key?(:name)
         query_params["limit"] = params[:limit] if params.key?(:limit)
         query_params["offset"] = params[:offset] if params.key?(:offset)
-        params.except(*query_param_names)
 
         request = Schematic::Internal::JSON::Request.new(
           base_url: request_options[:base_url],
@@ -65,6 +72,9 @@ module Schematic
       # @option request_options [Integer] :timeout_in_seconds
       # @option params [String] :license_id
       #
+      # @example
+      #   client.licenses.get_single_license(license_id: "license_id")
+      #
       # @return [Schematic::Licenses::Types::GetSingleLicenseResponse]
       def get_single_license(request_options: {}, **params)
         params = Schematic::Internal::Types::Utils.normalize_keys(params)
@@ -101,17 +111,24 @@ module Schematic
       # @option params [Integer, nil] :limit
       # @option params [Integer, nil] :offset
       #
+      # @example
+      #   client.licenses.count_licenses(
+      #     feature_ids: ["feature_ids"],
+      #     ids: ["ids"],
+      #     name: "name",
+      #     limit: 1000000,
+      #     offset: 1000000
+      #   )
+      #
       # @return [Schematic::Licenses::Types::CountLicensesResponse]
       def count_licenses(request_options: {}, **params)
         params = Schematic::Internal::Types::Utils.normalize_keys(params)
-        query_param_names = %i[feature_ids ids name limit offset]
         query_params = {}
         query_params["feature_ids"] = params[:feature_ids] if params.key?(:feature_ids)
         query_params["ids"] = params[:ids] if params.key?(:ids)
         query_params["name"] = params[:name] if params.key?(:name)
         query_params["limit"] = params[:limit] if params.key?(:limit)
         query_params["offset"] = params[:offset] if params.key?(:offset)
-        params.except(*query_param_names)
 
         request = Schematic::Internal::JSON::Request.new(
           base_url: request_options[:base_url],

data/lib/schematic/licenses/types/count_licenses_params.rb

@@ -6,9 +6,13 @@ module Schematic
       # Input parameters
       class CountLicensesParams < Internal::Types::Model
         field :feature_ids, -> { Internal::Types::Array[String] }, optional: true, nullable: false
+
         field :ids, -> { Internal::Types::Array[String] }, optional: true, nullable: false
+
         field :limit, -> { Integer }, optional: true, nullable: false
+
         field :name, -> { String }, optional: true, nullable: false
+
         field :offset, -> { Integer }, optional: true, nullable: false
       end
     end

data/lib/schematic/licenses/types/count_licenses_request.rb

@@ -5,9 +5,13 @@ module Schematic
     module Types
       class CountLicensesRequest < Internal::Types::Model
         field :feature_ids, -> { String }, optional: true, nullable: false
+
         field :ids, -> { String }, optional: true, nullable: false
+
         field :name, -> { String }, optional: true, nullable: false
+
         field :limit, -> { Integer }, optional: true, nullable: false
+
         field :offset, -> { Integer }, optional: true, nullable: false
       end
     end

data/lib/schematic/licenses/types/count_licenses_response.rb

@@ -5,6 +5,7 @@ module Schematic
     module Types
       class CountLicensesResponse < Internal::Types::Model
         field :data, -> { Schematic::Types::CountResponse }, optional: false, nullable: false
+
         field :params, -> { Schematic::Licenses::Types::CountLicensesParams }, optional: false, nullable: false
       end
     end

data/lib/schematic/licenses/types/get_single_license_response.rb

@@ -5,6 +5,7 @@ module Schematic
     module Types
       class GetSingleLicenseResponse < Internal::Types::Model
         field :data, -> { Schematic::Types::LicenseResponseData }, optional: false, nullable: false
+
         field :params, -> { Internal::Types::Hash[String, Object] }, optional: false, nullable: false
       end
     end

data/lib/schematic/licenses/types/list_licenses_params.rb

@@ -6,9 +6,13 @@ module Schematic
       # Input parameters
       class ListLicensesParams < Internal::Types::Model
         field :feature_ids, -> { Internal::Types::Array[String] }, optional: true, nullable: false
+
         field :ids, -> { Internal::Types::Array[String] }, optional: true, nullable: false
+
         field :limit, -> { Integer }, optional: true, nullable: false
+
         field :name, -> { String }, optional: true, nullable: false
+
         field :offset, -> { Integer }, optional: true, nullable: false
       end
     end

data/lib/schematic/licenses/types/list_licenses_request.rb

@@ -5,9 +5,13 @@ module Schematic
     module Types
       class ListLicensesRequest < Internal::Types::Model
         field :feature_ids, -> { String }, optional: true, nullable: false
+
         field :ids, -> { String }, optional: true, nullable: false
+
         field :name, -> { String }, optional: true, nullable: false
+
         field :limit, -> { Integer }, optional: true, nullable: false
+
         field :offset, -> { Integer }, optional: true, nullable: false
       end
     end

data/lib/schematic/licenses/types/list_licenses_response.rb

@@ -5,6 +5,7 @@ module Schematic
     module Types
       class ListLicensesResponse < Internal::Types::Model
         field :data, -> { Internal::Types::Array[Schematic::Types::LicenseResponseData] }, optional: false, nullable: false
+
         field :params, -> { Schematic::Licenses::Types::ListLicensesParams }, optional: false, nullable: false
       end
     end

data/lib/schematic/planbundle/client.rb

@@ -18,6 +18,21 @@ module Schematic
       # @option request_options [Hash{String => Object}] :additional_body_parameters
       # @option request_options [Integer] :timeout_in_seconds
       #
+      # @example
+      #   client.planbundle.create_custom_plan_bundle(
+      #     billing_product: {
+      #       charge_type: "free",
+      #       is_trialable: true
+      #     },
+      #     entitlements: [{
+      #       action: "create"
+      #     }],
+      #     plan: {
+      #       company_id: "company_id",
+      #       name: "name"
+      #     }
+      #   )
+      #
       # @return [Schematic::Planbundle::Types::CreateCustomPlanBundleResponse]
       def create_custom_plan_bundle(request_options: {}, **params)
         params = Schematic::Internal::Types::Utils.normalize_keys(params)
@@ -50,6 +65,17 @@ module Schematic
       # @option request_options [Hash{String => Object}] :additional_body_parameters
       # @option request_options [Integer] :timeout_in_seconds
       #
+      # @example
+      #   client.planbundle.create_plan_bundle(
+      #     entitlements: [{
+      #       action: "create"
+      #     }],
+      #     plan: {
+      #       name: "name",
+      #       plan_type: "plan"
+      #     }
+      #   )
+      #
       # @return [Schematic::Planbundle::Types::CreatePlanBundleResponse]
       def create_plan_bundle(request_options: {}, **params)
         params = Schematic::Internal::Types::Utils.normalize_keys(params)
@@ -81,19 +107,30 @@ module Schematic
       # @option request_options [Hash{String => Object}] :additional_query_parameters
       # @option request_options [Hash{String => Object}] :additional_body_parameters
       # @option request_options [Integer] :timeout_in_seconds
-      # @option params [String] :plan_bundle_id
+      # @option params [String] :plan_id
+      #
+      # @example
+      #   client.planbundle.update_plan_bundle(
+      #     plan_id: "plan_id",
+      #     entitlements: [{
+      #       action: "create"
+      #     }],
+      #     plan: {
+      #       name: "name"
+      #     }
+      #   )
       #
       # @return [Schematic::Planbundle::Types::UpdatePlanBundleResponse]
       def update_plan_bundle(request_options: {}, **params)
         params = Schematic::Internal::Types::Utils.normalize_keys(params)
         request_data = Schematic::Planbundle::Types::UpdatePlanBundleRequestBody.new(params).to_h
-        non_body_param_names = ["plan_bundle_id"]
+        non_body_param_names = %w[plan_id]
         body = request_data.except(*non_body_param_names)
 
         request = Schematic::Internal::JSON::Request.new(
           base_url: request_options[:base_url],
           method: "PUT",
-          path: "plan-bundles/#{URI.encode_uri_component(params[:plan_bundle_id].to_s)}",
+          path: "plan-bundles/#{URI.encode_uri_component(params[:plan_id].to_s)}",
           body: body,
           request_options: request_options
         )

data/lib/schematic/planbundle/types/create_custom_plan_bundle_request_body.rb

@@ -4,10 +4,13 @@ module Schematic
   module Planbundle
     module Types
       class CreateCustomPlanBundleRequestBody < Internal::Types::Model
-        field :billing_product, -> { Schematic::Types::UpsertBillingProductRequestBody }, optional: true, nullable: false
+        field :billing_product, -> { Schematic::Types::UpsertBillingProductRequestBody }, optional: false, nullable: false
+
         field :credit_grants, -> { Internal::Types::Array[Schematic::Types::PlanBundleCreditGrantRequestBody] }, optional: true, nullable: false
+
         field :entitlements, -> { Internal::Types::Array[Schematic::Types::PlanBundleEntitlementRequestBody] }, optional: false, nullable: false
-        field :plan, -> { Schematic::Types::CreateCustomPlanBundlePlanRequestBody }, optional: true, nullable: false
+
+        field :plan, -> { Schematic::Types::CreateCustomPlanBundlePlanRequestBody }, optional: false, nullable: false
       end
     end
   end

data/lib/schematic/planbundle/types/create_custom_plan_bundle_response.rb

@@ -5,6 +5,7 @@ module Schematic
     module Types
       class CreateCustomPlanBundleResponse < Internal::Types::Model
         field :data, -> { Schematic::Types::PlanBundleResponseData }, optional: false, nullable: false
+
         field :params, -> { Internal::Types::Hash[String, Object] }, optional: false, nullable: false
       end
     end

data/lib/schematic/planbundle/types/create_plan_bundle_request_body.rb

@@ -5,9 +5,12 @@ module Schematic
     module Types
       class CreatePlanBundleRequestBody < Internal::Types::Model
         field :billing_product, -> { Schematic::Types::UpsertBillingProductRequestBody }, optional: true, nullable: false
+
         field :credit_grants, -> { Internal::Types::Array[Schematic::Types::PlanBundleCreditGrantRequestBody] }, optional: true, nullable: false
+
         field :entitlements, -> { Internal::Types::Array[Schematic::Types::PlanBundleEntitlementRequestBody] }, optional: false, nullable: false
-        field :plan, -> { Schematic::Types::CreatePlanRequestBody }, optional: true, nullable: false
+
+        field :plan, -> { Schematic::Types::CreatePlanRequestBody }, optional: false, nullable: false
       end
     end
   end

data/lib/schematic/planbundle/types/create_plan_bundle_response.rb

@@ -5,6 +5,7 @@ module Schematic
     module Types
       class CreatePlanBundleResponse < Internal::Types::Model
         field :data, -> { Schematic::Types::PlanBundleResponseData }, optional: false, nullable: false
+
         field :params, -> { Internal::Types::Hash[String, Object] }, optional: false, nullable: false
       end
     end

data/lib/schematic/planbundle/types/update_plan_bundle_request_body.rb

@@ -4,11 +4,16 @@ module Schematic
   module Planbundle
     module Types
       class UpdatePlanBundleRequestBody < Internal::Types::Model
-        field :plan_bundle_id, -> { String }, optional: false, nullable: false
+        field :plan_id, -> { String }, optional: false, nullable: false
+
         field :billing_product, -> { Schematic::Types::UpsertBillingProductRequestBody }, optional: true, nullable: false
+
         field :credit_grants, -> { Internal::Types::Array[Schematic::Types::PlanBundleCreditGrantRequestBody] }, optional: true, nullable: false
+
         field :entitlements, -> { Internal::Types::Array[Schematic::Types::PlanBundleEntitlementRequestBody] }, optional: false, nullable: false
-        field :plan, -> { Schematic::Types::UpdatePlanRequestBody }, optional: true, nullable: false
+
+        field :plan, -> { Schematic::Types::UpdatePlanRequestBody }, optional: false, nullable: false
+
         field :plan_version_id, -> { String }, optional: true, nullable: false
       end
     end

data/lib/schematic/planbundle/types/update_plan_bundle_response.rb

@@ -5,6 +5,7 @@ module Schematic
     module Types
       class UpdatePlanBundleResponse < Internal::Types::Model
         field :data, -> { Schematic::Types::PlanBundleResponseData }, optional: false, nullable: false
+
         field :params, -> { Internal::Types::Hash[String, Object] }, optional: false, nullable: false
       end
     end

data/lib/schematic/plangroups/client.rb

@@ -19,13 +19,14 @@ module Schematic
       # @option request_options [Integer] :timeout_in_seconds
       # @option params [Boolean, nil] :include_company_counts
       #
+      # @example
+      #   client.plangroups.get_plan_group(include_company_counts: true)
+      #
       # @return [Schematic::Plangroups::Types::GetPlanGroupResponse]
       def get_plan_group(request_options: {}, **params)
         params = Schematic::Internal::Types::Utils.normalize_keys(params)
-        query_param_names = %i[include_company_counts]
         query_params = {}
         query_params["include_company_counts"] = params[:include_company_counts] if params.key?(:include_company_counts)
-        params.except(*query_param_names)
 
         request = Schematic::Internal::JSON::Request.new(
           base_url: request_options[:base_url],
@@ -56,6 +57,36 @@ module Schematic
       # @option request_options [Hash{String => Object}] :additional_body_parameters
       # @option request_options [Integer] :timeout_in_seconds
       #
+      # @example
+      #   client.plangroups.create_plan_group(
+      #     add_on_ids: ["add_on_ids"],
+      #     checkout_collect_address: true,
+      #     checkout_collect_email: true,
+      #     checkout_collect_phone: true,
+      #     checkout_collect_tax_id: true,
+      #     enable_tax_collection: true,
+      #     opt_in_enabled: true,
+      #     ordered_add_ons: [{
+      #       plan_id: "plan_id"
+      #     }],
+      #     ordered_bundle_list: [{
+      #       bundle_id: "bundleId"
+      #     }],
+      #     ordered_plans: [{
+      #       plan_id: "plan_id"
+      #     }],
+      #     prevent_downgrades_when_over_limit: true,
+      #     prevent_self_service_downgrade: true,
+      #     proration_behavior: "create_prorations",
+      #     show_as_monthly_prices: true,
+      #     show_credits: true,
+      #     show_feature_description: true,
+      #     show_hard_limit: true,
+      #     show_period_toggle: true,
+      #     show_zero_price_as_free: true,
+      #     sync_customer_billing_details: true
+      #   )
+      #
       # @return [Schematic::Plangroups::Types::CreatePlanGroupResponse]
       def create_plan_group(request_options: {}, **params)
         params = Schematic::Internal::Types::Utils.normalize_keys(params)
@@ -89,11 +120,42 @@ module Schematic
       # @option request_options [Integer] :timeout_in_seconds
       # @option params [String] :plan_group_id
       #
+      # @example
+      #   client.plangroups.update_plan_group(
+      #     plan_group_id: "plan_group_id",
+      #     add_on_ids: ["add_on_ids"],
+      #     checkout_collect_address: true,
+      #     checkout_collect_email: true,
+      #     checkout_collect_phone: true,
+      #     checkout_collect_tax_id: true,
+      #     enable_tax_collection: true,
+      #     opt_in_enabled: true,
+      #     ordered_add_ons: [{
+      #       plan_id: "plan_id"
+      #     }],
+      #     ordered_bundle_list: [{
+      #       bundle_id: "bundleId"
+      #     }],
+      #     ordered_plans: [{
+      #       plan_id: "plan_id"
+      #     }],
+      #     prevent_downgrades_when_over_limit: true,
+      #     prevent_self_service_downgrade: true,
+      #     proration_behavior: "create_prorations",
+      #     show_as_monthly_prices: true,
+      #     show_credits: true,
+      #     show_feature_description: true,
+      #     show_hard_limit: true,
+      #     show_period_toggle: true,
+      #     show_zero_price_as_free: true,
+      #     sync_customer_billing_details: true
+      #   )
+      #
       # @return [Schematic::Plangroups::Types::UpdatePlanGroupResponse]
       def update_plan_group(request_options: {}, **params)
         params = Schematic::Internal::Types::Utils.normalize_keys(params)
         request_data = Schematic::Plangroups::Types::UpdatePlanGroupRequestBody.new(params).to_h
-        non_body_param_names = ["plan_group_id"]
+        non_body_param_names = %w[plan_group_id]
         body = request_data.except(*non_body_param_names)
 
         request = Schematic::Internal::JSON::Request.new(