Generic OpenAPI Types

/**
 * Generic OpenAPI document type supporting all specification versions
 * @template T - Extension object type for custom properties
 */
type Document<T extends {} = {}> = 
  | OpenAPIV2.Document<T>
  | OpenAPIV3.Document<T>
  | OpenAPIV3_1.Document<T>;

/**
 * Generic OpenAPI operation type supporting all specification versions
 * @template T - Extension object type for custom properties
 */
type Operation<T extends {} = {}> =
  | OpenAPIV2.OperationObject<T>
  | OpenAPIV3.OperationObject<T>
  | OpenAPIV3_1.OperationObject<T>;

/**
 * Generic OpenAPI parameter type supporting all specification versions
 */
type Parameter =
  | OpenAPIV3_1.ReferenceObject
  | OpenAPIV3_1.ParameterObject
  | OpenAPIV3.ReferenceObject
  | OpenAPIV3.ParameterObject
  | OpenAPIV2.ReferenceObject
  | OpenAPIV2.Parameter;

/**
 * Generic OpenAPI parameters array type supporting all specification versions
 */
type Parameters =
  | (OpenAPIV3_1.ReferenceObject | OpenAPIV3_1.ParameterObject)[]
  | (OpenAPIV3.ReferenceObject | OpenAPIV3.ParameterObject)[]
  | (OpenAPIV2.ReferenceObject | OpenAPIV2.Parameter)[];

/**
 * Generic request interface for OpenAPI request processing
 */
interface Request {
  /** Request body data */
  body?: any;
  /** Request headers object */
  headers?: object;
  /** Path parameters object */
  params?: object;
  /** Query parameters object */
  query?: object;
}

import { OpenAPI } from "openapi-types";

// Version-agnostic document processing
function getDocumentTitle(doc: OpenAPI.Document): string {
  return doc.info.title;
}

// Version-agnostic operation processing
function getOperationId(operation: OpenAPI.Operation): string | undefined {
  return operation.operationId;
}

// Generic parameter validation
function validateParameter(param: OpenAPI.Parameter): boolean {
  // Handle different parameter formats across versions
  if ('$ref' in param) {
    return true; // Reference object
  }
  return param.name != null && param.in != null;
}

// Request processing
function processRequest(req: OpenAPI.Request) {
  console.log('Body:', req.body);
  console.log('Headers:', req.headers);
  console.log('Params:', req.params);
  console.log('Query:', req.query);
}