docs-util: fix OAS generation error (#8577)

www/utils/packages/docs-generator/src/classes/helpers/schema-factory.ts

@@ -27,6 +27,22 @@ class SchemaFactory {
       type: "string",
       format: "date-time",
     },
+    $and: {
+      type: "array",
+      description:
+        "Join query parameters with an AND condition. Each object's content is the same type as the expected query parameters.",
+      items: {
+        type: "object",
+      },
+    },
+    $or: {
+      type: "array",
+      description:
+        "Join query parameters with an OR condition. Each object's content is the same type as the expected query parameters.",
+      items: {
+        type: "object",
+      },
+    },
   }
 
   /**

www/utils/packages/docs-generator/src/classes/kinds/oas.ts

@@ -1653,9 +1653,21 @@ class OasKindGenerator extends FunctionKindGenerator {
         (updatedParameter.schema as OpenApiSchema).type !==
         (parameter.schema as OpenApiSchema).type
       ) {
-        ;(parameter.schema as OpenApiSchema).type = (
-          updatedParameter.schema as OpenApiSchema
-        ).type
+        // the entire schema should be updated if the type changes.
+        parameter.schema = updatedParameter.schema
+      } else if ((updatedParameter.schema as OpenApiSchema).type === "array") {
+        ;(parameter.schema as OpenAPIV3.ArraySchemaObject).items =
+          this.updateSchema({
+            oldSchema: (parameter.schema as OpenAPIV3.ArraySchemaObject).items,
+            newSchema: (updatedParameter.schema as OpenAPIV3.ArraySchemaObject)
+              .items,
+          }) || (updatedParameter.schema as OpenAPIV3.ArraySchemaObject).items
+      } else if ((updatedParameter.schema as OpenApiSchema).type === "object") {
+        parameter.schema =
+          this.updateSchema({
+            oldSchema: parameter.schema,
+            newSchema: updatedParameter.schema,
+          }) || updatedParameter.schema
       }
 
       if (