@redocly/openapi-core 1.0.0 → 1.0.2

package/src/typings/common.ts

@@ -0,0 +1,17 @@
+export interface StatsRow {
+  metric: string;
+  total: number;
+  color: 'red' | 'yellow' | 'green' | 'white' | 'magenta' | 'cyan';
+  items?: Set<string>;
+}
+
+export type StatsName =
+  | 'operations'
+  | 'refs'
+  | 'tags'
+  | 'externalDocs'
+  | 'pathItems'
+  | 'links'
+  | 'schemas'
+  | 'parameters';
+export type StatsAccumulator = Record<StatsName, StatsRow>;

package/src/typings/openapi.ts

@@ -0,0 +1,298 @@
+export interface Oas3Definition {
+  openapi: string;
+  info?: Oas3Info;
+  servers?: Oas3Server[];
+  paths?: Oas3Paths;
+  components?: Oas3Components;
+  security?: Oas3SecurityRequirement[];
+  tags?: Oas3Tag[];
+  externalDocs?: Oas3ExternalDocs;
+  'x-webhooks'?: Oas3_1Webhooks;
+}
+
+export interface Oas3Info {
+  title: string;
+  version: string;
+
+  description?: string;
+  termsOfService?: string;
+  contact?: Oas3Contact;
+  license?: Oas3License;
+}
+
+export interface Oas3Server {
+  url: string;
+  description?: string;
+  variables?: { [name: string]: Oas3ServerVariable };
+}
+
+export interface Oas3ServerVariable {
+  enum?: string[];
+  default: string;
+  description?: string;
+}
+
+export interface Oas3Paths {
+  [path: string]: Referenced<Oas3PathItem>;
+}
+export interface OasRef {
+  $ref: string;
+}
+
+export type Referenced<T> = OasRef | T;
+
+export interface Oas3PathItem {
+  summary?: string;
+  description?: string;
+  get?: Oas3Operation;
+  put?: Oas3Operation;
+  post?: Oas3Operation;
+  delete?: Oas3Operation;
+  options?: Oas3Operation;
+  head?: Oas3Operation;
+  patch?: Oas3Operation;
+  trace?: Oas3Operation;
+  servers?: Oas3Server[];
+  parameters?: Array<Referenced<Oas3Parameter>>;
+}
+
+export interface Oas3XCodeSample {
+  lang: string;
+  label?: string;
+  source: string;
+}
+
+export interface Oas3Operation {
+  tags?: string[];
+  summary?: string;
+  description?: string;
+  externalDocs?: Oas3ExternalDocs;
+  operationId?: string;
+  parameters?: Array<Referenced<Oas3Parameter>>;
+  requestBody?: Referenced<Oas3RequestBody>;
+  responses: Oas3Responses;
+  callbacks?: { [name: string]: Referenced<Oas3Callback> };
+  deprecated?: boolean;
+  security?: Oas3SecurityRequirement[];
+  servers?: Oas3Server[];
+  'x-codeSamples'?: Oas3XCodeSample[];
+  'x-code-samples'?: Oas3XCodeSample[]; // deprecated
+  'x-hideTryItPanel'?: boolean;
+}
+
+export interface Oas3Parameter {
+  name: string;
+  in?: Oas3ParameterLocation;
+  description?: string;
+  required?: boolean;
+  deprecated?: boolean;
+  allowEmptyValue?: boolean;
+  style?: Oas3ParameterStyle;
+  explode?: boolean;
+  allowReserved?: boolean;
+  schema?: Referenced<Oas3Schema>;
+  example?: any;
+  examples?: { [media: string]: Referenced<Oas3Example> };
+  content?: { [media: string]: Oas3MediaType };
+}
+
+export interface Oas3Example {
+  value: any;
+  summary?: string;
+  description?: string;
+  externalValue?: string;
+}
+
+export interface Oas3Xml {
+  name?: string;
+  namespace?: string;
+  prefix?: string;
+  attribute?: string;
+  wrapped?: string;
+}
+
+export interface Oas3Schema {
+  $ref?: string;
+  type?: string;
+  properties?: { [name: string]: Oas3Schema };
+  additionalProperties?: boolean | Oas3Schema;
+  description?: string;
+  default?: any;
+  items?: Oas3Schema;
+  required?: string[];
+  readOnly?: boolean;
+  writeOnly?: boolean;
+  deprecated?: boolean;
+  format?: string;
+  externalDocs?: Oas3ExternalDocs;
+  discriminator?: Oas3Discriminator;
+  nullable?: boolean;
+  oneOf?: Oas3Schema[];
+  anyOf?: Oas3Schema[];
+  allOf?: Oas3Schema[];
+  not?: Oas3Schema;
+
+  title?: string;
+  multipleOf?: number;
+  maximum?: number;
+  exclusiveMaximum?: boolean;
+  minimum?: number;
+  exclusiveMinimum?: boolean;
+  maxLength?: number;
+  minLength?: number;
+  pattern?: string;
+  maxItems?: number;
+  minItems?: number;
+  uniqueItems?: boolean;
+  maxProperties?: number;
+  minProperties?: number;
+  enum?: any[];
+  example?: any;
+
+  xml?: Oas3Xml;
+  'x-tags'?: string[];
+}
+
+export type Oas3_1Schema = Oas3Schema & {
+  type?: string | string[];
+  examples?: any[];
+};
+
+export interface Oas3_1Definition extends Oas3Definition {
+  webhooks?: Oas3_1Webhooks;
+}
+
+export interface Oas3_1Webhooks {
+  [webhook: string]: Referenced<Oas3PathItem>;
+}
+
+export interface Oas3Discriminator {
+  propertyName: string;
+  mapping?: { [name: string]: string };
+  'x-explicitMappingOnly'?: boolean;
+}
+
+export interface Oas3MediaType {
+  schema?: Referenced<Oas3Schema>;
+  example?: any;
+  examples?: { [name: string]: Referenced<Oas3Example> };
+  encoding?: { [field: string]: Oas3Encoding };
+}
+
+export interface Oas3Encoding {
+  contentType: string;
+  headers?: { [name: string]: Referenced<Oas3Header> };
+  style: Oas3ParameterStyle;
+  explode: boolean;
+  allowReserved: boolean;
+}
+
+export type Oas3ParameterLocation = 'query' | 'header' | 'path' | 'cookie';
+export type Oas3ParameterStyle =
+  | 'matrix'
+  | 'label'
+  | 'form'
+  | 'simple'
+  | 'spaceDelimited'
+  | 'pipeDelimited'
+  | 'deepObject';
+
+export interface Oas3RequestBody {
+  description?: string;
+  required?: boolean;
+  content: { [mime: string]: Oas3MediaType };
+}
+
+export interface Oas3Responses {
+  [code: string]: Oas3Response;
+}
+
+export interface Oas3Response {
+  description?: string;
+  headers?: { [name: string]: Referenced<Oas3Header> };
+  content?: { [mime: string]: Oas3MediaType };
+  links?: { [name: string]: Referenced<Oas3Link> };
+}
+
+export interface Oas3Link {
+  $ref?: string;
+}
+
+export type Oas3Header = Omit<Oas3Parameter, 'in' | 'name'>;
+
+export interface Oas3Callback {
+  [name: string]: Oas3PathItem;
+}
+
+export interface Oas3Components {
+  schemas?: { [name: string]: Referenced<Oas3Schema> };
+  responses?: { [name: string]: Referenced<Oas3Response> };
+  parameters?: { [name: string]: Referenced<Oas3Parameter> };
+  examples?: { [name: string]: Referenced<Oas3Example> };
+  requestBodies?: { [name: string]: Referenced<Oas3RequestBody> };
+  headers?: { [name: string]: Referenced<Oas3Header> };
+  securitySchemes?: { [name: string]: Referenced<Oas3SecurityScheme> };
+  links?: { [name: string]: Referenced<Oas3Link> };
+  callbacks?: { [name: string]: Referenced<Oas3Callback> };
+}
+
+export type Oas3ComponentName = keyof Oas3Components;
+
+export interface Oas3SecurityRequirement {
+  [name: string]: string[];
+}
+
+export interface Oas3SecurityScheme {
+  type: 'apiKey' | 'http' | 'oauth2' | 'openIdConnect';
+  description?: string;
+  name?: string;
+  in?: 'query' | 'header' | 'cookie';
+  scheme?: string;
+  bearerFormat: string;
+  flows: {
+    implicit?: {
+      refreshUrl?: string;
+      scopes: Record<string, string>;
+      authorizationUrl: string;
+    };
+    password?: {
+      refreshUrl?: string;
+      scopes: Record<string, string>;
+      tokenUrl: string;
+    };
+    clientCredentials?: {
+      refreshUrl?: string;
+      scopes: Record<string, string>;
+      tokenUrl: string;
+    };
+    authorizationCode?: {
+      refreshUrl?: string;
+      scopes: Record<string, string>;
+      tokenUrl: string;
+    };
+  };
+  openIdConnectUrl?: string;
+}
+
+export interface Oas3Tag {
+  name: string;
+  description?: string;
+  externalDocs?: Oas3ExternalDocs;
+  'x-displayName'?: string;
+}
+
+export interface Oas3ExternalDocs {
+  description?: string;
+  url: string;
+}
+
+export interface Oas3Contact {
+  name?: string;
+  url?: string;
+  email?: string;
+}
+
+export interface Oas3License {
+  name: string;
+  url?: string;
+}

package/src/typings/swagger.ts

@@ -0,0 +1,236 @@
+import { Referenced } from './openapi';
+import { Schema } from 'js-yaml';
+
+export interface Oas2Definition {
+  swagger: '2.0';
+  info?: Oas2Info;
+  paths?: Oas2Paths;
+
+  basePath?: string;
+  schemes?: string[];
+  consumes?: string[];
+  produces?: string[];
+
+  definitions?: Record<string, Oas2Schema>;
+  responses?: Record<string, Oas2Response>;
+  parameters?: Record<string, Oas2Parameter>;
+  securityDefinitions?: Record<string, Oas2SecurityScheme>;
+  security?: Oas2SecurityRequirement[];
+  tags?: Oas2Tag[];
+  externalDocs?: Oas2ExternalDocs;
+}
+
+export interface Oas2Components {
+  definitions?: { [name: string]: Record<string, Oas2Schema> };
+  securityDefinitions?: { [name: string]: Record<string, Oas2SecurityScheme> };
+  responses?: { [name: string]: Record<string, Oas2Response> };
+  parameters?: { [name: string]: Record<string, Oas2Parameter> };
+}
+
+export interface Oas2Info {
+  title: string;
+  version: string;
+
+  description?: string;
+  termsOfService?: string;
+  contact?: Oas2Contact;
+  license?: Oas2License;
+}
+
+export interface Oas2Paths {
+  [path: string]: Oas2PathItem;
+}
+
+export interface Oas2PathItem {
+  get?: Oas2Operation;
+  put?: Oas2Operation;
+  post?: Oas2Operation;
+  delete?: Oas2Operation;
+  options?: Oas2Operation;
+  head?: Oas2Operation;
+  patch?: Oas2Operation;
+  parameters?: Array<Referenced<Oas2Parameter>>;
+}
+
+export interface Oas2XCodeSample {
+  lang: string;
+  label?: string;
+  source: string;
+}
+
+export interface Oas2Operation {
+  tags?: string[];
+  consumes?: string[];
+  produces?: string[];
+  schemes?: string[];
+  summary?: string;
+  description?: string;
+  externalDocs?: Oas2ExternalDocs;
+  operationId?: string;
+  parameters?: Array<Referenced<Oas2Parameter>>;
+  responses: Oas2Responses;
+  deprecated?: boolean;
+  security?: Oas2SecurityRequirement[];
+  'x-codeSamples'?: Oas2XCodeSample[];
+  'x-code-samples'?: Oas2XCodeSample[]; // deprecated
+  'x-hideTryItPanel'?: boolean;
+}
+
+export type Oas2Parameter = Oas2BodyParameter | Oas2SimpleParameter;
+
+export interface Oas2BodyParameter {
+  name: string;
+  in: 'body';
+  schema: Oas2Schema;
+
+  description?: string;
+  required?: boolean;
+}
+
+export interface Oas2SimpleParameter {
+  name: string;
+  in: Oas2ParameterLocation;
+  description?: string;
+  required?: boolean;
+  type: 'string' | 'number' | 'integer' | 'boolean' | 'array' | 'file';
+
+  format?: string;
+  allowEmptyValue?: boolean;
+  items?: Oas2Items;
+  collectionFormat?: 'csv' | 'ssv' | 'tsv' | 'pipes' | 'multi';
+  default?: any;
+  maximum?: number;
+  exclusiveMaximum?: boolean;
+  minimum?: number;
+  exclusiveMinimum?: boolean;
+  maxLength?: number;
+  minLength?: number;
+  pattern?: string;
+  maxItems?: number;
+  minItems?: number;
+  uniqueItems?: boolean;
+  enum?: any[];
+  multipleOf?: number;
+}
+
+export interface Oas2Items {
+  type: 'string' | 'number' | 'integer' | 'boolean' | 'array';
+
+  format?: string;
+  allowEmptyValue?: boolean;
+  items?: Oas2Items;
+  collectionFormat?: 'csv' | 'ssv' | 'tsv' | 'pipes' | 'multi';
+  default?: any;
+  maximum?: number;
+  exclusiveMaximum?: boolean;
+  minimum?: number;
+  exclusiveMinimum?: boolean;
+  maxLength?: number;
+  minLength?: number;
+  pattern?: string;
+  maxItems?: number;
+  minItems?: number;
+  uniqueItems?: boolean;
+  enum?: any[];
+  multipleOf?: number;
+}
+
+export interface Oas2Xml {
+  name?: string;
+  namespace?: string;
+  prefix?: string;
+  attribute?: string;
+  wrapped?: string;
+}
+
+export interface Oas2Schema {
+  $ref?: string;
+  type?: string;
+  properties?: { [name: string]: Oas2Schema };
+  additionalProperties?: boolean | Oas2Schema;
+  description?: string;
+  default?: any;
+  items?: Oas2Schema;
+  required?: string[];
+  readOnly?: boolean;
+  deprecated?: boolean;
+  format?: string;
+  externalDocs?: Oas2ExternalDocs;
+  discriminator?: string;
+  nullable?: boolean;
+  allOf?: Oas2Schema[];
+
+  title?: string;
+  multipleOf?: number;
+  maximum?: number;
+  exclusiveMaximum?: boolean;
+  minimum?: number;
+  exclusiveMinimum?: boolean;
+  maxLength?: number;
+  minLength?: number;
+  pattern?: string;
+  maxItems?: number;
+  minItems?: number;
+  uniqueItems?: boolean;
+  maxProperties?: number;
+  minProperties?: number;
+  enum?: any[];
+  example?: any;
+
+  xml?: Oas2Xml;
+  'x-tags'?: string[];
+}
+
+export type Oas2ParameterLocation = 'query' | 'header' | 'path' | 'formData';
+
+export interface Oas2Responses {
+  [code: string]: Oas2Response;
+}
+
+export type Oas2Header = Oas2Items & { description?: 'string' };
+
+export interface Oas2Response {
+  description?: string;
+  schema: Referenced<Schema>;
+  examples?: Record<string, any>;
+  headers?: Record<string, Oas2Header>;
+}
+
+export interface Oas2SecurityRequirement {
+  [name: string]: string[];
+}
+
+export interface Oas2SecurityScheme {
+  type: 'basic' | 'apiKey' | 'oauth2';
+  description?: string;
+  name?: string;
+  in?: 'query' | 'header' | 'cookie';
+  scheme?: string;
+  flow: 'implicit' | 'password' | 'application' | 'accessCode';
+  authorizationUrl?: string;
+  tokenUrl?: string;
+  scopes?: Record<string, string>;
+}
+
+export interface Oas2Tag {
+  name: string;
+  description?: string;
+  externalDocs?: Oas2ExternalDocs;
+  'x-displayName'?: string;
+}
+
+export interface Oas2ExternalDocs {
+  description?: string;
+  url: string;
+}
+
+export interface Oas2Contact {
+  name?: string;
+  url?: string;
+  email?: string;
+}
+
+export interface Oas2License {
+  name: string;
+  url?: string;
+}