fix(specs): rules and objects parameters

Author: shortcuts

specs/common/schemas/IndexSettings.yml

@@ -321,13 +321,7 @@ indexSettingsAsSearchParams:
       x-categories:
         - Query strategy
     distinct:
-      type: integer
-      minimum: 0
-      maximum: 4
-      description: Enables de-duplication or grouping of results.
-      default: 0
-      x-categories:
-        - Advanced
+      $ref: '#/distinct'
     synonyms:
       type: boolean
       description: Whether to take into account an index's synonyms for a particular search.
@@ -425,6 +419,17 @@ advancedSyntaxFeatures:
   x-categories:
     - Query strategy
 
+distinct:
+  description: Enables de-duplication or grouping of results.
+  oneOf:
+    - type: boolean
+    - type: integer
+      minimum: 0
+      maximum: 4
+      default: 0
+  x-categories:
+    - Advanced
+
 typoTolerance:
   description: Controls whether typo tolerance is enabled and how it is applied.
   oneOf:

specs/search/common/schemas/listIndicesResponse.yml

@@ -11,6 +11,8 @@ listIndicesResponse:
       type: integer
       description: Number of pages.
       example: 100
+    required:
+      - items
 
 fetchedIndex:
   type: object

specs/search/paths/objects/batch.yml

@@ -19,7 +19,7 @@ post:
             requests:
               type: array
               items:
-                title: batchOperation
+                title: batchRequest
                 type: object
                 additionalProperties: false
                 properties:

specs/search/paths/objects/multipleGetObjects.yml renamed to specs/search/paths/objects/getObjects.yml

@@ -21,7 +21,7 @@ post:
               type: array
               items:
                 description: getObjects operation on an index.
-                title: multipleGetObjectsParams
+                title: getObjectsRequest
                 type: object
                 additionalProperties: false
                 required:
@@ -55,6 +55,9 @@ post:
                 items:
                   type: object
                   description: Fetched object.
+                  x-is-generic: true
+              required:
+                - results
     '400':
       $ref: '../../../common/responses/BadRequest.yml'
     '402':

specs/search/paths/objects/multipleBatch.yml

@@ -17,7 +17,7 @@ post:
             requests:
               type: array
               items:
-                title: multipleBatchOperation
+                title: multipleBatchRequest
                 type: object
                 additionalProperties: false
                 properties:

specs/search/paths/objects/objects.yml

@@ -29,6 +29,9 @@ post:
                 $ref: '../../../common/responses/common.yml#/taskID'
               objectID:
                 $ref: '../../../common/parameters.yml#/objectID'
+            required:
+              - taskID
+              - createdAt
     '400':
       $ref: '../../../common/responses/BadRequest.yml'
     '402':

specs/search/paths/rules/common/schemas.yml

@@ -1,3 +1,9 @@
+rules:
+  type: array
+  description: Rules to add.
+  items:
+    $ref: '#/rule'
+
 rule:
   type: object
   description: Rule object.

specs/search/paths/rules/saveRules.yml

@@ -13,10 +13,7 @@ post:
     content:
       application/json:
         schema:
-          type: array
-          description: Rules to add.
-          items:
-            $ref: 'common/schemas.yml#/rule'
+          $ref: 'common/schemas.yml#/rules'
   responses:
     '200':
       $ref: '../../../common/responses/UpdatedAt.yml'

specs/search/spec.yml

@@ -115,7 +115,7 @@ paths:
   /1/indexes/*/batch:
     $ref: 'paths/objects/multipleBatch.yml'
   /1/indexes/*/objects:
-    $ref: 'paths/objects/multipleGetObjects.yml'
+    $ref: 'paths/objects/getObjects.yml'
 
   # ##########################
   # ### Settings Endpoints ###

tests/CTS/methods/requests/search/setSettings.json

@@ -147,6 +147,46 @@
       }
     }
   },
+  {
+    "testName": "setSettings allow boolean `distinct`",
+    "parameters": {
+      "indexName": "theIndexName",
+      "indexSettings": {
+        "distinct": true
+      },
+      "forwardToReplicas": true
+    },
+    "request": {
+      "path": "/1/indexes/theIndexName/settings",
+      "method": "PUT",
+      "body": {
+        "distinct": true
+      },
+      "queryParameters": {
+        "forwardToReplicas": "true"
+      }
+    }
+  },
+  {
+    "testName": "setSettings allow integers for `distinct`",
+    "parameters": {
+      "indexName": "theIndexName",
+      "indexSettings": {
+        "distinct": 1
+      },
+      "forwardToReplicas": true
+    },
+    "request": {
+      "path": "/1/indexes/theIndexName/settings",
+      "method": "PUT",
+      "body": {
+        "distinct": 1
+      },
+      "queryParameters": {
+        "forwardToReplicas": "true"
+      }
+    }
+  },
   {
     "testName": "setSettings allow all `indexSettings`",
     "parameters": {