add option to preserveExistingSchemas

applications/__tests__/__snapshots__/e2e.test.js.snap

@@ -210,6 +210,46 @@ components: {}
 
 exports[`bundle > do not bundle an openapi with type never 1`] = `undefined`;
 
+exports[`bundle > preserve existing schemas if preserveExistingSchemas is true 1`] = `
+"openapi: 3.1.0
+info:
+  title: Test
+  version: 1.0.0
+paths:
+  /test:
+    get:
+      responses:
+        '200':
+          description: Test
+          content:
+            application/json:
+              x-type: string
+              schema:
+                type: number
+components: {}
+"
+`;
+
+exports[`bundle > replace existing schemas by default 1`] = `
+"openapi: 3.1.0
+info:
+  title: Test
+  version: 1.0.0
+paths:
+  /test:
+    get:
+      responses:
+        '200':
+          description: Test
+          content:
+            application/json:
+              x-type: string
+              schema:
+                type: string
+components: {}
+"
+`;
+
 exports[`bundle > resolve and translate $ands 1`] = `
 "openapi: 3.1.0
 info:

applications/__tests__/e2e.test.js

@@ -83,6 +83,20 @@ describe("bundle", () => {
     )
     expect(stdout).toMatchSnapshot()
   })
+
+  test("replace existing schemas by default", () => {
+    const {stdout: notPreserved} = runCommand(
+      "redocly bundle applications/resources/openapi-with-schema.yaml --config=applications/x-redocly.yaml"
+    )
+    expect(notPreserved).toMatchSnapshot()
+  })
+
+  test("preserve existing schemas if preserveExistingSchemas is true", () => {
+    const {stdout: preserved} = runCommand(
+      "redocly bundle applications/resources/openapi-with-schema.yaml --config=applications/x-preserve-schemas-redocly.yaml"
+    )
+    expect(preserved).toMatchSnapshot()
+  })
 })
 
 describe("lint", () => {

applications/resources/openapi-with-schema.yaml

@@ -0,0 +1,15 @@
+openapi: 3.1.0
+info:
+  title: Test
+  version: 1.0.0
+paths:
+  /test:
+    get:
+      responses:
+        200:
+          description: Test
+          content:
+            application/json:
+              x-type: string
+              schema:
+                type: number

applications/x-preserve-schemas-redocly.yaml

@@ -0,0 +1,6 @@
+extends:
+  - x-redocly.yaml
+
+preprocessors:
+  x-types/generate-schemas:
+    preserveExistingSchemas: true

applications/x-types-decorators.js

@@ -2,12 +2,17 @@ const {isObject} = require("./x-types-utils")
 const {translateXTypeToSchema} = require("./x-types-adapter")
 const {resolveAndMerge} = require("./x-types-resolver")
 
-const generateSchema = () => {
+const generateSchema = opts => {
+  const preserveExistingSchemas = !!opts?.preserveExistingSchemas
   return {
     MediaType: {
       leave(mediaType, ctx) {
         const original = mediaType["x-type"]
-        if (typeof original === "undefined") return
+        if (
+          typeof original === "undefined" ||
+          (preserveExistingSchemas && mediaType.schema)
+        )
+          return
         const resolvedXType = resolveAndMerge(original, ctx)
         const schema = translateXTypeToSchema(resolvedXType)
         mediaType.schema = schema
@@ -16,7 +21,11 @@ const generateSchema = () => {
     Parameter: {
       leave(parameter, ctx) {
         const original = parameter["x-type"]
-        if (typeof original === "undefined") return
+        if (
+          typeof original === "undefined" ||
+          (preserveExistingSchemas && parameter.schema)
+        )
+          return
         const resolvedXType = resolveAndMerge(original, ctx)
         const schema = translateXTypeToSchema(resolvedXType)
         parameter.schema = schema