fix: remove nullable Json node params

MaggieKimani1 · MaggieKimani1 · commit 80edd6679eb2 · 2025-02-25T15:14:47.000+03:00
diff --git a/src/Microsoft.OpenApi.Readers/OpenApiYamlReader.cs b/src/Microsoft.OpenApi.Readers/OpenApiYamlReader.cs
@@ -110,7 +110,7 @@ public static ReadResult Read(JsonNode jsonNode, OpenApiReaderSettings settings)
         }
 
         /// <inheritdoc/>
-        public static T ReadFragment<T>(JsonNode input, OpenApiSpecVersion version, OpenApiDocument openApiDocument, out OpenApiDiagnostic diagnostic, OpenApiReaderSettings? settings = null) where T : IOpenApiElement
+        public static T? ReadFragment<T>(JsonNode input, OpenApiSpecVersion version, OpenApiDocument openApiDocument, out OpenApiDiagnostic diagnostic, OpenApiReaderSettings? settings = null) where T : IOpenApiElement
         {
             return _jsonReader.ReadFragment<T>(input, version, openApiDocument, out diagnostic, settings);
         }
diff --git a/src/Microsoft.OpenApi/Models/OpenApiRequestBody.cs b/src/Microsoft.OpenApi/Models/OpenApiRequestBody.cs
@@ -108,10 +108,11 @@ public IOpenApiParameter ConvertToBodyParameter(IOpenApiWriter writer)
                 Extensions = Extensions?.ToDictionary(static k => k.Key, static v => v.Value)
             };
             // Clone extensions so we can remove the x-bodyName extensions from the output V2 model.
-            if (bodyParameter.Extensions is not null && bodyParameter.Extensions.TryGetValue(OpenApiConstants.BodyName, out var bodyNameExtension))
+            if (bodyParameter.Extensions is not null && 
+                bodyParameter.Extensions.TryGetValue(OpenApiConstants.BodyName, out var bodyNameExtension) &&
+                bodyNameExtension is OpenApiAny bodyName)
             {
-                var bodyName = bodyNameExtension as OpenApiAny;
-                bodyParameter.Name = string.IsNullOrEmpty(bodyName?.Node?.ToString()) ? "body" : bodyName?.Node?.ToString();
+                bodyParameter.Name = string.IsNullOrEmpty(bodyName.Node.ToString()) ? "body" : bodyName.Node.ToString();
                 bodyParameter.Extensions.Remove(OpenApiConstants.BodyName);
             }
             return bodyParameter;
diff --git a/src/Microsoft.OpenApi/Reader/OpenApiJsonReader.cs b/src/Microsoft.OpenApi/Reader/OpenApiJsonReader.cs
@@ -40,7 +40,7 @@ public ReadResult Read(MemoryStream input,
             // Parse the JSON text in the stream into JsonNodes
             try
             {
-                jsonNode = JsonNode.Parse(input);
+                jsonNode = JsonNode.Parse(input) ?? throw new InvalidOperationException($"Cannot parse input stream, {nameof(input)}.");
             }
             catch (JsonException ex)
             {
@@ -61,7 +61,7 @@ public ReadResult Read(MemoryStream input,
         /// <param name="jsonNode">The JsonNode input.</param>
         /// <param name="settings">The Reader settings to be used during parsing.</param>
         /// <returns></returns>
-        public ReadResult Read(JsonNode? jsonNode,
+        public ReadResult Read(JsonNode jsonNode,
                                OpenApiReaderSettings settings)
         {
             if (jsonNode is null) throw new ArgumentNullException(nameof(jsonNode));
@@ -131,7 +131,8 @@ public async Task<ReadResult> ReadAsync(Stream input,
             // Parse the JSON text in the stream into JsonNodes
             try
             {
-                jsonNode = await JsonNode.ParseAsync(input, cancellationToken: cancellationToken).ConfigureAwait(false);
+                jsonNode = await JsonNode.ParseAsync(input, cancellationToken: cancellationToken).ConfigureAwait(false) ??
+                    throw new InvalidOperationException($"failed to parse input stream, {nameof(input)}");
             }
             catch (JsonException ex)
             {
@@ -156,12 +157,12 @@ public async Task<ReadResult> ReadAsync(Stream input,
             Utils.CheckArgumentNull(input);
             Utils.CheckArgumentNull(openApiDocument);
 
-            JsonNode? jsonNode;
+            JsonNode jsonNode;
 
             // Parse the JSON
             try
             {
-                jsonNode = JsonNode.Parse(input);
+                jsonNode = JsonNode.Parse(input) ?? throw new InvalidOperationException($"Failed to parse stream, {nameof(input)}");
             }
             catch (JsonException ex)
             {
@@ -174,11 +175,11 @@ public async Task<ReadResult> ReadAsync(Stream input,
         }
 
         /// <inheritdoc/>
-        public T ReadFragment<T>(JsonNode? input,
-                 OpenApiSpecVersion version,
-                 OpenApiDocument openApiDocument,
-                 out OpenApiDiagnostic diagnostic,
-                 OpenApiReaderSettings? settings = null) where T : IOpenApiElement
+        public T? ReadFragment<T>(JsonNode input,
+         OpenApiSpecVersion version,
+         OpenApiDocument openApiDocument,
+         out OpenApiDiagnostic diagnostic,
+         OpenApiReaderSettings? settings = null) where T : IOpenApiElement
         {
             diagnostic = new();
             settings ??= new OpenApiReaderSettings();
@@ -211,7 +212,7 @@ public T ReadFragment<T>(JsonNode? input,
                 }
             }
 
-            return (T?)element!;
+            return (T?)element;
         }
     }
 }
diff --git a/src/Microsoft.OpenApi/Reader/V2/OpenApiOperationDeserializer.cs b/src/Microsoft.OpenApi/Reader/V2/OpenApiOperationDeserializer.cs
@@ -230,7 +230,7 @@ internal static IOpenApiRequestBody CreateRequestBody(
                 Extensions = bodyParameter.Extensions
             };
 
-            if (requestBody.Extensions is not null)
+            if (requestBody.Extensions is not null && bodyParameter.Name is not null)
             {
                 requestBody.Extensions[OpenApiConstants.BodyName] = new OpenApiAny(bodyParameter.Name);
             }            
diff --git a/test/Microsoft.OpenApi.Readers.Tests/ParseNodeTests.cs b/test/Microsoft.OpenApi.Readers.Tests/ParseNodeTests.cs
@@ -33,7 +33,7 @@ public void BrokenSimpleList()
             var result = OpenApiDocument.Parse(input, "yaml");
 
             Assert.Equivalent(new List<OpenApiError>() {
-                new OpenApiError(new OpenApiReaderException("Expected a value."))
+                new OpenApiError(new OpenApiReaderException("Expected a value while parsing at #/schemes."))
             }, result.Diagnostic.Errors);
         }
 
diff --git a/test/Microsoft.OpenApi.Tests/PublicApi/PublicApi.approved.txt b/test/Microsoft.OpenApi.Tests/PublicApi/PublicApi.approved.txt
@@ -7,8 +7,8 @@ namespace Microsoft.OpenApi.Any
 {
     public class OpenApiAny : Microsoft.OpenApi.Interfaces.IOpenApiElement, Microsoft.OpenApi.Interfaces.IOpenApiExtension
     {
-        public OpenApiAny(System.Text.Json.Nodes.JsonNode? jsonNode) { }
-        public System.Text.Json.Nodes.JsonNode? Node { get; }
+        public OpenApiAny(System.Text.Json.Nodes.JsonNode jsonNode) { }
+        public System.Text.Json.Nodes.JsonNode Node { get; }
         public void Write(Microsoft.OpenApi.Writers.IOpenApiWriter writer, Microsoft.OpenApi.OpenApiSpecVersion specVersion) { }
     }
 }
@@ -17,8 +17,8 @@ namespace Microsoft.OpenApi.Attributes
     [System.AttributeUsage(System.AttributeTargets.Property | System.AttributeTargets.Field)]
     public class DisplayAttribute : System.Attribute
     {
-        public DisplayAttribute(string? name) { }
-        public string? Name { get; }
+        public DisplayAttribute(string name) { }
+        public string Name { get; }
     }
 }
 namespace Microsoft.OpenApi.Exceptions
@@ -37,14 +37,13 @@ namespace Microsoft.OpenApi.Exceptions
         public OpenApiReaderException(string message) { }
         public OpenApiReaderException(string message, Microsoft.OpenApi.Reader.ParsingContext context) { }
         public OpenApiReaderException(string message, System.Exception innerException) { }
-        public OpenApiReaderException(string message, System.Text.Json.Nodes.JsonNode? node) { }
     }
     [System.Serializable]
     public class OpenApiUnsupportedSpecVersionException : System.Exception
     {
-        public OpenApiUnsupportedSpecVersionException(string? specificationVersion) { }
+        public OpenApiUnsupportedSpecVersionException(string specificationVersion) { }
         public OpenApiUnsupportedSpecVersionException(string specificationVersion, System.Exception innerException) { }
-        public string? SpecificationVersion { get; }
+        public string SpecificationVersion { get; }
     }
     public class OpenApiWriterException : Microsoft.OpenApi.Exceptions.OpenApiException
     {
@@ -1246,7 +1245,7 @@ namespace Microsoft.OpenApi.Models.References
         where V : Microsoft.OpenApi.Interfaces.IOpenApiSerializable
     {
         protected BaseOpenApiReferenceHolder(Microsoft.OpenApi.Models.References.BaseOpenApiReferenceHolder<T, V> source) { }
-        protected BaseOpenApiReferenceHolder(string? referenceId, Microsoft.OpenApi.Models.OpenApiDocument? hostDocument, Microsoft.OpenApi.Models.ReferenceType referenceType, string? externalResource) { }
+        protected BaseOpenApiReferenceHolder(string referenceId, Microsoft.OpenApi.Models.OpenApiDocument? hostDocument, Microsoft.OpenApi.Models.ReferenceType referenceType, string? externalResource) { }
         public Microsoft.OpenApi.Models.OpenApiReference Reference { get; init; }
         public virtual T Target { get; }
         public bool UnresolvedReference { get; }
@@ -1310,7 +1309,7 @@ namespace Microsoft.OpenApi.Models.References
     }
     public class OpenApiParameterReference : Microsoft.OpenApi.Models.References.BaseOpenApiReferenceHolder<Microsoft.OpenApi.Models.OpenApiParameter, Microsoft.OpenApi.Models.Interfaces.IOpenApiParameter>, Microsoft.OpenApi.Interfaces.IOpenApiElement, Microsoft.OpenApi.Interfaces.IOpenApiReadOnlyExtensible, Microsoft.OpenApi.Interfaces.IOpenApiSerializable, Microsoft.OpenApi.Interfaces.IShallowCopyable<Microsoft.OpenApi.Models.Interfaces.IOpenApiParameter>, Microsoft.OpenApi.Models.Interfaces.IOpenApiDescribedElement, Microsoft.OpenApi.Models.Interfaces.IOpenApiParameter
     {
-        public OpenApiParameterReference(string? referenceId, Microsoft.OpenApi.Models.OpenApiDocument? hostDocument = null, string? externalResource = null) { }
+        public OpenApiParameterReference(string referenceId, Microsoft.OpenApi.Models.OpenApiDocument? hostDocument = null, string? externalResource = null) { }
         public bool AllowEmptyValue { get; }
         public bool AllowReserved { get; }
         public System.Collections.Generic.IDictionary<string, Microsoft.OpenApi.Models.OpenApiMediaType>? Content { get; }
@@ -1444,7 +1443,7 @@ namespace Microsoft.OpenApi.Models.References
     }
     public class OpenApiTagReference : Microsoft.OpenApi.Models.References.BaseOpenApiReferenceHolder<Microsoft.OpenApi.Models.OpenApiTag, Microsoft.OpenApi.Models.Interfaces.IOpenApiTag>, Microsoft.OpenApi.Interfaces.IOpenApiElement, Microsoft.OpenApi.Interfaces.IOpenApiReadOnlyExtensible, Microsoft.OpenApi.Interfaces.IOpenApiSerializable, Microsoft.OpenApi.Interfaces.IShallowCopyable<Microsoft.OpenApi.Models.Interfaces.IOpenApiTag>, Microsoft.OpenApi.Models.Interfaces.IOpenApiReadOnlyDescribedElement, Microsoft.OpenApi.Models.Interfaces.IOpenApiTag
     {
-        public OpenApiTagReference(string? referenceId, Microsoft.OpenApi.Models.OpenApiDocument? hostDocument = null, string? externalResource = null) { }
+        public OpenApiTagReference(string referenceId, Microsoft.OpenApi.Models.OpenApiDocument? hostDocument = null, string? externalResource = null) { }
         public string? Description { get; }
         public System.Collections.Generic.IDictionary<string, Microsoft.OpenApi.Interfaces.IOpenApiExtension>? Extensions { get; }
         public Microsoft.OpenApi.Models.OpenApiExternalDocs? ExternalDocs { get; }
@@ -1468,11 +1467,11 @@ namespace Microsoft.OpenApi.Reader
     {
         public OpenApiJsonReader() { }
         public Microsoft.OpenApi.Reader.ReadResult Read(System.IO.MemoryStream input, Microsoft.OpenApi.Reader.OpenApiReaderSettings settings) { }
-        public Microsoft.OpenApi.Reader.ReadResult Read(System.Text.Json.Nodes.JsonNode? jsonNode, Microsoft.OpenApi.Reader.OpenApiReaderSettings settings) { }
+        public Microsoft.OpenApi.Reader.ReadResult Read(System.Text.Json.Nodes.JsonNode jsonNode, Microsoft.OpenApi.Reader.OpenApiReaderSettings settings) { }
         public System.Threading.Tasks.Task<Microsoft.OpenApi.Reader.ReadResult> ReadAsync(System.IO.Stream input, Microsoft.OpenApi.Reader.OpenApiReaderSettings settings, System.Threading.CancellationToken cancellationToken = default) { }
         public T? ReadFragment<T>(System.IO.MemoryStream input, Microsoft.OpenApi.OpenApiSpecVersion version, Microsoft.OpenApi.Models.OpenApiDocument openApiDocument, out Microsoft.OpenApi.Reader.OpenApiDiagnostic diagnostic, Microsoft.OpenApi.Reader.OpenApiReaderSettings? settings = null)
             where T : Microsoft.OpenApi.Interfaces.IOpenApiElement { }
-        public T ReadFragment<T>(System.Text.Json.Nodes.JsonNode? input, Microsoft.OpenApi.OpenApiSpecVersion version, Microsoft.OpenApi.Models.OpenApiDocument openApiDocument, out Microsoft.OpenApi.Reader.OpenApiDiagnostic diagnostic, Microsoft.OpenApi.Reader.OpenApiReaderSettings? settings = null)
+        public T? ReadFragment<T>(System.Text.Json.Nodes.JsonNode input, Microsoft.OpenApi.OpenApiSpecVersion version, Microsoft.OpenApi.Models.OpenApiDocument openApiDocument, out Microsoft.OpenApi.Reader.OpenApiDiagnostic diagnostic, Microsoft.OpenApi.Reader.OpenApiReaderSettings? settings = null)
             where T : Microsoft.OpenApi.Interfaces.IOpenApiElement { }
     }
     public static class OpenApiModelFactory
@@ -1525,7 +1524,7 @@ namespace Microsoft.OpenApi.Reader
         public T? GetFromTempStorage<T>(string key, object? scope = null) { }
         public string GetLocation() { }
         public Microsoft.OpenApi.Models.OpenApiDocument Parse(System.Text.Json.Nodes.JsonNode jsonNode) { }
-        public T? ParseFragment<T>(System.Text.Json.Nodes.JsonNode? jsonNode, Microsoft.OpenApi.OpenApiSpecVersion version, Microsoft.OpenApi.Models.OpenApiDocument openApiDocument)
+        public T? ParseFragment<T>(System.Text.Json.Nodes.JsonNode jsonNode, Microsoft.OpenApi.OpenApiSpecVersion version, Microsoft.OpenApi.Models.OpenApiDocument openApiDocument)
             where T : Microsoft.OpenApi.Interfaces.IOpenApiElement { }
         public void PopLoop(string loopid) { }
         public bool PushLoop(string loopId, string key) { }

Original file line number	Diff line number	Diff line change
`@@ -110,7 +110,7 @@ public static ReadResult Read(JsonNode jsonNode, OpenApiReaderSettings settings)`
`110`	`110`	`}`
`111`	`111`
`112`	`112`	`/// <inheritdoc/>`
`113`		`- public static T ReadFragment<T>(JsonNode input, OpenApiSpecVersion version, OpenApiDocument openApiDocument, out OpenApiDiagnostic diagnostic, OpenApiReaderSettings? settings = null) where T : IOpenApiElement`
	`113`	`+ public static T? ReadFragment<T>(JsonNode input, OpenApiSpecVersion version, OpenApiDocument openApiDocument, out OpenApiDiagnostic diagnostic, OpenApiReaderSettings? settings = null) where T : IOpenApiElement`
`114`	`114`	`{`
`115`	`115`	`return _jsonReader.ReadFragment<T>(input, version, openApiDocument, out diagnostic, settings);`
`116`	`116`	`}`
Original file line number	Diff line number	Diff line change
`@@ -40,7 +40,7 @@ public ReadResult Read(MemoryStream input,`
`40`	`40`	`// Parse the JSON text in the stream into JsonNodes`
`41`	`41`	`try`
`42`	`42`	`{`
`43`		`- jsonNode = JsonNode.Parse(input);`
	`43`	`+ jsonNode = JsonNode.Parse(input) ?? throw new InvalidOperationException($"Cannot parse input stream, {nameof(input)}.");`
`44`	`44`	`}`
`45`	`45`	`catch (JsonException ex)`
`46`	`46`	`{`
`@@ -61,7 +61,7 @@ public ReadResult Read(MemoryStream input,`
`61`	`61`	`/// <param name="jsonNode">The JsonNode input.</param>`
`62`	`62`	`/// <param name="settings">The Reader settings to be used during parsing.</param>`
`63`	`63`	`/// <returns></returns>`
`64`		`- public ReadResult Read(JsonNode? jsonNode,`
	`64`	`+ public ReadResult Read(JsonNode jsonNode,`
`65`	`65`	`OpenApiReaderSettings settings)`
`66`	`66`	`{`
`67`	`67`	`if (jsonNode is null) throw new ArgumentNullException(nameof(jsonNode));`
`@@ -131,7 +131,8 @@ public async Task<ReadResult> ReadAsync(Stream input,`
`131`	`131`	`// Parse the JSON text in the stream into JsonNodes`
`132`	`132`	`try`
`133`	`133`	`{`
`134`		`- jsonNode = await JsonNode.ParseAsync(input, cancellationToken: cancellationToken).ConfigureAwait(false);`
	`134`	`+ jsonNode = await JsonNode.ParseAsync(input, cancellationToken: cancellationToken).ConfigureAwait(false) ??`
	`135`	`+ throw new InvalidOperationException($"failed to parse input stream, {nameof(input)}");`
`135`	`136`	`}`
`136`	`137`	`catch (JsonException ex)`
`137`	`138`	`{`
`@@ -156,12 +157,12 @@ public async Task<ReadResult> ReadAsync(Stream input,`
`156`	`157`	`Utils.CheckArgumentNull(input);`
`157`	`158`	`Utils.CheckArgumentNull(openApiDocument);`
`158`	`159`
`159`		`- JsonNode? jsonNode;`
	`160`	`+ JsonNode jsonNode;`
`160`	`161`
`161`	`162`	`// Parse the JSON`
`162`	`163`	`try`
`163`	`164`	`{`
`164`		`- jsonNode = JsonNode.Parse(input);`
	`165`	`+ jsonNode = JsonNode.Parse(input) ?? throw new InvalidOperationException($"Failed to parse stream, {nameof(input)}");`
`165`	`166`	`}`
`166`	`167`	`catch (JsonException ex)`
`167`	`168`	`{`
`@@ -174,11 +175,11 @@ public async Task<ReadResult> ReadAsync(Stream input,`
`174`	`175`	`}`
`175`	`176`
`176`	`177`	`/// <inheritdoc/>`
`177`		`- public T ReadFragment<T>(JsonNode? input,`
`178`		`- OpenApiSpecVersion version,`
`179`		`- OpenApiDocument openApiDocument,`
`180`		`- out OpenApiDiagnostic diagnostic,`
`181`		`- OpenApiReaderSettings? settings = null) where T : IOpenApiElement`
	`178`	`+ public T? ReadFragment<T>(JsonNode input,`
	`179`	`+ OpenApiSpecVersion version,`
	`180`	`+ OpenApiDocument openApiDocument,`
	`181`	`+ out OpenApiDiagnostic diagnostic,`
	`182`	`+ OpenApiReaderSettings? settings = null) where T : IOpenApiElement`
`182`	`183`	`{`
`183`	`184`	`diagnostic = new();`
`184`	`185`	`settings ??= new OpenApiReaderSettings();`
`@@ -211,7 +212,7 @@ public T ReadFragment<T>(JsonNode? input,`
`211`	`212`	`}`
`212`	`213`	`}`
`213`	`214`
`214`		`- return (T?)element!;`
	`215`	`+ return (T?)element;`
`215`	`216`	`}`
`216`	`217`	`}`
`217`	`218`	`}`
Original file line number	Diff line number	Diff line change
`@@ -230,7 +230,7 @@ internal static IOpenApiRequestBody CreateRequestBody(`
`230`	`230`	`Extensions = bodyParameter.Extensions`
`231`	`231`	`};`
`232`	`232`
`233`		`- if (requestBody.Extensions is not null)`
	`233`	`+ if (requestBody.Extensions is not null && bodyParameter.Name is not null)`
`234`	`234`	`{`
`235`	`235`	`requestBody.Extensions[OpenApiConstants.BodyName] = new OpenApiAny(bodyParameter.Name);`
`236`	`236`	`}`
Original file line number	Diff line number	Diff line change
`@@ -33,7 +33,7 @@ public void BrokenSimpleList()`
`33`	`33`	`var result = OpenApiDocument.Parse(input, "yaml");`
`34`	`34`
`35`	`35`	`Assert.Equivalent(new List<OpenApiError>() {`
`36`		`- new OpenApiError(new OpenApiReaderException("Expected a value."))`
	`36`	`+ new OpenApiError(new OpenApiReaderException("Expected a value while parsing at #/schemes."))`
`37`	`37`	`}, result.Diagnostic.Errors);`
`38`	`38`	`}`
`39`	`39`
Original file line number	Diff line number	Diff line change
`@@ -7,8 +7,8 @@ namespace Microsoft.OpenApi.Any`
`7`	`7`	`{`
`8`	`8`	`public class OpenApiAny : Microsoft.OpenApi.Interfaces.IOpenApiElement, Microsoft.OpenApi.Interfaces.IOpenApiExtension`
`9`	`9`	`{`
`10`		`- public OpenApiAny(System.Text.Json.Nodes.JsonNode? jsonNode) { }`
`11`		`- public System.Text.Json.Nodes.JsonNode? Node { get; }`
	`10`	`+ public OpenApiAny(System.Text.Json.Nodes.JsonNode jsonNode) { }`
	`11`	`+ public System.Text.Json.Nodes.JsonNode Node { get; }`
`12`	`12`	`public void Write(Microsoft.OpenApi.Writers.IOpenApiWriter writer, Microsoft.OpenApi.OpenApiSpecVersion specVersion) { }`
`13`	`13`	`}`
`14`	`14`	`}`
`@@ -17,8 +17,8 @@ namespace Microsoft.OpenApi.Attributes`
`17`	`17`	`[System.AttributeUsage(System.AttributeTargets.Property \| System.AttributeTargets.Field)]`
`18`	`18`	`public class DisplayAttribute : System.Attribute`
`19`	`19`	`{`
`20`		`- public DisplayAttribute(string? name) { }`
`21`		`- public string? Name { get; }`
	`20`	`+ public DisplayAttribute(string name) { }`
	`21`	`+ public string Name { get; }`
`22`	`22`	`}`
`23`	`23`	`}`
`24`	`24`	`namespace Microsoft.OpenApi.Exceptions`
`@@ -37,14 +37,13 @@ namespace Microsoft.OpenApi.Exceptions`
`37`	`37`	`public OpenApiReaderException(string message) { }`
`38`	`38`	`public OpenApiReaderException(string message, Microsoft.OpenApi.Reader.ParsingContext context) { }`
`39`	`39`	`public OpenApiReaderException(string message, System.Exception innerException) { }`
`40`		`- public OpenApiReaderException(string message, System.Text.Json.Nodes.JsonNode? node) { }`
`41`	`40`	`}`
`42`	`41`	`[System.Serializable]`
`43`	`42`	`public class OpenApiUnsupportedSpecVersionException : System.Exception`
`44`	`43`	`{`
`45`		`- public OpenApiUnsupportedSpecVersionException(string? specificationVersion) { }`
	`44`	`+ public OpenApiUnsupportedSpecVersionException(string specificationVersion) { }`
`46`	`45`	`public OpenApiUnsupportedSpecVersionException(string specificationVersion, System.Exception innerException) { }`
`47`		`- public string? SpecificationVersion { get; }`
	`46`	`+ public string SpecificationVersion { get; }`
`48`	`47`	`}`
`49`	`48`	`public class OpenApiWriterException : Microsoft.OpenApi.Exceptions.OpenApiException`
`50`	`49`	`{`
`@@ -1246,7 +1245,7 @@ namespace Microsoft.OpenApi.Models.References`
`1246`	`1245`	`where V : Microsoft.OpenApi.Interfaces.IOpenApiSerializable`
`1247`	`1246`	`{`
`1248`	`1247`	`protected BaseOpenApiReferenceHolder(Microsoft.OpenApi.Models.References.BaseOpenApiReferenceHolder<T, V> source) { }`
`1249`		`- protected BaseOpenApiReferenceHolder(string? referenceId, Microsoft.OpenApi.Models.OpenApiDocument? hostDocument, Microsoft.OpenApi.Models.ReferenceType referenceType, string? externalResource) { }`
	`1248`	`+ protected BaseOpenApiReferenceHolder(string referenceId, Microsoft.OpenApi.Models.OpenApiDocument? hostDocument, Microsoft.OpenApi.Models.ReferenceType referenceType, string? externalResource) { }`
`1250`	`1249`	`public Microsoft.OpenApi.Models.OpenApiReference Reference { get; init; }`
`1251`	`1250`	`public virtual T Target { get; }`
`1252`	`1251`	`public bool UnresolvedReference { get; }`
`@@ -1310,7 +1309,7 @@ namespace Microsoft.OpenApi.Models.References`
`1310`	`1309`	`}`
`1311`	`1310`	public class OpenApiParameterReference : Microsoft.OpenApi.Models.References.BaseOpenApiReferenceHolder<Microsoft.OpenApi.Models.OpenApiParameter, Microsoft.OpenApi.Models.Interfaces.IOpenApiParameter>, Microsoft.OpenApi.Interfaces.IOpenApiElement, Microsoft.OpenApi.Interfaces.IOpenApiReadOnlyExtensible, Microsoft.OpenApi.Interfaces.IOpenApiSerializable, Microsoft.OpenApi.Interfaces.IShallowCopyable<Microsoft.OpenApi.Models.Interfaces.IOpenApiParameter>, Microsoft.OpenApi.Models.Interfaces.IOpenApiDescribedElement, Microsoft.OpenApi.Models.Interfaces.IOpenApiParameter
`1312`	`1311`	`{`
`1313`		`- public OpenApiParameterReference(string? referenceId, Microsoft.OpenApi.Models.OpenApiDocument? hostDocument = null, string? externalResource = null) { }`
	`1312`	`+ public OpenApiParameterReference(string referenceId, Microsoft.OpenApi.Models.OpenApiDocument? hostDocument = null, string? externalResource = null) { }`
`1314`	`1313`	`public bool AllowEmptyValue { get; }`
`1315`	`1314`	`public bool AllowReserved { get; }`
`1316`	`1315`	`public System.Collections.Generic.IDictionary<string, Microsoft.OpenApi.Models.OpenApiMediaType>? Content { get; }`
`@@ -1444,7 +1443,7 @@ namespace Microsoft.OpenApi.Models.References`
`1444`	`1443`	`}`
`1445`	`1444`	public class OpenApiTagReference : Microsoft.OpenApi.Models.References.BaseOpenApiReferenceHolder<Microsoft.OpenApi.Models.OpenApiTag, Microsoft.OpenApi.Models.Interfaces.IOpenApiTag>, Microsoft.OpenApi.Interfaces.IOpenApiElement, Microsoft.OpenApi.Interfaces.IOpenApiReadOnlyExtensible, Microsoft.OpenApi.Interfaces.IOpenApiSerializable, Microsoft.OpenApi.Interfaces.IShallowCopyable<Microsoft.OpenApi.Models.Interfaces.IOpenApiTag>, Microsoft.OpenApi.Models.Interfaces.IOpenApiReadOnlyDescribedElement, Microsoft.OpenApi.Models.Interfaces.IOpenApiTag
`1446`	`1445`	`{`
`1447`		`- public OpenApiTagReference(string? referenceId, Microsoft.OpenApi.Models.OpenApiDocument? hostDocument = null, string? externalResource = null) { }`
	`1446`	`+ public OpenApiTagReference(string referenceId, Microsoft.OpenApi.Models.OpenApiDocument? hostDocument = null, string? externalResource = null) { }`
`1448`	`1447`	`public string? Description { get; }`
`1449`	`1448`	`public System.Collections.Generic.IDictionary<string, Microsoft.OpenApi.Interfaces.IOpenApiExtension>? Extensions { get; }`
`1450`	`1449`	`public Microsoft.OpenApi.Models.OpenApiExternalDocs? ExternalDocs { get; }`
`@@ -1468,11 +1467,11 @@ namespace Microsoft.OpenApi.Reader`
`1468`	`1467`	`{`
`1469`	`1468`	`public OpenApiJsonReader() { }`
`1470`	`1469`	`public Microsoft.OpenApi.Reader.ReadResult Read(System.IO.MemoryStream input, Microsoft.OpenApi.Reader.OpenApiReaderSettings settings) { }`
`1471`		`- public Microsoft.OpenApi.Reader.ReadResult Read(System.Text.Json.Nodes.JsonNode? jsonNode, Microsoft.OpenApi.Reader.OpenApiReaderSettings settings) { }`
	`1470`	`+ public Microsoft.OpenApi.Reader.ReadResult Read(System.Text.Json.Nodes.JsonNode jsonNode, Microsoft.OpenApi.Reader.OpenApiReaderSettings settings) { }`
`1472`	`1471`	`public System.Threading.Tasks.Task<Microsoft.OpenApi.Reader.ReadResult> ReadAsync(System.IO.Stream input, Microsoft.OpenApi.Reader.OpenApiReaderSettings settings, System.Threading.CancellationToken cancellationToken = default) { }`
`1473`	`1472`	`public T? ReadFragment<T>(System.IO.MemoryStream input, Microsoft.OpenApi.OpenApiSpecVersion version, Microsoft.OpenApi.Models.OpenApiDocument openApiDocument, out Microsoft.OpenApi.Reader.OpenApiDiagnostic diagnostic, Microsoft.OpenApi.Reader.OpenApiReaderSettings? settings = null)`
`1474`	`1473`	`where T : Microsoft.OpenApi.Interfaces.IOpenApiElement { }`
`1475`		`- public T ReadFragment<T>(System.Text.Json.Nodes.JsonNode? input, Microsoft.OpenApi.OpenApiSpecVersion version, Microsoft.OpenApi.Models.OpenApiDocument openApiDocument, out Microsoft.OpenApi.Reader.OpenApiDiagnostic diagnostic, Microsoft.OpenApi.Reader.OpenApiReaderSettings? settings = null)`
	`1474`	`+ public T? ReadFragment<T>(System.Text.Json.Nodes.JsonNode input, Microsoft.OpenApi.OpenApiSpecVersion version, Microsoft.OpenApi.Models.OpenApiDocument openApiDocument, out Microsoft.OpenApi.Reader.OpenApiDiagnostic diagnostic, Microsoft.OpenApi.Reader.OpenApiReaderSettings? settings = null)`
`1476`	`1475`	`where T : Microsoft.OpenApi.Interfaces.IOpenApiElement { }`
`1477`	`1476`	`}`
`1478`	`1477`	`public static class OpenApiModelFactory`
`@@ -1525,7 +1524,7 @@ namespace Microsoft.OpenApi.Reader`
`1525`	`1524`	`public T? GetFromTempStorage<T>(string key, object? scope = null) { }`
`1526`	`1525`	`public string GetLocation() { }`
`1527`	`1526`	`public Microsoft.OpenApi.Models.OpenApiDocument Parse(System.Text.Json.Nodes.JsonNode jsonNode) { }`
`1528`		`- public T? ParseFragment<T>(System.Text.Json.Nodes.JsonNode? jsonNode, Microsoft.OpenApi.OpenApiSpecVersion version, Microsoft.OpenApi.Models.OpenApiDocument openApiDocument)`
	`1527`	`+ public T? ParseFragment<T>(System.Text.Json.Nodes.JsonNode jsonNode, Microsoft.OpenApi.OpenApiSpecVersion version, Microsoft.OpenApi.Models.OpenApiDocument openApiDocument)`
`1529`	`1528`	`where T : Microsoft.OpenApi.Interfaces.IOpenApiElement { }`
`1530`	`1529`	`public void PopLoop(string loopid) { }`
`1531`	`1530`	`public bool PushLoop(string loopId, string key) { }`