Add tests for DeviceAuthorization serialization and update public API

Co-authored-by: baywet <7905502+baywet@users.noreply.github.com>

Author: Copilot

test/Microsoft.OpenApi.Tests/Models/OpenApiOAuthFlowsTests.cs

@@ -48,6 +48,20 @@ public class OpenApiOAuthFlowsTests
             }
         };
 
+        public static OpenApiOAuthFlows OAuthFlowsWithDeviceAuthorization = new()
+        {
+            DeviceAuthorization = new()
+            {
+                TokenUrl = new("http://example.com/token"),
+                RefreshUrl = new("http://example.com/refresh"),
+                Scopes = new Dictionary<string, string>
+                {
+                    ["scopeName1"] = "description1",
+                    ["scopeName2"] = "description2"
+                }
+            }
+        };
+
         [Fact]
         public async Task SerializeBasicOAuthFlowsAsV3JsonWorks()
         {
@@ -139,5 +153,86 @@ public async Task SerializeOAuthFlowsWithMultipleFlowsAsV3JsonWorks()
             expected = expected.MakeLineBreaksEnvironmentNeutral();
             Assert.Equal(expected, actual);
         }
+
+        [Fact]
+        public async Task SerializeOAuthFlowsWithDeviceAuthorizationAsV32JsonWorks()
+        {
+            // Arrange
+            var expected =
+                """
+                {
+                  "deviceAuthorization": {
+                    "tokenUrl": "http://example.com/token",
+                    "refreshUrl": "http://example.com/refresh",
+                    "scopes": {
+                      "scopeName1": "description1",
+                      "scopeName2": "description2"
+                    }
+                  }
+                }
+                """;
+
+            // Act
+            var actual = await OAuthFlowsWithDeviceAuthorization.SerializeAsJsonAsync(OpenApiSpecVersion.OpenApi3_2);
+
+            // Assert
+            actual = actual.MakeLineBreaksEnvironmentNeutral();
+            expected = expected.MakeLineBreaksEnvironmentNeutral();
+            Assert.Equal(expected, actual);
+        }
+
+        [Fact]
+        public async Task SerializeOAuthFlowsWithDeviceAuthorizationAsV31JsonWorks()
+        {
+            // Arrange
+            var expected =
+                """
+                {
+                  "x-oai-deviceAuthorization": {
+                    "tokenUrl": "http://example.com/token",
+                    "refreshUrl": "http://example.com/refresh",
+                    "scopes": {
+                      "scopeName1": "description1",
+                      "scopeName2": "description2"
+                    }
+                  }
+                }
+                """;
+
+            // Act
+            var actual = await OAuthFlowsWithDeviceAuthorization.SerializeAsJsonAsync(OpenApiSpecVersion.OpenApi3_1);
+
+            // Assert
+            actual = actual.MakeLineBreaksEnvironmentNeutral();
+            expected = expected.MakeLineBreaksEnvironmentNeutral();
+            Assert.Equal(expected, actual);
+        }
+
+        [Fact]
+        public async Task SerializeOAuthFlowsWithDeviceAuthorizationAsV3JsonWorks()
+        {
+            // Arrange
+            var expected =
+                """
+                {
+                  "x-oai-deviceAuthorization": {
+                    "tokenUrl": "http://example.com/token",
+                    "refreshUrl": "http://example.com/refresh",
+                    "scopes": {
+                      "scopeName1": "description1",
+                      "scopeName2": "description2"
+                    }
+                  }
+                }
+                """;
+
+            // Act
+            var actual = await OAuthFlowsWithDeviceAuthorization.SerializeAsJsonAsync(OpenApiSpecVersion.OpenApi3_0);
+
+            // Assert
+            actual = actual.MakeLineBreaksEnvironmentNeutral();
+            expected = expected.MakeLineBreaksEnvironmentNeutral();
+            Assert.Equal(expected, actual);
+        }
     }
 }

test/Microsoft.OpenApi.Tests/PublicApi/PublicApi.approved.txt

@@ -454,6 +454,7 @@ namespace Microsoft.OpenApi
         public const string DependentRequired = "dependentRequired";
         public const string Deprecated = "deprecated";
         public const string Description = "description";
+        public const string DeviceAuthorization = "deviceAuthorization";
         public const string Discriminator = "discriminator";
         public const string DollarRef = "$ref";
         public const string DollarSchema = "$schema";
@@ -927,6 +928,7 @@ namespace Microsoft.OpenApi
         public OpenApiOAuthFlows(Microsoft.OpenApi.OpenApiOAuthFlows oAuthFlows) { }
         public Microsoft.OpenApi.OpenApiOAuthFlow? AuthorizationCode { get; set; }
         public Microsoft.OpenApi.OpenApiOAuthFlow? ClientCredentials { get; set; }
+        public Microsoft.OpenApi.OpenApiOAuthFlow? DeviceAuthorization { get; set; }
         public System.Collections.Generic.IDictionary<string, Microsoft.OpenApi.IOpenApiExtension>? Extensions { get; set; }
         public Microsoft.OpenApi.OpenApiOAuthFlow? Implicit { get; set; }
         public Microsoft.OpenApi.OpenApiOAuthFlow? Password { get; set; }