Optional
__typesType metadata for compile-time type tracking.
This optional property stores the original TypeScript types that were used to generate the JSON schemas. It's primarily used for type safety and doesn't affect runtime behavior. The property is marked as optional and undefined to prevent it from appearing in serialized JSON output.
This enables:
Reusable schema components for OpenAPI v3.0.
Contains reusable schema definitions, security schemes, and other components that can be referenced from the main schemas. This follows the OpenAPI v3.0 components structure and enables schema reuse and modularity.
Components include:
Array of generated JSON schemas.
Contains the actual JSON schema definitions generated from the input TypeScript types.
Each schema in this array corresponds to one of the types specified in the Types
template parameter. The schemas follow OpenAPI v3.0 format and may contain
references to components defined in the components property.
Schema references typically use the format: { "$ref": "#/components/schemas/TypeName" }
OpenAPI specification version identifier.
Always set to "3.0" to indicate this collection uses OpenAPI v3.0 schema format and constraints.
JSON Schema collection formatted for OpenAPI v3.0 specification.
This interface represents a collection of JSON schemas that comply with OpenAPI v3.0 standards, which are compatible with Swagger tools and legacy OpenAPI implementations. OpenAPI v3.0 has some limitations compared to v3.1, particularly around tuple types and pattern properties.
Key characteristics of v3.0: