Convex + Transloadit:アップロードと処理
Transloadit 向けの新しい Convex 連携として、@transloadit/convex を npm で公開しました。アップロード、ファイル処理、Webhook を自然に組み込めます。すぐに実行できるデモアプリ(結婚式のギャラリー)、Uppy ファイルアップローダーとの組み合わせ方を説明するドキュメント、シークレットをクライアントに渡さず、リクエストの改ざんを防ぐためのシンプルなサーバー側ヘルパーを用意しています。
利用できるもの
- ブラウザーから Transloadit にアップロードするための、Uppy と
@uppy/transloaditのシンプルな構成。必要に応じてエンコード設定も送信できます。 - ペイロードの受信、署名、検証と、結果への参照の保存ができる Convex モジュール
- 一連のフローを実演する、Next.js で作成したデモギャラリー
- すべてが正常に動作し続けることを確認する Playwright テストスイート
つまり、最大 200 GB のファイルの高速かつ再開可能なアップロード、動画エンコーディング、AI 認識、リアルタイムで更新されるユーザーインターフェースを利用できます。
インタラクティブデモ
デモアプリをぜひお試しください。
ソースコードとドキュメントはこちらで公開しています。
仕組み
- ユーザーが Uppy にファイルをドラッグします。
- Uppy が Assembly を作成し、ファイルと 処理設定 を Transloadit に送信します。Convex は改ざんを防ぐため、バックエンドに保持しているシークレットでこのリクエストに署名します。
- ユーザーはアップロードを終えると、ページを離れられます。
- Transloadit がファイルを処理し、処理設定 に従って結果を CloudFlare R2 に保存します。結果の準備ができると、Convex の Webhook を呼び出します。
- Convex がデータベースに参照を保存し、ギャラリーがリアルタイムで更新されます。
クイックスタート
Convex コンポーネントと、当社のブラウザー向けアップローダー Uppy をインストールします。
npm i @transloadit/convex @uppy/core @uppy/transloadit
続いて README に従い、Convex のアクション、Webhook、Uppy の設定を連携させます。
実行可能なリファレンスアプリが必要な場合は、リポジトリをクローンしてデモをローカルで実行してください。
この構成を選ぶ理由は?
Convex はリアルタイムデータと安全なアクションを得意としています。Transloadit はトランスコーディング、画像操作、ストレージなど、負荷の高い処理を担います。
組み合わせることで、次のことができます。
- Convex のアクション内でシークレットを保持
- リクエストに安全に署名
- tus の速度と信頼性を活用したアップロードのスケーリング
- 独自サーバーを用意せずに Webhook を処理
- Convex データベースへの結果の保存と、利用側への通知
- 迅速なリリース
今後の予定は?
Transloadit 向けの Convex 連携は、現時点ではまだ 1.0 の段階に達していません。今後 API の構成を調整し、開発者体験の改善を続ける可能性はありますが、すでに実際のアプリで利用できる状態です。Transloadit と Uppy は実績のある信頼性の高い構成要素で、大規模なコミュニティにも支えられています。Convex でアプリを開発していてファイル処理が必要なら、ぜひ試して、今後どのような機能が欲しいかお聞かせください。
