From a6529584a543d549da23c967046da401f8b3b33d Mon Sep 17 00:00:00 2001
From: Scott Cazan <scottcazan@gmail.com>
Date: Wed, 5 Feb 2025 11:52:35 +0100
Subject: [PATCH] Handle Errors from Unresolved Refs (#2810)

---
 .changeset/spicy-ravens-live.md              | 5 +++++
 packages/react-openapi/src/OpenAPISchema.tsx | 7 +++++--
 packages/react-openapi/src/utils.ts          | 2 +-
 3 files changed, 11 insertions(+), 3 deletions(-)
 create mode 100644 .changeset/spicy-ravens-live.md

diff --git a/.changeset/spicy-ravens-live.md b/.changeset/spicy-ravens-live.md
new file mode 100644
index 000000000..68b671baa
--- /dev/null
+++ b/.changeset/spicy-ravens-live.md
@@ -0,0 +1,5 @@
+---
+'@gitbook/react-openapi': patch
+---
+
+Fix error on unresolvable refs by replacing with property name and any type
diff --git a/packages/react-openapi/src/OpenAPISchema.tsx b/packages/react-openapi/src/OpenAPISchema.tsx
index 6f2b396db..ec875242f 100644
--- a/packages/react-openapi/src/OpenAPISchema.tsx
+++ b/packages/react-openapi/src/OpenAPISchema.tsx
@@ -5,7 +5,7 @@ import React, { useId } from 'react';
 import { InteractiveSection } from './InteractiveSection';
 import { Markdown } from './Markdown';
 import { OpenAPIClientContext } from './types';
-import { noReference } from './utils';
+import { checkIsReference, noReference } from './utils';
 import { stringifyOpenAPI } from './stringifyOpenAPI';
 
 type CircularRefsIds = Map<OpenAPIV3.SchemaObject, string>;
@@ -278,7 +278,10 @@ function getSchemaProperties(schema: OpenAPIV3.SchemaObject): null | OpenAPISche
 
         if (schema.properties) {
             Object.entries(schema.properties).forEach(([propertyName, rawPropertySchema]) => {
-                const propertySchema = noReference(rawPropertySchema);
+                const isReference = checkIsReference(rawPropertySchema);
+                const propertySchema: OpenAPIV3.SchemaObject = isReference
+                    ? { propertyName }
+                    : rawPropertySchema;
                 if (propertySchema.deprecated) {
                     return;
                 }
diff --git a/packages/react-openapi/src/utils.ts b/packages/react-openapi/src/utils.ts
index 7b2ae87d4..49e7ef3ca 100644
--- a/packages/react-openapi/src/utils.ts
+++ b/packages/react-openapi/src/utils.ts
@@ -8,7 +8,7 @@ export function noReference<T>(input: T | OpenAPIV3.ReferenceObject): T {
     return input;
 }
 
-function checkIsReference(input: unknown): input is OpenAPIV3.ReferenceObject {
+export function checkIsReference(input: unknown): input is OpenAPIV3.ReferenceObject {
     return typeof input === 'object' && !!input && '$ref' in input;
 }