feat(specs): add sortBy query param and sortingStrategy (generated)

algolia/api-clients-automation#5686

Co-authored-by: algolia-bot <[email protected]>
Co-authored-by: Ben Kalmus <[email protected]>
Co-authored-by: Thomas Raffray <[email protected]>

Author: 3 people

lib/algolia/api/composition_client.rb

@@ -947,5 +947,61 @@ def search_for_facet_values(composition_id, facet_name, search_for_facet_values_
       )
     end
 
+    # Updates the \"sortingStrategy\" field of an existing composition. This endpoint allows you to create a new sorting strategy mapping or replace the currently configured one. The provided sorting indices MUST be associated indices or replicas of the main targeted index.  WARNING: This endpoint cannot validate if the sort index is related to the composition's main index.   Validation will fail at runtime if the index you updated is not related!  The update is applied to the specified composition within the current Algolia application and returns a taskID that can be used to track the operation’s completion.
+    #
+    # Required API Key ACLs:
+    #   - editSettings
+    # @param composition_id [String] Unique Composition ObjectID. (required)
+    # @param request_body [Hash<String, String>]  (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [Http::Response] the response
+    def update_sorting_strategy_composition_with_http_info(composition_id, request_body, request_options = {})
+      # verify the required parameter 'composition_id' is set
+      if @api_client.config.client_side_validation && composition_id.nil?
+        raise(
+          ArgumentError,
+          "Parameter `composition_id` is required when calling `update_sorting_strategy_composition`."
+        )
+      end
+      # verify the required parameter 'request_body' is set
+      if @api_client.config.client_side_validation && request_body.nil?
+        raise ArgumentError, "Parameter `request_body` is required when calling `update_sorting_strategy_composition`."
+      end
+
+      path = "/1/compositions/{compositionID}/sortingStrategy".sub(
+        "{" + "compositionID" + "}",
+        Transport.encode_uri(composition_id.to_s)
+      )
+      query_params = {}
+      query_params = query_params.merge(request_options[:query_params]) unless request_options[:query_params].nil?
+      header_params = {}
+      header_params = header_params.merge(request_options[:header_params]) unless request_options[:header_params].nil?
+
+      post_body = request_options[:debug_body] || @api_client.object_to_http_body(request_body)
+
+      new_options = request_options.merge(
+        :operation => :"CompositionClient.update_sorting_strategy_composition",
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :use_read_transporter => false
+      )
+
+      @api_client.call_api(:POST, path, new_options)
+    end
+
+    # Updates the \"sortingStrategy\" field of an existing composition. This endpoint allows you to create a new sorting strategy mapping or replace the currently configured one. The provided sorting indices MUST be associated indices or replicas of the main targeted index.  WARNING: This endpoint cannot validate if the sort index is related to the composition's main index.   Validation will fail at runtime if the index you updated is not related!  The update is applied to the specified composition within the current Algolia application and returns a taskID that can be used to track the operation’s completion.
+    #
+    # Required API Key ACLs:
+    #   - editSettings
+    # @param composition_id [String] Unique Composition ObjectID. (required)
+    # @param request_body [Hash<String, String>]  (required)
+    # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
+    # @return [TaskIDResponse]
+    def update_sorting_strategy_composition(composition_id, request_body, request_options = {})
+      response = update_sorting_strategy_composition_with_http_info(composition_id, request_body, request_options)
+      @api_client.deserialize(response.body, request_options[:debug_return_type] || "Composition::TaskIDResponse")
+    end
+
   end
 end

lib/algolia/models/composition/composition.rb

@@ -19,13 +19,17 @@ class Composition
 
       attr_accessor :behavior
 
+      # A mapping of sorting labels to the indices (or replicas) that implement those sorting rules. The sorting indices MUST be related to the associated main targeted index in the composition. Each key is the label your frontend sends at runtime (for example, \"Price (asc)\"), and each value is the name of the index that should be queried when that label is selected.  When a request includes a \"sortBy\" parameter, the platform looks up the corresponding index in this mapping and uses it to execute the query. The main targeted index is replaced with the sorting strategy index it is mapped to.  Up to 20 sorting strategies can be defined.
+      attr_accessor :sorting_strategy
+
       # Attribute mapping from ruby-style variable name to JSON key.
       def self.attribute_map
         {
           :algolia_object_id => :objectID,
           :name => :name,
           :description => :description,
-          :behavior => :behavior
+          :behavior => :behavior,
+          :sorting_strategy => :sortingStrategy
         }
       end
 
@@ -35,7 +39,8 @@ def self.types_mapping
           :algolia_object_id => :"String",
           :name => :"String",
           :description => :"String",
-          :behavior => :"CompositionBehavior"
+          :behavior => :"CompositionBehavior",
+          :sorting_strategy => :"Hash<String, String>"
         }
       end
 
@@ -90,6 +95,12 @@ def initialize(attributes = {})
         else
           self.behavior = nil
         end
+
+        if attributes.key?(:sorting_strategy)
+          if (value = attributes[:sorting_strategy]).is_a?(Hash)
+            self.sorting_strategy = value
+          end
+        end
       end
 
       # Checks equality by comparing each attribute.
@@ -100,7 +111,8 @@ def ==(other)
           algolia_object_id == other.algolia_object_id &&
           name == other.name &&
           description == other.description &&
-          behavior == other.behavior
+          behavior == other.behavior &&
+          sorting_strategy == other.sorting_strategy
       end
 
       # @see the `==` method
@@ -112,7 +124,7 @@ def eql?(other)
       # Calculates hash code according to all attributes.
       # @return [Integer] Hash code
       def hash
-        [algolia_object_id, name, description, behavior].hash
+        [algolia_object_id, name, description, behavior, sorting_strategy].hash
       end
 
       # Builds the object from hash

lib/algolia/models/composition/params.rb

@@ -77,15 +77,18 @@ class Params
       # Search query.
       attr_accessor :query
 
-      # Relevancy threshold below which less relevant results aren't included in the results You can only set `relevancyStrictness` on [virtual replica indices](https://www.algolia.com/doc/guides/managing-results/refine-results/sorting/in-depth/replicas/#what-are-virtual-replicas). Use this setting to strike a balance between the relevance and number of returned results.
-      attr_accessor :relevancy_strictness
-
       # Languages for language-specific query processing steps such as plurals, stop-word removal, and word-detection dictionaries  This setting sets a default list of languages used by the `removeStopWords` and `ignorePlurals` settings. This setting also sets a dictionary for word detection in the logogram-based [CJK](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/normalization/#normalization-for-logogram-based-languages-cjk) languages. To support this, you must place the CJK language **first**  **You should always specify a query language.** If you don't specify an indexing language, the search engine uses all [supported languages](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/supported-languages), or the languages you specified with the `ignorePlurals` or `removeStopWords` parameters. This can lead to unexpected search results. For more information, see [Language-specific configuration](https://www.algolia.com/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/in-depth/language-specific-configurations).
       attr_accessor :query_languages
 
+      # Relevancy threshold below which less relevant results aren't included in the results You can only set `relevancyStrictness` on [virtual replica indices](https://www.algolia.com/doc/guides/managing-results/refine-results/sorting/in-depth/replicas/#what-are-virtual-replicas). Use this setting to strike a balance between the relevance and number of returned results.
+      attr_accessor :relevancy_strictness
+
       # Assigns a rule context to the run query [Rule contexts](https://www.algolia.com/doc/guides/managing-results/rules/rules-overview/how-to/customize-search-results-by-platform/#whats-a-context) are strings that you can use to trigger matching rules.
       attr_accessor :rule_contexts
 
+      # Indicates which sorting strategy to apply for the request. The value must match one of the labels defined in the \"sortingStrategy\" mapping. For example, \"Price (asc)\", see Upsert Composition. At runtime, this label is used to look up the corresponding index or replica configured in \"sortingStrategy\", and the query is executed using that index instead of main's.  In addition to \"sortingStrategy\", this parameter is also used to apply a matching Composition Rule that contains a condition defined to trigger on \"sortBy\", see Composition Rules.  If no value is provided or an invalid value, no sorting strategy is applied.
+      attr_accessor :sort_by
+
       # Unique pseudonymous or anonymous user identifier.  This helps with analytics and click and conversion events. For more information, see [user token](https://www.algolia.com/doc/guides/sending-events/concepts/usertoken).
       attr_accessor :user_token
 
@@ -117,9 +120,10 @@ def self.attribute_map
           :optional_filters => :optionalFilters,
           :page => :page,
           :query => :query,
-          :relevancy_strictness => :relevancyStrictness,
           :query_languages => :queryLanguages,
+          :relevancy_strictness => :relevancyStrictness,
           :rule_contexts => :ruleContexts,
+          :sort_by => :sortBy,
           :user_token => :userToken
         }
       end
@@ -152,9 +156,10 @@ def self.types_mapping
           :optional_filters => :"OptionalFilters",
           :page => :"Integer",
           :query => :"String",
-          :relevancy_strictness => :"Integer",
           :query_languages => :"Array<SupportedLanguage>",
+          :relevancy_strictness => :"Integer",
           :rule_contexts => :"Array<String>",
+          :sort_by => :"String",
           :user_token => :"String"
         }
       end
@@ -298,22 +303,26 @@ def initialize(attributes = {})
           self.query = attributes[:query]
         end
 
-        if attributes.key?(:relevancy_strictness)
-          self.relevancy_strictness = attributes[:relevancy_strictness]
-        end
-
         if attributes.key?(:query_languages)
           if (value = attributes[:query_languages]).is_a?(Array)
             self.query_languages = value
           end
         end
 
+        if attributes.key?(:relevancy_strictness)
+          self.relevancy_strictness = attributes[:relevancy_strictness]
+        end
+
         if attributes.key?(:rule_contexts)
           if (value = attributes[:rule_contexts]).is_a?(Array)
             self.rule_contexts = value
           end
         end
 
+        if attributes.key?(:sort_by)
+          self.sort_by = attributes[:sort_by]
+        end
+
         if attributes.key?(:user_token)
           self.user_token = attributes[:user_token]
         end
@@ -349,9 +358,10 @@ def ==(other)
           optional_filters == other.optional_filters &&
           page == other.page &&
           query == other.query &&
-          relevancy_strictness == other.relevancy_strictness &&
           query_languages == other.query_languages &&
+          relevancy_strictness == other.relevancy_strictness &&
           rule_contexts == other.rule_contexts &&
+          sort_by == other.sort_by &&
           user_token == other.user_token
       end
 
@@ -390,9 +400,10 @@ def hash
           optional_filters,
           page,
           query,
-          relevancy_strictness,
           query_languages,
+          relevancy_strictness,
           rule_contexts,
+          sort_by,
           user_token
         ].hash
       end