chore(oas): clean up oas (#9354)

* clean up generated oas

* fix issues in docs-util

* more fixes

* align max level

* validation fix

* add missing summaries

* fix validation

* fix exchanges route

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

@@ -31,7 +31,7 @@ class OasSchemaHelper {
   private schemas: Map<string, OpenApiSchema>
   protected schemaRefPrefix = "#/components/schemas/"
   protected formatter: Formatter
-  private MAX_LEVEL = 5
+  private MAX_LEVEL = 7
   /**
    * The path to the directory holding the base YAML files.
    */
@@ -356,7 +356,10 @@ class OasSchemaHelper {
     return name
       .replace("DTO", "")
       .replace(this.schemaRefPrefix, "")
-      .replace(/(?<!(AdminProduct|CreateProduct))Type$/, "")
+      .replace(
+        /(?<!(AdminProduct|CreateProduct|StoreShippingOption|AdminShippingOption))Type$/,
+        ""
+      )
   }
 
   /**

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

@@ -37,34 +37,6 @@ class SchemaFactory {
     BigNumberValue: {
       type: "number",
     },
-    expand: {
-      type: "string",
-      title: "expand",
-      description:
-        "Comma-separated relations that should be expanded in the returned data.",
-    },
-    fields: {
-      type: "string",
-      title: "fields",
-      description:
-        "Comma-separated fields that should be included in the returned data. if a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. without prefix it will replace the entire default fields.",
-    },
-    offset: {
-      type: "number",
-      title: "offset",
-      description: "The number of items to skip when retrieving a list.",
-    },
-    limit: {
-      type: "number",
-      title: "limit",
-      description: "Limit the number of items returned in the list.",
-    },
-    order: {
-      type: "string",
-      title: "order",
-      description:
-        "The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.",
-    },
     File: {
       type: "object",
       description: "A File to upload.",
@@ -86,6 +58,41 @@ class SchemaFactory {
       },
     },
   }
+
+  /**
+   * Schemas used only for query types
+   */
+  private schemasForQuery: Record<string, OpenApiSchema> = {
+    expand: {
+      type: "string",
+      title: "expand",
+      description:
+        "Comma-separated relations that should be expanded in the returned data.",
+    },
+    fields: {
+      type: "string",
+      title: "fields",
+      description:
+        "Comma-separated fields that should be included in the returned data. If a field is prefixed with `+` it will be added to the default fields, using `-` will remove it from the default fields. Without prefix it will replace the entire default fields.",
+    },
+    offset: {
+      type: "number",
+      title: "offset",
+      description: "The number of items to skip when retrieving a list.",
+    },
+    limit: {
+      type: "number",
+      title: "limit",
+      description: "Limit the number of items returned in the list.",
+    },
+    order: {
+      type: "string",
+      title: "order",
+      description:
+        "The field to sort the data by. By default, the sort order is ascending. To change the order to descending, prefix the field name with `-`.",
+    },
+  }
+
   /**
    * Schemas used only for response types.
    */
@@ -119,7 +126,9 @@ class SchemaFactory {
     const schemasFactory =
       type === "response"
         ? this.mergeSchemas(this.schemasForResponse, this.schemas)
-        : this.cloneSchema(this.schemas)
+        : type === "query"
+          ? this.mergeSchemas(this.schemasForQuery, this.schemas)
+          : this.cloneSchema(this.schemas)
     const key = Object.hasOwn(schemasFactory, name)
       ? name
       : additionalData?.title || ""