TypeScript のような構文で OpenAPI のスキーマを定義する TypeSpec

import "@typespec/http"; using TypeSpec.Http; model User { id: string; name: string; birthday?: utcDateTime; address: Address; } model Address { street: string; city: string; state: string; zip: string; } @route("/users") interface Users { list(@query limit: int32, @query skip: int32): User[]; create(@body user: User): User; get(@path id: string): User; } 上記のコードをコンパイルすると、以下のような OpenAPI のスキーマが出力されま

[uehaj]

Prismaのモデル定義に近いかな。GraphQLが言語ニュートラルなのでTS限定ならこういうので良いと思うのはわかる。ただそれならTSモドキより、Zod+tRPC+trpc-openapiアダプタをおすすめする。真のTSをそのまま使えば良い。

[hirokinko]

生のJSONまたはYAMLを書きたくないからとコード中にデコレータでメタ情報を埋め込んだり、こういう新しい言語を作りたくなる気持ちはまあわかる。わかる、がこの手のアプローチはNestJSのSwaggerのクソさで懲りた。

[yojik]

OpenAPIがYAML/JSONフォーマットではなく、言語中立なIDLでやってくれればこんな悲しみを背負うことも無かったのだ。。

[hasiduki]

“TypeSpec provides highly extensible core language primitives that can describe API shapes common among REST, OpenAPI, GraphQL, gRPC, and other protocols”ほーん！！！！！

[ujeuau]

で、また対応してない構文だのあるんでしょう？なんで新しい言語なんて作ってしまうんだ。アホなの茶。