Less strict OpenAPI parser (#3529)

Co-authored-by: Nolann Biron <[email protected]>

Author: gregberge

.changeset/smooth-apes-smell.md

@@ -0,0 +1,5 @@
+---
+"gitbook": patch
+---
+
+Update OpenAPI parser

.changeset/two-apples-decide.md

@@ -0,0 +1,5 @@
+---
+"@gitbook/openapi-parser": major
+---
+
+Less strict OpenAPI parser, now returns { errors, filesystem }

packages/gitbook/src/lib/openapi/enrich.test.ts

@@ -7,7 +7,7 @@ const spec = await Bun.file(new URL('./fixtures/multiline-spec.yaml', import.met
 
 describe('#enrichFilesystem', () => {
     it('supports multiline descriptions', async () => {
-        const filesystem = await parseOpenAPI({
+        const { filesystem } = await parseOpenAPI({
             value: spec,
             rootURL: null,
         });

packages/gitbook/src/lib/openapi/fetch.ts

@@ -108,13 +108,7 @@ async function fetchFilesystemUncached(
     }
 
     const text = await response.text();
-    const filesystem = await parseOpenAPI({
-        value: text,
-        rootURL: url,
-        // If we fetch the OpenAPI specification
-        // it's the legacy system, it means the spec can be trusted here.
-        trust: true,
-    });
+    const { filesystem } = await parseOpenAPI({ value: text, rootURL: url });
     const richFilesystem = await enrichFilesystem(filesystem);
 
     return richFilesystem;