{"repo":"Eywek/typoa","free":true,"listed":false,"github":"https://github.com/Eywek/typoa","clone":"git clone https://github.com/Eywek/typoa.git","description":"🏗 Build OpenAPI definitions from Typescript typings","language":"TypeScript","stars":29,"topics":["typescript","openapi","openapi-generator","swagger","express","codegen"],"license":"MIT","category":"api-integrations-sdks","readme_excerpt":"typoa Typ escript O pen A PI Generator This tools is inspired from tsoa, the purpose is to be able to generate openapi definitions and express routes definitions via Typescript typings. We're using ts-morph under the hood. Why Tsoa is a great package and it's working fine for simple typescript typings, which I think are principal use cases, it's used by many developers and maintained. BUT , I've used tsoa in production projects and I've encountered many issues (I was able to fix some of them), but when I've tried to use more complex types (inheritance, deep generics, conditionnal types...) tsoa wasn't able to provide me good openapi definitions, and without even telling me it failed to generate the right schema. I've spent a lot of time trying to fix those issues, using tricks to have a workaround. But it was never perfect, I've ended with too many duplicated types only because tsoa was not able to resolve correct typings. I wasn't confident when updating my models and I was always checking that the swagger wasn't broken. And all of this issues are caused by the custom type resolver of tsoa, in this package we're using ts-morph , it allows us to build a resolver more resilient that handle all cases without maintenance on our side. Features - Generate express router via typescript decorators in controllers - Generate openapi definition via typescript typings - Allowing to export custom types to openapi schema - Runtime validation against openapi schema - Use jsdoc for addition","default_branch":null,"files":null,"tree":[],"storefront":"/r/Eywek","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/Eywek/typoa/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}