Metadata used in the generation of OpenAPI spec via the createOpenApiSpec method. This is part of the SimpleMeta interface which can be a part of your Endpoint definitions

Hierarchy

Properties

description?: string

Detailed description text for the endpoint

example?: [reqBody: unknown, resBody: unknown]

Example (request) => response pair. estuary-rpc will use this both as the appropriate example fields within the OpenApi spec and will dynamically analyze the types to form a guess at what their description should be

reqSchema?: Schema

Schema definition for the Request object, overriding a guess formed in the example if provided. If the endpoint uses UrlFormTransport, this will be converted into the appropriate property list

resSchema?: Schema

Schema definition for the Request object, overriding a guess formed in the example if provided

summary?: string

Summary text for describing the endpoint

swagger?: Record<string, unknown>

Generic swagger JSON to extend the endpoint definition with, overriding everything else from this endpoint definition. Allowable fields defined here.

Generated using TypeDoc