@scalar/openapi-types 0.4.0 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @scalar/openapi-types
 
+## 0.5.0
+
+### Minor Changes
+
+- f69e7cc: adds support for OpenAPI 3.2.0 definitions
+
+## 0.4.1
+
+### Patch Changes
+
+- 15c4240: feat: adds vesion 3.1.2 to the type definitions
+
 ## 0.4.0
 
 ### Minor Changes

package/dist/openapi-types.d.ts

@@ -14,25 +14,190 @@ type AnyOtherAttribute = {
     [key: string]: any;
 };
 export declare namespace OpenAPI {
-    type Document<T extends AnyOtherAttribute = {}> = OpenAPIV2.Document<T> | OpenAPIV3.Document<T> | OpenAPIV3_1.Document<T>;
-    type Operation<T = {}> = OpenAPIV2.OperationObject<T> | OpenAPIV3.OperationObject<T> | OpenAPIV3_1.OperationObject<T>;
+    type Document<T extends AnyOtherAttribute = {}> = OpenAPIV2.Document<T> | OpenAPIV3.Document<T> | OpenAPIV3_1.Document<T> | OpenAPIV3_2.Document<T>;
+    type Operation<T = {}> = OpenAPIV2.OperationObject<T> | OpenAPIV3.OperationObject<T> | OpenAPIV3_1.OperationObject<T> | OpenAPIV3_2.OperationObject<T>;
     type Request = {
         body?: any;
         headers?: object;
         params?: object;
         query?: object;
     };
-    type ResponseObject = OpenAPIV2.ResponseObject | OpenAPIV3.ResponseObject | OpenAPIV3_1.ResponseObject;
-    type HeaderObject = OpenAPIV2.HeaderObject | OpenAPIV3.HeaderObject | OpenAPIV3_1.HeaderObject;
-    type Parameter = OpenAPIV3_1.ReferenceObject | OpenAPIV3_1.ParameterObject | OpenAPIV3.ReferenceObject | OpenAPIV3.ParameterObject | OpenAPIV2.ReferenceObject | OpenAPIV2.Parameter;
-    type Parameters = (OpenAPIV3_1.ReferenceObject | OpenAPIV3_1.ParameterObject)[] | (OpenAPIV3.ReferenceObject | OpenAPIV3.ParameterObject)[] | (OpenAPIV2.ReferenceObject | OpenAPIV2.Parameter)[];
-    type ExampleObject = OpenAPIV2.ExampleObject | OpenAPIV3.ExampleObject | OpenAPIV3_1.ExampleObject;
-    type SchemaObject = OpenAPIV2.SchemaObject | OpenAPIV3.SchemaObject | OpenAPIV3_1.SchemaObject;
-    type HttpMethod = keyof typeof OpenAPIV2.HttpMethods | OpenAPIV3.HttpMethods | OpenAPIV3_1.HttpMethods;
+    type ResponseObject = OpenAPIV2.ResponseObject | OpenAPIV3.ResponseObject | OpenAPIV3_1.ResponseObject | OpenAPIV3_2.ResponseObject;
+    type HeaderObject = OpenAPIV2.HeaderObject | OpenAPIV3.HeaderObject | OpenAPIV3_1.HeaderObject | OpenAPIV3_2.HeaderObject;
+    type Parameter = OpenAPIV3_2.ReferenceObject | OpenAPIV3_2.ParameterObject | OpenAPIV3_1.ReferenceObject | OpenAPIV3_1.ParameterObject | OpenAPIV3.ReferenceObject | OpenAPIV3.ParameterObject | OpenAPIV2.ReferenceObject | OpenAPIV2.Parameter;
+    type Parameters = (OpenAPIV3_2.ReferenceObject | OpenAPIV3_2.ParameterObject)[] | (OpenAPIV3_1.ReferenceObject | OpenAPIV3_1.ParameterObject)[] | (OpenAPIV3.ReferenceObject | OpenAPIV3.ParameterObject)[] | (OpenAPIV2.ReferenceObject | OpenAPIV2.Parameter)[];
+    type ExampleObject = OpenAPIV2.ExampleObject | OpenAPIV3.ExampleObject | OpenAPIV3_1.ExampleObject | OpenAPIV3_2.ExampleObject;
+    type SchemaObject = OpenAPIV2.SchemaObject | OpenAPIV3.SchemaObject | OpenAPIV3_1.SchemaObject | OpenAPIV3_2.SchemaObject;
+    type HttpMethod = OpenAPIV2.HttpMethods | OpenAPIV3.HttpMethods | OpenAPIV3_1.HttpMethods | OpenAPIV3_2.HttpMethods;
+}
+export declare namespace OpenAPIV3_2 {
+    type Modify<T, R> = Omit<T, keyof R> & R;
+    export type PathsWebhooksComponents<T = {}> = {
+        paths?: PathsObject<T>;
+        webhooks?: Record<string, PathItemObject | ReferenceObject>;
+        components?: ComponentsObject;
+    };
+    export type Document<T = {}> = Modify<Omit<OpenAPIV3_1.Document<T>, 'paths' | 'components' | 'webhooks' | 'tags'>, {
+        /**
+         * Version of the OpenAPI specification
+         * @see https://github.com/OAI/OpenAPI-Specification/tree/main/versions
+         */
+        openapi?: '3.2.0';
+        swagger?: never;
+        servers?: ServerObject[];
+        $self?: string;
+        tags?: TagObject[];
+    } & ((Pick<PathsWebhooksComponents<T>, 'paths'> & Omit<Partial<PathsWebhooksComponents<T>>, 'paths'>) | (Pick<PathsWebhooksComponents<T>, 'webhooks'> & Omit<Partial<PathsWebhooksComponents<T>>, 'webhooks'>) | (Pick<PathsWebhooksComponents<T>, 'components'> & Omit<Partial<PathsWebhooksComponents<T>>, 'components'>)) & T & AnyOtherAttribute>;
+    export type ServerObject = Modify<OpenAPIV3_1.ServerObject, {
+        name?: string;
+    }>;
+    export type PathsObject<T = {}, P extends {} = {}> = Record<string, (PathItemObject<T> & P) | undefined>;
+    export type HttpMethods = OpenAPIV3_1.HttpMethods | 'query';
+    export type PathItemObject<T = {}> = Modify<OpenAPIV3_1.PathItemObject<T>, {
+        [method in HttpMethods]?: OperationObject<T>;
+    }> & {
+        additionalOperations?: Record<string, OperationObject<T>>;
+        parameters?: (ReferenceObject | ParameterObject)[];
+    };
+    export type OperationObject<T = {}> = Modify<OpenAPIV3_1.OperationObject<T>, {
+        parameters?: (ReferenceObject | ParameterObject)[];
+        requestBody?: ReferenceObject | RequestBodyObject;
+        responses?: ResponsesObject;
+        callbacks?: Record<string, ReferenceObject | CallbackObject>;
+        servers?: ServerObject[];
+    }> & T;
+    export type ParameterStyle = OpenAPIV3_1.ParameterStyle | 'cookie';
+    export type ParameterLocation = OpenAPIV3_1.ParameterLocation | 'querystring';
+    export type ParameterObject = Modify<OpenAPIV3_1.ParameterObject, {
+        style?: ParameterStyle;
+        in?: ParameterLocation;
+        schema?: ReferenceObject | SchemaObject;
+        examples?: {
+            [media: string]: ReferenceObject | ExampleObject;
+        };
+    }>;
+    export type HeaderObject = Modify<OpenAPIV3_1.HeaderObject, {
+        content?: {
+            [media: string]: ReferenceObject | MediaTypeObject;
+        };
+        schema?: ReferenceObject | SchemaObject;
+    }>;
+    export type NonArraySchemaObjectType = OpenAPIV3_1.NonArraySchemaObjectType;
+    export type ArraySchemaObjectType = OpenAPIV3_1.ArraySchemaObjectType;
+    /**
+     * There is no way to tell typescript to require items when type is either 'array' or array containing 'array' type
+     * 'items' will be always visible as optional
+     * Casting schema object to ArraySchemaObject or NonArraySchemaObject will work fine
+     */
+    export type SchemaObject = (ArraySchemaObject | NonArraySchemaObject | MixedSchemaObject | boolean) & AnyOtherAttribute;
+    export type ArraySchemaObject = {
+        type?: ArraySchemaObjectType;
+        items?: ReferenceObject | SchemaObject;
+    } & BaseSchemaObject;
+    export type NonArraySchemaObject = {
+        type?: NonArraySchemaObjectType;
+    } & BaseSchemaObject;
+    type MixedSchemaObject = {
+        type?: (ArraySchemaObjectType | NonArraySchemaObjectType)[];
+        items?: ReferenceObject | SchemaObject;
+    } & BaseSchemaObject;
+    export type BaseSchemaObject = Modify<OpenAPIV3_1.BaseSchemaObject, {
+        examples?: ExampleObject[];
+        discriminator?: DiscriminatorObject;
+        xml?: XMLObject;
+    }>;
+    export type DiscriminatorObject = OpenAPIV3_1.DiscriminatorObject & {
+        defaultMapping?: string;
+    };
+    export type XMLNodeType = 'element' | 'attribute' | 'text' | 'cdata' | 'comment';
+    export type XMLObject = Omit<OpenAPIV3_1.XMLObject, 'wrapped' | 'attribute'> & {
+        nodeType?: XMLNodeType;
+    };
+    export type ReferenceObject = OpenAPIV3_1.ReferenceObject;
+    export type ExampleObject = OpenAPIV3_1.ExampleObject & {
+        dataValue?: any;
+        serializedValue?: string;
+    };
+    export type MediaTypeObject = Modify<OpenAPIV3_1.MediaTypeObject, {
+        schema?: ReferenceObject | SchemaObject;
+        examples?: Record<string, ReferenceObject | ExampleObject>;
+        encoding?: {
+            [media: string]: EncodingObject;
+        };
+    }> & {
+        itemSchema?: ReferenceObject | SchemaObject;
+        itemEncoding?: EncodingObject;
+        prefixEncoding?: EncodingObject[];
+    };
+    export type EncodingObject = Modify<OpenAPIV3_1.EncodingObject, {
+        headers?: {
+            [header: string]: ReferenceObject | HeaderObject;
+        };
+    }> & {
+        encoding?: Record<string, EncodingObject>;
+        prefixEncoding?: EncodingObject[];
+        itemEncoding?: EncodingObject;
+    };
+    export type RequestBodyObject = Modify<OpenAPIV3_1.RequestBodyObject, {
+        content?: {
+            [media: string]: ReferenceObject | MediaTypeObject;
+        };
+    }>;
+    export type ResponsesObject = Record<string, ReferenceObject | ResponseObject>;
+    export type ResponseObject = Modify<OpenAPIV3_1.ResponseObject, {
+        headers?: {
+            [header: string]: ReferenceObject | HeaderObject;
+        };
+        content?: {
+            [media: string]: ReferenceObject | MediaTypeObject;
+        };
+        links?: {
+            [link: string]: ReferenceObject | LinkObject;
+        };
+    }> & {
+        summary?: string;
+    };
+    export type LinkObject = Modify<OpenAPIV3_1.LinkObject, {
+        server?: ServerObject;
+    }>;
+    export type CallbackObject = Record<string, PathItemObject | ReferenceObject>;
+    export type ComponentsObject = Modify<OpenAPIV3_1.ComponentsObject, {
+        schemas?: Record<string, SchemaObject>;
+        responses?: Record<string, ReferenceObject | ResponseObject>;
+        parameters?: Record<string, ReferenceObject | ParameterObject>;
+        examples?: Record<string, ReferenceObject | ExampleObject>;
+        requestBodies?: Record<string, ReferenceObject | RequestBodyObject>;
+        headers?: Record<string, ReferenceObject | HeaderObject>;
+        securitySchemes?: Record<string, ReferenceObject | SecuritySchemeObject>;
+        links?: Record<string, ReferenceObject | LinkObject>;
+        callbacks?: Record<string, ReferenceObject | CallbackObject>;
+        pathItems?: Record<string, ReferenceObject | PathItemObject>;
+        mediaTypes?: Record<string, MediaTypeObject | ReferenceObject>;
+    }>;
+    export type SecuritySchemeObject = HttpSecurityScheme | ApiKeySecurityScheme | OAuth2SecurityScheme | (OpenIdSecurityScheme & {
+        deprecated?: boolean;
+    });
+    export type HttpSecurityScheme = OpenAPIV3_1.HttpSecurityScheme;
+    export type ApiKeySecurityScheme = OpenAPIV3_1.ApiKeySecurityScheme;
+    export type OAuthFlows = OpenAPIV3_1.OAuthFlows & {
+        deviceAuthorization?: AnyOtherAttribute & OpenAPIV3.OAuthFlowBase & OpenAPIV3.OAuthFlowTokenUrlTrait & {
+            deviceAuthorizationUrl?: string;
+        };
+    };
+    export type OAuth2SecurityScheme = Modify<OpenAPIV3_1.OAuth2SecurityScheme, {
+        flows?: OAuthFlows;
+    }>;
+    export type OpenIdSecurityScheme = OpenAPIV3_1.OpenIdSecurityScheme;
+    export type TagObject = OpenAPIV3_1.TagObject & {
+        summary?: string;
+        parent?: string;
+        kind?: string;
+    };
+    export {};
 }
 export declare namespace OpenAPIV3_1 {
     type Modify<T, R> = Omit<T, keyof R> & R;
-    type PathsWebhooksComponents<T = {}> = {
+    export type PathsWebhooksComponents<T = {}> = {
         paths?: PathsObject<T>;
         webhooks?: Record<string, PathItemObject | ReferenceObject>;
         components?: ComponentsObject;
@@ -42,8 +207,8 @@ export declare namespace OpenAPIV3_1 {
          * Version of the OpenAPI specification
          * @see https://github.com/OAI/OpenAPI-Specification/tree/main/versions
          */
-        openapi?: '3.1.0' | '3.1.1';
-        swagger?: undefined;
+        openapi?: '3.1.0' | '3.1.1' | '3.1.2';
+        swagger?: never;
         info?: InfoObject;
         jsonSchemaDialect?: string;
         servers?: ServerObject[];
@@ -80,9 +245,19 @@ export declare namespace OpenAPIV3_1 {
         servers?: ServerObject[];
     }> & T;
     export type ExternalDocumentationObject = OpenAPIV3.ExternalDocumentationObject;
+    export type ParameterStyle = OpenAPIV3.ParameterStyle;
+    export type ParameterLocation = OpenAPIV3.ParameterLocation;
     export type ParameterObject = OpenAPIV3.ParameterObject;
-    export type HeaderObject = OpenAPIV3.HeaderObject;
-    export type ParameterBaseObject = OpenAPIV3.ParameterBaseObject;
+    export type HeaderObject = Modify<OpenAPIV3.HeaderObject, {
+        content?: {
+            [media: string]: MediaTypeObject;
+        };
+    }>;
+    export type ParameterBaseObject = Modify<OpenAPIV3.ParameterBaseObject, {
+        content?: {
+            [media: string]: MediaTypeObject;
+        };
+    }>;
     export type NonArraySchemaObjectType = OpenAPIV3.NonArraySchemaObjectType | 'null';
     export type ArraySchemaObjectType = OpenAPIV3.ArraySchemaObjectType;
     /**
@@ -173,19 +348,20 @@ export declare namespace OpenAPIV3_1 {
     export type SecuritySchemeObject = OpenAPIV3.SecuritySchemeObject;
     export type HttpSecurityScheme = OpenAPIV3.HttpSecurityScheme;
     export type ApiKeySecurityScheme = OpenAPIV3.ApiKeySecurityScheme;
+    export type OAuthFlows = OpenAPIV3.OAuthFlows;
     export type OAuth2SecurityScheme = OpenAPIV3.OAuth2SecurityScheme;
     export type OpenIdSecurityScheme = OpenAPIV3.OpenIdSecurityScheme;
     export type TagObject = OpenAPIV3.TagObject;
     export {};
 }
 export declare namespace OpenAPIV3 {
-    type Document<T = {}> = {
+    export type Document<T = {}> = {
         /**
          * Version of the OpenAPI specification
          * @see https://github.com/OAI/OpenAPI-Specification/tree/main/versions
          */
         openapi?: '3.0.0' | '3.0.1' | '3.0.2' | '3.0.3' | '3.0.4';
-        swagger?: undefined;
+        swagger?: never;
         info?: InfoObject;
         servers?: ServerObject[];
         paths?: PathsObject<T>;
@@ -194,7 +370,7 @@ export declare namespace OpenAPIV3 {
         tags?: TagObject[];
         externalDocs?: ExternalDocumentationObject;
     } & T & AnyOtherAttribute;
-    type InfoObject = {
+    export type InfoObject = {
         title?: string;
         description?: string;
         termsOfService?: string;
@@ -202,32 +378,32 @@ export declare namespace OpenAPIV3 {
         license?: LicenseObject;
         version?: string;
     };
-    type ContactObject = {
+    export type ContactObject = {
         name?: string;
         url?: string;
         email?: string;
     };
-    type LicenseObject = {
+    export type LicenseObject = {
         name?: string;
         url?: string;
     };
-    type ServerObject = {
+    export type ServerObject = {
         url?: string;
         description?: string;
         variables?: {
             [variable: string]: ServerVariableObject;
         };
     };
-    type ServerVariableObject = {
+    export type ServerVariableObject = {
         enum?: string[] | number[];
         default?: string | number;
         description?: string;
     };
-    type PathsObject<T = {}, P extends {} = {}> = {
+    export type PathsObject<T = {}, P extends {} = {}> = {
         [pattern: string]: (PathItemObject<T> & P) | undefined;
     };
-    type HttpMethods = 'get' | 'put' | 'post' | 'delete' | 'options' | 'head' | 'patch' | 'trace' | 'connect';
-    type PathItemObject<T = {}> = {
+    export type HttpMethods = OpenAPIV2.HttpMethods | 'trace';
+    export type PathItemObject<T = {}> = {
         $ref?: string;
         summary?: string;
         description?: string;
@@ -236,7 +412,7 @@ export declare namespace OpenAPIV3 {
     } & {
         [method in HttpMethods]?: OperationObject<T>;
     } & T & AnyOtherAttribute;
-    type OperationObject<T = {}> = {
+    export type OperationObject<T = {}> = {
         tags?: string[];
         summary?: string;
         description?: string;
@@ -252,21 +428,23 @@ export declare namespace OpenAPIV3 {
         security?: SecurityRequirementObject[];
         servers?: ServerObject[];
     } & T & AnyOtherAttribute;
-    type ExternalDocumentationObject = {
+    export type ExternalDocumentationObject = {
         description?: string;
         url?: string;
     };
-    type ParameterObject = {
+    export type ParameterLocation = 'query' | 'header' | 'path' | 'cookie';
+    export type ParameterObject = {
         name?: string;
-        in?: string;
+        in?: ParameterLocation;
     } & ParameterBaseObject;
-    type HeaderObject = {} & ParameterBaseObject;
-    type ParameterBaseObject = {
+    export type HeaderObject = {} & ParameterBaseObject;
+    export type ParameterStyle = 'matrix' | 'label' | 'form' | 'simple' | 'spaceDelimited' | 'pipeDelimited' | 'deepObject';
+    export type ParameterBaseObject = {
         description?: string;
         required?: boolean;
         deprecated?: boolean;
         allowEmptyValue?: boolean;
-        style?: string;
+        style?: ParameterStyle;
         explode?: boolean;
         allowReserved?: boolean;
         schema?: ReferenceObject | SchemaObject;
@@ -278,17 +456,17 @@ export declare namespace OpenAPIV3 {
             [media: string]: MediaTypeObject;
         };
     };
-    type NonArraySchemaObjectType = 'boolean' | 'object' | 'number' | 'string' | 'integer';
-    type ArraySchemaObjectType = 'array';
-    type SchemaObject = (ArraySchemaObject | NonArraySchemaObject) & AnyOtherAttribute;
-    type ArraySchemaObject = {
+    export type NonArraySchemaObjectType = 'boolean' | 'object' | 'number' | 'string' | 'integer';
+    export type ArraySchemaObjectType = 'array';
+    export type SchemaObject = (ArraySchemaObject | NonArraySchemaObject) & AnyOtherAttribute;
+    export type ArraySchemaObject = {
         type?: ArraySchemaObjectType;
         items?: ReferenceObject | SchemaObject;
     } & BaseSchemaObject;
-    type NonArraySchemaObject = {
+    export type NonArraySchemaObject = {
         type?: NonArraySchemaObjectType;
     } & BaseSchemaObject;
-    type BaseSchemaObject = {
+    export type BaseSchemaObject = {
         title?: string;
         description?: string;
         format?: string;
@@ -328,29 +506,29 @@ export declare namespace OpenAPIV3 {
         example?: any;
         deprecated?: boolean;
     };
-    type DiscriminatorObject = {
+    export type DiscriminatorObject = {
         propertyName?: string;
         mapping?: {
             [value: string]: string;
         };
     };
-    type XMLObject = {
+    export type XMLObject = {
         name?: string;
         namespace?: string;
         prefix?: string;
         attribute?: boolean;
         wrapped?: boolean;
     };
-    type ReferenceObject = {
+    export type ReferenceObject = {
         $ref?: string;
     } & AnyOtherAttribute;
-    type ExampleObject = {
+    export type ExampleObject = {
         summary?: string;
         description?: string;
         value?: any;
         externalValue?: string;
     };
-    type MediaTypeObject = {
+    export type MediaTypeObject = {
         schema?: ReferenceObject | SchemaObject;
         example?: any;
         examples?: {
@@ -360,7 +538,7 @@ export declare namespace OpenAPIV3 {
             [media: string]: EncodingObject;
         };
     };
-    type EncodingObject = {
+    export type EncodingObject = {
         contentType?: string;
         headers?: {
             [header: string]: ReferenceObject | HeaderObject;
@@ -369,17 +547,17 @@ export declare namespace OpenAPIV3 {
         explode?: boolean;
         allowReserved?: boolean;
     };
-    type RequestBodyObject = {
+    export type RequestBodyObject = {
         description?: string;
         content?: {
             [media: string]: MediaTypeObject;
         };
         required?: boolean;
     };
-    type ResponsesObject = {
+    export type ResponsesObject = {
         [code: string]: ReferenceObject | ResponseObject;
     };
-    type ResponseObject = {
+    export type ResponseObject = {
         description?: string;
         headers?: {
             [header: string]: ReferenceObject | HeaderObject;
@@ -391,7 +569,7 @@ export declare namespace OpenAPIV3 {
             [link: string]: ReferenceObject | LinkObject;
         };
     } & AnyOtherAttribute;
-    type LinkObject = {
+    export type LinkObject = {
         operationRef?: string;
         operationId?: string;
         parameters?: {
@@ -401,13 +579,13 @@ export declare namespace OpenAPIV3 {
         description?: string;
         server?: ServerObject;
     };
-    type CallbackObject = {
+    export type CallbackObject = {
         [url: string]: PathItemObject;
     };
-    type SecurityRequirementObject = {
+    export type SecurityRequirementObject = {
         [name: string]: string[];
     };
-    type ComponentsObject = {
+    export type ComponentsObject = {
         schemas?: {
             [key: string]: ReferenceObject | SchemaObject;
         };
@@ -436,64 +614,53 @@ export declare namespace OpenAPIV3 {
             [key: string]: ReferenceObject | CallbackObject;
         };
     };
-    type SecuritySchemeObject = HttpSecurityScheme | ApiKeySecurityScheme | OAuth2SecurityScheme | OpenIdSecurityScheme;
-    type HttpSecurityScheme = {
+    export type SecuritySchemeObject = HttpSecurityScheme | ApiKeySecurityScheme | OAuth2SecurityScheme | OpenIdSecurityScheme;
+    export type HttpSecurityScheme = {
         type?: 'http';
         description?: string;
         scheme?: string;
         bearerFormat?: string;
     } & AnyOtherAttribute;
-    type ApiKeySecurityScheme = {
+    export type ApiKeySecurityScheme = {
         type?: 'apiKey';
         description?: string;
         name?: string;
         in?: string;
     } & AnyOtherAttribute;
-    type OAuth2SecurityScheme = {
+    export type OAuthFlowBase = {
+        scopes?: {
+            [scope: string]: string;
+        };
+        refreshUrl?: string;
+    };
+    type OAuthFlowAuthorizationUrlTrait = {
+        authorizationUrl?: string;
+    };
+    export type OAuthFlowTokenUrlTrait = {
+        tokenUrl?: string;
+    };
+    export type OAuthFlows = {
+        implicit?: AnyOtherAttribute & OAuthFlowBase & OAuthFlowAuthorizationUrlTrait;
+        password?: AnyOtherAttribute & OAuthFlowBase & OAuthFlowTokenUrlTrait;
+        clientCredentials?: AnyOtherAttribute & OAuthFlowBase & OAuthFlowTokenUrlTrait;
+        authorizationCode?: AnyOtherAttribute & OAuthFlowBase & OAuthFlowAuthorizationUrlTrait & OAuthFlowTokenUrlTrait;
+    };
+    export type OAuth2SecurityScheme = {
         type?: 'oauth2';
         description?: string;
-        flows?: {
-            implicit?: {
-                authorizationUrl?: string;
-                refreshUrl?: string;
-                scopes?: {
-                    [scope: string]: string;
-                };
-            } & AnyOtherAttribute;
-            password?: {
-                tokenUrl?: string;
-                refreshUrl?: string;
-                scopes?: {
-                    [scope: string]: string;
-                };
-            } & AnyOtherAttribute;
-            clientCredentials?: {
-                tokenUrl?: string;
-                refreshUrl?: string;
-                scopes?: {
-                    [scope: string]: string;
-                };
-            } & AnyOtherAttribute;
-            authorizationCode?: {
-                authorizationUrl?: string;
-                tokenUrl?: string;
-                refreshUrl?: string;
-                scopes?: {
-                    [scope: string]: string;
-                };
-            } & AnyOtherAttribute;
-        };
-    };
-    type OpenIdSecurityScheme = {
+        flows?: OAuthFlows;
+    };
+    export type OpenIdSecurityScheme = {
         type?: 'openIdConnect';
         description?: string;
         openIdConnectUrl?: string;
     } & AnyOtherAttribute;
-    type TagObject = {
+    export type TagObject = {
         name?: string;
         description?: string;
         externalDocs?: ExternalDocumentationObject;
     } & AnyOtherAttribute;
+    export {};
 }
 export declare namespace OpenAPIV2 {
     type Document<T = {}> = {
@@ -617,15 +784,7 @@ export declare namespace OpenAPIV2 {
     type GeneralParameterObject = {
         allowEmptyValue?: boolean;
     } & ParameterObject & ItemsObject;
-    enum HttpMethods {
-        GET = "get",
-        PUT = "put",
-        POST = "post",
-        DELETE = "delete",
-        OPTIONS = "options",
-        HEAD = "head",
-        PATCH = "patch"
-    }
+    type HttpMethods = 'get' | 'put' | 'post' | 'delete' | 'options' | 'head' | 'patch';
     type PathItemObject<T = {}> = {
         $ref?: string;
         parameters?: Parameters;
@@ -638,9 +797,10 @@ export declare namespace OpenAPIV2 {
     type ParametersDefinitionsObject = {
         [index: string]: ParameterObject;
     };
+    type ParameterLocation = 'query' | 'header' | 'path' | 'formData' | 'body';
     type ParameterObject = {
         name?: string;
-        in?: string;
+        in?: ParameterLocation;
         description?: string;
         required?: boolean;
         [index: string]: any;