lacking type safety in the openapi route object

the static schema does not match the the request type, and does not have typing on the handle parameters

makes this library really hard to use

it's also not clear how to describe the parameters!

and there are multiple places where params can be defined!

need to make better use of typescript for this to be nice to use

i would also recommend the schema not being static so you don't have to compute the schema and construct everything until the route is hit

Start by reviewing the openapi route object, request type, and handle parameters described in the issue, then trace the multiple places where parameters can be defined. Compare the static schema with the request type and clarify how parameters should be described; done means the route API has consistent, useful TypeScript typing and a defined parameter model.

Written by the indexing model from the issue text.