Prisma Valibot Generator:Prismaスキーマから型安全なValibotバリデータを自動生成するツール

Library

概要

Prisma Valibot Generatorは、PrismaのデータモデルスキーマからValibot用のバリデーションコードを自動生成するTypeScript製ツールです。Prismaで定義したスキーマに基づき、型安全で再利用可能なValibotバリデータを一括生成することで、開発者はデータ検証の実装にかかる工数を大幅に削減できます。生成されるコードはツリーシェイク対応で、不要部分はバンドルから除外可能。これにより、フロントエンドやバックエンド問わず、Prismaの型情報を活用した堅牢なバリデーションを簡単に組み込めます。

GitHub

リポジトリの統計情報

  • スター数: 2
  • フォーク数: 0
  • ウォッチャー数: 2
  • コミット数: 11
  • ファイル数: 24
  • メインの言語: TypeScript

主な特徴

  • PrismaスキーマからValibotバリデータを自動生成し、手動実装の手間を削減
  • 生成コードは型安全かつツリーシェイク対応で効率的なバンドルサイズを実現
  • npmパッケージとして提供され、簡単にプロジェクトへ組み込み可能
  • Prismaのデータモデルに準拠した一貫性のあるバリデーションを保証

技術的なポイント

Prisma Valibot Generatorは、Prismaのスキーマファイル(schema.prisma)を入力として受け取り、TypeScriptでValibot用のバリデータコードを自動生成する仕組みを持ちます。Valibotは軽量かつ型安全なバリデーションライブラリであり、Prismaのデータモデルとバリデーションロジックを同じ型定義に基づいて管理することが可能です。

本ツールはPrismaのスキーマを解析し、各モデルのフィールド情報(型、null許容、デフォルト値、制約など)を抽出します。その上で、ValibotのAPIに対応するバリデーションチェーンを自動で構築。例えば、文字列型フィールドには文字列バリデーション、数値型には数値チェックといった具合に適切なバリデーションが付与されます。これにより、Prismaのスキーマ変更があった際もバリデーションコードのメンテナンスが容易になります。

さらに、生成されるコードはESモジュール形式で出力され、ツリーシェイクに対応。使用しているバリデータのみがバンドルに含まれるため、不要なコードの肥大化を防ぎます。TypeScriptで書かれているため、生成物は型推論が効き、IDEの補完機能と静的解析の恩恵も受けられます。

このツールはNode.js環境下で動作し、CLIやスクリプトとして利用可能。.env.example.prettierignoreなどの設定ファイルも備え、コード品質や環境変数管理をサポートしています。GitHub Actions用のワークフローも用意されており、継続的インテグレーションの構築も容易です。

利用者はPrismaのモデル定義とバリデーションロジックを分離せずに一元管理できるため、データ整合性の強化と開発効率の向上を同時に実現できます。特に大規模アプリケーションや複数人での開発現場において、バリデーションの重複実装や型不整合によるバグリスクを低減する効果が期待されます。

プロジェクトの構成

主要なファイルとディレクトリ:

  • .editorconfig: エディタ設定ファイル
  • .env.example: 環境変数設定の例ファイル
  • .github: GitHub関連の設定ディレクトリ(ワークフローなど)
  • .gitignore: Git管理対象外ファイル指定
  • .prettierignore: Prettierの整形除外設定ファイル
  • package.json: npmパッケージ設定と依存関係管理
  • tsconfig.json: TypeScriptコンパイラ設定
  • src/: ソースコードディレクトリ
  • scripts/: ビルドや生成処理のスクリプト群
  • README.md: リポジトリの説明ドキュメント

…他 19 ファイル

まとめ

Prismaスキーマを起点に型安全かつ再利用可能なバリデーションコードを自動生成し、開発効率を大幅に向上させるツール。

リポジトリ情報: