Merge branch 'main' into chore/renovateBaseBranch

Author: Fluf22

clients/algoliasearch-client-csharp/algoliasearch/Clients/SearchClient.cs

@@ -1235,6 +1235,7 @@ Rule GetRule(
   /// Required API Key ACLs:
   ///   - settings
   /// <param name="indexName">Name of the index on which to perform the operation.</param>
+  /// <param name="getVersion">When set to 2, the endpoint will not include `synonyms` in the response. This parameter is here for backward compatibility. (optional, default to 1)</param>
   /// <param name="options">Add extra http header or query parameters to Algolia.</param>
   /// <param name="cancellationToken">Cancellation Token to cancel the request.</param>
   /// <exception cref="ArgumentException">Thrown when arguments are not correct</exception>
@@ -1243,6 +1244,7 @@ Rule GetRule(
   /// <returns>Task of SettingsResponse</returns>
   Task<SettingsResponse> GetSettingsAsync(
     string indexName,
+    int? getVersion = default,
     RequestOptions options = null,
     CancellationToken cancellationToken = default
   );
@@ -1254,6 +1256,7 @@ Task<SettingsResponse> GetSettingsAsync(
   /// Required API Key ACLs:
   ///   - settings
   /// <param name="indexName">Name of the index on which to perform the operation.</param>
+  /// <param name="getVersion">When set to 2, the endpoint will not include `synonyms` in the response. This parameter is here for backward compatibility. (optional, default to 1)</param>
   /// <param name="options">Add extra http header or query parameters to Algolia.</param>
   /// <param name="cancellationToken">Cancellation Token to cancel the request.</param>
   /// <exception cref="ArgumentException">Thrown when arguments are not correct</exception>
@@ -1262,6 +1265,7 @@ Task<SettingsResponse> GetSettingsAsync(
   /// <returns>SettingsResponse</returns>
   SettingsResponse GetSettings(
     string indexName,
+    int? getVersion = default,
     RequestOptions options = null,
     CancellationToken cancellationToken = default
   );
@@ -3731,6 +3735,7 @@ public Rule GetRule(
   /// <inheritdoc />
   public async Task<SettingsResponse> GetSettingsAsync(
     string indexName,
+    int? getVersion = default,
     RequestOptions options = null,
     CancellationToken cancellationToken = default
   )
@@ -3742,6 +3747,7 @@ public async Task<SettingsResponse> GetSettingsAsync(
 
     requestOptions.PathParameters.Add("indexName", QueryStringHelper.ParameterToString(indexName));
 
+    requestOptions.AddQueryParameter("getVersion", getVersion);
     return await _transport
       .ExecuteRequestAsync<SettingsResponse>(
         new HttpMethod("GET"),
@@ -3755,9 +3761,11 @@ public async Task<SettingsResponse> GetSettingsAsync(
   /// <inheritdoc />
   public SettingsResponse GetSettings(
     string indexName,
+    int? getVersion = default,
     RequestOptions options = null,
     CancellationToken cancellationToken = default
-  ) => AsyncHelper.RunSync(() => GetSettingsAsync(indexName, options, cancellationToken));
+  ) =>
+    AsyncHelper.RunSync(() => GetSettingsAsync(indexName, getVersion, options, cancellationToken));
 
   /// <inheritdoc />
   public async Task<List<Source>> GetSourcesAsync(

clients/algoliasearch-client-csharp/algoliasearch/Utils/SearchClientExtensions.cs

@@ -1157,7 +1157,7 @@ public async Task<bool> IndexExistsAsync(
   {
     try
     {
-      await GetSettingsAsync(indexName, null, cancellationToken);
+      await GetSettingsAsync(indexName, null, null, cancellationToken);
     }
     catch (AlgoliaApiException ex) when (ex.HttpErrorCode == 404)
     {

clients/algoliasearch-client-dart/packages/client_search/lib/src/api/search_client.dart

@@ -1168,9 +1168,11 @@ final class SearchClient implements ApiClient {
   ///
   /// Parameters:
   /// * [indexName] Name of the index on which to perform the operation.
+  /// * [getVersion] When set to 2, the endpoint will not include `synonyms` in the response. This parameter is here for backward compatibility.
   /// * [requestOptions] additional request configuration.
   Future<SettingsResponse> getSettings({
     required String indexName,
+    int? getVersion,
     RequestOptions? requestOptions,
   }) async {
     assert(
@@ -1181,6 +1183,9 @@ final class SearchClient implements ApiClient {
       method: RequestMethod.get,
       path: r'/1/indexes/{indexName}/settings'.replaceAll(
           '{' r'indexName' '}', Uri.encodeComponent(indexName.toString())),
+      queryParams: {
+        if (getVersion != null) 'getVersion': getVersion,
+      },
     );
     final response = await _retryStrategy.execute(
       request: request,

clients/algoliasearch-client-go/algolia/search/api_search.go

@@ -2745,6 +2745,33 @@ public CompletableFuture<Rule> getRuleAsync(@Nonnull String indexName, @Nonnull
     return this.getRuleAsync(indexName, objectID, null);
   }
 
+  /**
+   * Retrieves an object with non-null index settings.
+   *
+   * @param indexName Name of the index on which to perform the operation. (required)
+   * @param getVersion When set to 2, the endpoint will not include `synonyms` in the response. This
+   *     parameter is here for backward compatibility. (optional, default to 1)
+   * @param requestOptions The requestOptions to send along with the query, they will be merged with
+   *     the transporter requestOptions.
+   * @throws AlgoliaRuntimeException If it fails to process the API call
+   */
+  public SettingsResponse getSettings(@Nonnull String indexName, Integer getVersion, @Nullable RequestOptions requestOptions)
+    throws AlgoliaRuntimeException {
+    return LaunderThrowable.await(getSettingsAsync(indexName, getVersion, requestOptions));
+  }
+
+  /**
+   * Retrieves an object with non-null index settings.
+   *
+   * @param indexName Name of the index on which to perform the operation. (required)
+   * @param getVersion When set to 2, the endpoint will not include `synonyms` in the response. This
+   *     parameter is here for backward compatibility. (optional, default to 1)
+   * @throws AlgoliaRuntimeException If it fails to process the API call
+   */
+  public SettingsResponse getSettings(@Nonnull String indexName, Integer getVersion) throws AlgoliaRuntimeException {
+    return this.getSettings(indexName, getVersion, null);
+  }
+
   /**
    * Retrieves an object with non-null index settings.
    *
@@ -2754,7 +2781,7 @@ public CompletableFuture<Rule> getRuleAsync(@Nonnull String indexName, @Nonnull
    * @throws AlgoliaRuntimeException If it fails to process the API call
    */
   public SettingsResponse getSettings(@Nonnull String indexName, @Nullable RequestOptions requestOptions) throws AlgoliaRuntimeException {
-    return LaunderThrowable.await(getSettingsAsync(indexName, requestOptions));
+    return this.getSettings(indexName, null, requestOptions);
   }
 
   /**
@@ -2764,33 +2791,68 @@ public SettingsResponse getSettings(@Nonnull String indexName, @Nullable Request
    * @throws AlgoliaRuntimeException If it fails to process the API call
    */
   public SettingsResponse getSettings(@Nonnull String indexName) throws AlgoliaRuntimeException {
-    return this.getSettings(indexName, null);
+    return this.getSettings(indexName, null, null);
   }
 
   /**
    * (asynchronously) Retrieves an object with non-null index settings.
    *
    * @param indexName Name of the index on which to perform the operation. (required)
+   * @param getVersion When set to 2, the endpoint will not include `synonyms` in the response. This
+   *     parameter is here for backward compatibility. (optional, default to 1)
    * @param requestOptions The requestOptions to send along with the query, they will be merged with
    *     the transporter requestOptions.
    * @throws AlgoliaRuntimeException If it fails to process the API call
    */
-  public CompletableFuture<SettingsResponse> getSettingsAsync(@Nonnull String indexName, @Nullable RequestOptions requestOptions)
-    throws AlgoliaRuntimeException {
+  public CompletableFuture<SettingsResponse> getSettingsAsync(
+    @Nonnull String indexName,
+    Integer getVersion,
+    @Nullable RequestOptions requestOptions
+  ) throws AlgoliaRuntimeException {
     Parameters.requireNonNull(indexName, "Parameter `indexName` is required when calling `getSettings`.");
 
-    HttpRequest request = HttpRequest.builder().setPath("/1/indexes/{indexName}/settings", indexName).setMethod("GET").build();
+    HttpRequest request = HttpRequest.builder()
+      .setPath("/1/indexes/{indexName}/settings", indexName)
+      .setMethod("GET")
+      .addQueryParameter("getVersion", getVersion)
+      .build();
     return executeAsync(request, requestOptions, new TypeReference<SettingsResponse>() {});
   }
 
+  /**
+   * (asynchronously) Retrieves an object with non-null index settings.
+   *
+   * @param indexName Name of the index on which to perform the operation. (required)
+   * @param getVersion When set to 2, the endpoint will not include `synonyms` in the response. This
+   *     parameter is here for backward compatibility. (optional, default to 1)
+   * @throws AlgoliaRuntimeException If it fails to process the API call
+   */
+  public CompletableFuture<SettingsResponse> getSettingsAsync(@Nonnull String indexName, Integer getVersion)
+    throws AlgoliaRuntimeException {
+    return this.getSettingsAsync(indexName, getVersion, null);
+  }
+
+  /**
+   * (asynchronously) Retrieves an object with non-null index settings.
+   *
+   * @param indexName Name of the index on which to perform the operation. (required)
+   * @param requestOptions The requestOptions to send along with the query, they will be merged with
+   *     the transporter requestOptions.
+   * @throws AlgoliaRuntimeException If it fails to process the API call
+   */
+  public CompletableFuture<SettingsResponse> getSettingsAsync(@Nonnull String indexName, @Nullable RequestOptions requestOptions)
+    throws AlgoliaRuntimeException {
+    return this.getSettingsAsync(indexName, null, requestOptions);
+  }
+
   /**
    * (asynchronously) Retrieves an object with non-null index settings.
    *
    * @param indexName Name of the index on which to perform the operation. (required)
    * @throws AlgoliaRuntimeException If it fails to process the API call
    */
   public CompletableFuture<SettingsResponse> getSettingsAsync(@Nonnull String indexName) throws AlgoliaRuntimeException {
-    return this.getSettingsAsync(indexName, null);
+    return this.getSettingsAsync(indexName, null, null);
   }
 
   /**

clients/algoliasearch-client-java/algoliasearch/src/main/java/com/algolia/api/SearchClient.java

@@ -1,5 +1,7 @@
 // Code generated by OpenAPI Generator (https://openapi-generator.tech), manual changes will be lost - read more on https://github.com/algolia/api-clients-automation. DO NOT EDIT.
 
+import type { Composition } from '../model/composition';
+import type { CompositionRule } from '../model/compositionRule';
 import type { CompositionRulesBatchParams } from '../model/compositionRulesBatchParams';
 
 import type { RequestBody } from '../model/requestBody';
@@ -72,6 +74,30 @@ export type CustomPutProps = {
   body?: Record<string, unknown> | undefined;
 };
 
+/**
+ * Properties for the `deleteComposition` method.
+ */
+export type DeleteCompositionProps = {
+  /**
+   * Unique Composition ObjectID.
+   */
+  compositionID: string;
+};
+
+/**
+ * Properties for the `deleteCompositionRule` method.
+ */
+export type DeleteCompositionRuleProps = {
+  /**
+   * Unique Composition ObjectID.
+   */
+  compositionID: string;
+  /**
+   * Unique identifier of a rule object.
+   */
+  objectID: string;
+};
+
 /**
  * Properties for the `getComposition` method.
  */
@@ -124,6 +150,32 @@ export type ListCompositionsProps = {
   hitsPerPage?: number | undefined;
 };
 
+/**
+ * Properties for the `putComposition` method.
+ */
+export type PutCompositionProps = {
+  /**
+   * Unique Composition ObjectID.
+   */
+  compositionID: string;
+  composition: Composition;
+};
+
+/**
+ * Properties for the `putCompositionRule` method.
+ */
+export type PutCompositionRuleProps = {
+  /**
+   * Unique Composition ObjectID.
+   */
+  compositionID: string;
+  /**
+   * Unique identifier of a rule object.
+   */
+  objectID: string;
+  compositionRule: CompositionRule;
+};
+
 /**
  * Properties for the `saveRules` method.
  */

clients/algoliasearch-client-javascript/packages/client-composition/model/clientMethodProps.ts

@@ -101,6 +101,7 @@ export * from './snippetResult';
 export * from './snippetResultOption';
 export * from './sortRemainingBy';
 export * from './supportedLanguage';
+export * from './taskIDResponse';
 export * from './taskStatus';
 export * from './timeRange';
 export * from './typoTolerance';

clients/algoliasearch-client-javascript/packages/client-composition/model/index.ts

@@ -0,0 +1,8 @@
+// Code generated by OpenAPI Generator (https://openapi-generator.tech), manual changes will be lost - read more on https://github.com/algolia/api-clients-automation. DO NOT EDIT.
+
+export type TaskIDResponse = {
+  /**
+   * Unique identifier of a task.  A successful API response means that a task was added to a queue. It might not run immediately. You can check the task\'s progress with the [`task` operation](#tag/Indices/operation/getTask) and this `taskID`.
+   */
+  taskID: number;
+};