tsurara已上线
OpenAPI定義からTypeScriptの型定義・APIクライアントを生成する、Rust製OSSコード生成ツール
製品概要
tsuraraは、OpenAPIの定義ファイルからTypeScriptの型定義だけでなく、型安全なAPIクライアントや周辺コードまで生成するオープンソースのコード生成ツールです。作者のnazoさんが個人で開発・公開しました。既存の代表的な生成ツール(openapi-typescript、Hey API、Orval、Kubbなど)がある中で、あえて新規に作られた点が特徴で、名前は「なんとなく日本語にしよう」という意思で付けられたそうです。
製品目標とユーザー
- 目標:導入すると開発基盤の一部になるコード生成ツールだからこそ、「自分で継続的にメンテナンスできるもの」を持つこと
- 背景として、openapi-typescriptでは更新終了が表明され、Hey APIもリリースが長期間停滞している状況への不安があったと作者は述べています
- 想定ユーザーは、OpenAPIを採用するTypeScript開発者、とくにpnpm workspaceのモノレポ構成で生成した型やクライアントを複数パッケージから共有したい人です
ページ構造(提供形態)
- 本体:Rustで実装されたネイティブバイナリのコード生成器
- TypeScript向けパッケージ:`tsurara`(devDependencyとして導入)と `@tsurara/client`(生成コードが使うランタイム)
- 設定ファイル `tsurara.config.yaml` に入力(OpenAPI定義のURLやパス)と出力先を指定して生成します
- 公式ドキュメントサイト(日本語)とGitHubリポジトリが公開されています
核心機能
- 型安全なAPIクライアント生成:各エンドポイントに対応する呼び出し関数を生成。Result型を採用し、成功レスポンスだけでなくHTTPエラーや通信失敗も区別して扱えます。自由度より一貫性を重視した設計で、AIとの親和性を考えてエラーの分類を明確にしているそうです
- 周辺ツール連携:TypeScript向けにTanStack Query、Zod、MSWに対応し、ランタイムバリデーションやテスト用モックもOpenAPI定義から生成できます
- 複数言語対応:現在はTypeScriptがメインですが、Python・Rust・Goへのコード生成も実験的にサポートし、他言語の出力を追加できる余地も作ってあります
- AIコーディングエージェント連携:MCPサーバーやJSON形式のCLI出力を用意し、AIエージェントがAPIの定義情報を取得して開発に利用できます
導入と使い方
- インストール:`pnpm add -D tsurara` と `pnpm add @tsurara/client`
- `tsurara.config.yaml` に input(例:Petstoreのopenapi.json)と output(例:src/generated)を書く
- `pnpm exec tsurara generate` でコード生成し、`createClient` でクライアントを作って呼び出します
機能詳細(開発・運営方針)
- 実装はすべてAIコーディングエージェントを使って行われ、人間は要求の整理・設計方針の判断・生成結果の確認を担当した「フルAI開発」だと作者は明かしています
- TypeScript出力ではType Stripping(erasableSyntaxOnly)への対応も行っています
- 運営方針として、Pull Requestは受け付けず、Issueで不具合報告や機能要望を受け取り、実装はメンテナー側で行う方式を採用しています
- AIの利用料金はかかるものの、大きな機能追加がなければ個人でも十分に維持できそうだと作者は見ています
視覚と技術
- コード生成器はRust製で、ネイティブバイナリとして動作します
- 別ワークスペースで実証実験アプリを作りながら改善を繰り返す手法で実用性を検証したそうです
本期に含まれないこと(製品の境界)
- TypeScript以外の言語(Python・Rust・Go)は実験的サポートの位置づけです
- 外部からのPull Requestによるコード貢献は受け付けていません(要望はIssue経由)
—— 1VR精選 · 出典:Zenn @nazo
机器翻译 ·