Share
Embed
Transcript
48 slides
-
自己紹介 よだか - フリーランス、WebDeveloper - Next.js / Hono / Laravel
/ Vue.js / TypeScript - 最近Flutterも - TSKaigiスタッフ - 開催:2025年5月23日-24日 2Days - 会場:ベルサール神田 - 趣味で音楽を作ってます - 映画や小説が好き -
アジェンダ 1. What’s Hono? 2. Hono採用の経緯 3. どうやって型安全な開発をしているか 4. Next.jsとHonoのRPCによる連携
5. FlutterとHonoのOpenAPIによる連携 6. インフラ・改善点など小噺 7. まとめ -
What’s Hono?(ちょっとだけ) - ランタイム差異を吸収するポータビリティ - > Cloudflare Workers, Fastly Compute,
Deno, Bun, AWS Lambda,... - Web標準 - https://wintercg.org/(WinterTC) - 軽量・高速 - > Hono x 402,820 ops/sec ±4.78% (80 runs sampled) - > The hono/tiny preset is under 14kB. Hono has zero dependencies and uses only the Web Standards. - 豊富なミドルウェア、カスタマイズ性 - CORS、CSRF、JWT、Logger… - RPCやミドルウェアを使った、フロントエンドとの型共有 -
What’s Hono?(ちょっとだけ) - ランタイム差異を吸収するポータビリティ - > Cloudflare Workers, Fastly Compute,
Deno, Bun, AWS Lambda,... - Web標準 - https://wintercg.org/(WinterTC) - 軽量・高速 - > Hono x 402,820 ops/sec ±4.78% (80 runs sampled) - > The hono/tiny preset is under 14kB. Hono has zero dependencies and uses only the Web Standards. - 豊富なミドルウェア、カスタマイズ性 - CORS、CSRF、JWT、Logger… - RPCやミドルウェアを使った、フロントエンドとの型共有 ←ココ -
アジェンダ 1. What’s Hono? 2. Hono採用の経緯 3. どうやって型安全な開発をしているか 4. Next.jsとHonoのRPCによる連携
5. FlutterとHonoのOpenAPIによる連携 6. インフラ・改善点など小噺 7. まとめ -
アジェンダ 1. What’s Hono? 2. Hono採用の経緯 3. どうやって型安全な開発をしているか 4. Next.jsとHonoのRPCによる連携
5. FlutterとHonoのOpenAPIによる連携 6. インフラ・改善点など小噺 7. まとめ -
アジェンダ 1. What’s Hono? 2. Hono採用の経緯 3. どうやって型安全な開発をしているか 4. Next.jsとHonoのRPCによる連携
5. FlutterとHonoのOpenAPIによる連携 6. インフラ・改善点など小噺 7. まとめ -
HonoのAPI定義 const adminRouter = new Hono().post( '/posts', zValidator( 'json', z.object({
title: z.string(), body: z.string(), }) ), (c) => { // 型がついている const { title, body } = c.req.valid(‘json’) } ) type Form = { title: string body: string } -
Honoからエクスポートした型をNext.jsに渡す(Hono側) const app = new Hono() .route('/sp', spRouter) .route('/web', webRouter)
.route('/admin', adminRouter) export type AdminAppType = typeof adminRouter export type webRouter = typeof webRouter -
Honoからエクスポートした型をNext.jsに渡す(Next.js 側) import { hc } from 'hono/client' import {
AdminAppType } from 'backend/src' // typesafeなAPIClientとして使える。 const client = hc<AdminAppType>(baseUrl, { headers, }) -
Honoからエクスポートした型をNext.jsに渡す // クライアント import { hc } from 'hono/client' import
{ AdminAppType } from 'backend/src' // typesafeなAPIClientとして使える。 const client = hc<AdminAppType>(baseUrl, { headers, }) // サーバー const app = new Hono() .route('/sp', spRouter) .route('/web', webRouter) .route('/admin', adminRouter) export type AdminAppType = typeof adminRouter export type webRouter = typeof webRouter -
Next.js側 APIクライアント使用例 // パスも型がついている const res = await client.posts.$post({ json:
{ // request bodyも型がついてる title: 'Hello', body: 'Hono is a cool project', }, }) type Form = { title: string body: string } -
アジェンダ 1. What’s Hono? 2. Hono採用の経緯 3. どうやって型安全な開発をしているか 4. Next.jsとHonoのRPCによる連携
5. FlutterとHonoのOpenAPIによる連携 6. インフラ・改善点など小噺 7. まとめ -
Zod OpenAPI HonoでOpenAPIを生成する ・OpenAPIHonoインスタンスのopenapiメソッドの 第一引数に先ほどの routeを渡す ・第二引数のコールバックの戻り値( return c.json の部分)の型がrouteと違うとエラーを出してくれ
る。 ・c.req.validの戻り値もrouteに定義したスキーマ が 推論される ・つまり、 OpenAPIと実装が異なるということが防 げる! -
Zod OpenAPI HonoでOpenAPIを生成する ・もちろん、HonoでOpenAPIをホスティングできま す! ・これはJSONが返ってくるが、別で SwaggerUIのミ ドルウェアもあり、それを使うと webサイトとして公 開できる
・これをFlutterのリポジトリから叩くことで、 OpenAPIのスキーマを取得し、 APIクライアントを生 成する -
アジェンダ 1. What’s Hono? 2. Hono採用の経緯 3. どうやって型安全な開発をしているか 4. Next.jsとHonoのRPCによる連携
5. FlutterとHonoのOpenAPIによる連携 6. インフラ・改善点など小噺 7. まとめ -
改善点 - ミドルウェアの型周りのベストプラクティスがまだあまりわかっていない - 特定のmiddlewareを通ったあとにだけcontextに型を入れるみたいなことをうまくやりたい - 最近徐々にサポートが厚くなってきている印象( createRouteのmiddlewareも型がつくようになっ たり) -
アプリがReact NativeだったらアプリもRPC出来て…?? - より幸せになれる -
引用・参考文献 - Hono 公式ドキュメント - https://hono.dev/ - TRPC 公式ドキュメント -
https://trpc.io/ - SWRのサンプル - https://github.com/yodakaEngineer/hono-swr-example - 構成参考記事 - https://zenn.dev/yodaka/articles/ad49f29a54ceba