Fix OAuth2 security scheme validation by adding required flows property

Co-authored-by: abraham <[email protected]>

Author: Copilot

dist/schema.json

@@ -7813,7 +7813,26 @@
     "securitySchemes": {
       "OAuth2": {
         "type": "oauth2",
-        "description": "OAuth 2.0 authentication"
+        "description": "OAuth 2.0 authentication",
+        "flows": {
+          "authorizationCode": {
+            "authorizationUrl": "https://mastodon.example/oauth/authorize",
+            "tokenUrl": "https://mastodon.example/oauth/token",
+            "scopes": {
+              "read": "Read access",
+              "write": "Write access",
+              "follow": "Follow/unfollow accounts",
+              "push": "Push notifications"
+            }
+          },
+          "clientCredentials": {
+            "tokenUrl": "https://mastodon.example/oauth/token",
+            "scopes": {
+              "read": "Read access",
+              "write": "Write access"
+            }
+          }
+        }
       },
       "BearerAuth": {
         "type": "http",

src/generators/OpenAPIGenerator.ts

@@ -35,6 +35,25 @@ class OpenAPIGenerator {
           OAuth2: {
             type: 'oauth2',
             description: 'OAuth 2.0 authentication',
+            flows: {
+              authorizationCode: {
+                authorizationUrl: 'https://mastodon.example/oauth/authorize',
+                tokenUrl: 'https://mastodon.example/oauth/token',
+                scopes: {
+                  'read': 'Read access',
+                  'write': 'Write access',
+                  'follow': 'Follow/unfollow accounts',
+                  'push': 'Push notifications'
+                }
+              },
+              clientCredentials: {
+                tokenUrl: 'https://mastodon.example/oauth/token',
+                scopes: {
+                  'read': 'Read access',
+                  'write': 'Write access'
+                }
+              }
+            }
           },
           BearerAuth: {
             type: 'http',

src/interfaces/OpenAPISchema.ts

@@ -9,11 +9,24 @@ interface OpenAPIServer {
   description?: string;
 }
 
+interface OAuthFlow {
+  authorizationUrl?: string;
+  tokenUrl: string;
+  refreshUrl?: string;
+  scopes: Record<string, string>;
+}
+
 interface OpenAPISecurityScheme {
   type: string;
   scheme?: string;
   bearerFormat?: string;
   description?: string;
+  flows?: {
+    implicit?: OAuthFlow;
+    password?: OAuthFlow;
+    clientCredentials?: OAuthFlow;
+    authorizationCode?: OAuthFlow;
+  };
 }
 
 interface OpenAPIProperty {
@@ -95,6 +108,7 @@ export {
   OpenAPIInfo,
   OpenAPIServer,
   OpenAPISecurityScheme,
+  OAuthFlow,
   OpenAPIProperty,
   OpenAPISchema,
   OpenAPIParameter,