[otnc]

概要

WebhookServer は cloudflare:node の httpServerHandler で Workers の fetch につなげば Cloudflare Workers でも動くことが分かったので、スモークテストで確認するようにし、対応環境とドキュメントを更新した。コードの変更はない。

関連 Issue

関連: #76

変更の種類

• バグ修正
• 新機能
• 公式 API 仕様変更への追従
• ドキュメント改善
• テスト追加・改善
• リファクタリング
• その他

変更内容

検証

workerd (Wrangler) 上で WebhookServer を起動し、httpServerHandler({ port }) に署名付きのリクエストを渡した。

• 正しい署名: 204、古いタイムスタンプ: 401、/healthz: 200
• ハンドラにイベントが届く

スモークテストの Workers の webhook をこの方法で確認するようにし、必須項目にした。

API クライアントと gRPC ストリーミングが Workers で使えない理由

あわせて実測で確認した。

• mixi2 の API は HTTP/2 の gRPC (application/grpc) だけを受け付ける (gRPC-Web / Connect は 415、HTTP/1.1 は 464)
• Workers の fetch は外部へ HTTP/1.1 で接続するため、mixi2 の API からは 464 が返る
• workerd の node:http2 は connect が未実装 (The http2.connect method is not implemented)

ドキュメント

環境	認証	API クライアント	WebhookServer	createWebhookHandler	gRPC ストリーミング
Cloudflare Workers	✅	❌	✅ (変更)	✅	❌

• Webhook のガイドに「Cloudflare Workers」の節を追加 (createWebhookHandler と WebhookServer + httpServerHandler の使い分けと例)
• 対応環境の説明と Skill を更新

チェックリスト

• npm run ci — フォーマットと Lint 通過
• npm run typecheck — 型チェック通過
• npm test — テスト全件通過
• npm run build — ビルド成功 (pages の astro build も確認済み)