prisma-nestjs-graphqlで簡単型生成

幸い、使用しているORMもPrismaだったので、これは来たと思い試しに使ってみました。

使用方法

使用方法は簡単で、Prismaのschemaファイルにgeneratorなどを書くだけ
もっと凝ろうと思えば、ValidationPipeを追加してValidationなども設定できるっぽい
今回は最小構成で試してみる

ステップは大きく2つ

• generatorの追加
• modelの作成

まずは、schema.prismaにgeneratorを追加

generator nestgraphql {
  provider = "node node_modules/prisma-nestjs-graphql"
  output   = "../src/@generated/prisma-nestjs-graphql"
}

outputで生成先のフォルダをschema.prismaからの相対パスで指定できる

次に、モデルを作成する

model User {
  id       String @id @default(uuid())
  /// @HideField()
  password String
  name     String
  email    String
}

この際///（3つのスラッシュ）からはじまるコメントでディレクティブを記述することで生成されるObjectTypeやInputTypeにディレクティブを追加することができる

今回 password の上に @HideField() のディレクティブを追加している
これを追加することで対象のフィールドをGraphQLのスキーマから除外することができる
今回でいうと password は外に出てほしくない情報なので、 @HideField() を追加することで秘匿化している

また、　@HideField({ input: true, output: true }) とすると、入力側からも出力側からも除外される
(例えば、createdAtなどアプリ上必要ない情報はこうやって隠すといいかも？)

ちなみにデフォルトの @HideField() は @HideField({ output: true }) と同じ

生成された型

実際に生成されたファイルがこちら

@HideField() で指定したものがちゃんとディレクティブでついていることがわかる
prismaのスキーマで何もコメントを追加していないとデフォルトで良きに型をつけてField化してくれる

@ObjectType()
export class User {

    @Field(() => ID, {nullable:false})
    id!: string;

    @HideField()
    password!: string;

    @Field(() => String, {nullable:false})
    name!: string;

    @Field(() => String, {nullable:false})
    email!: string;
}

続いてInputType
こちらもちゃんと型が生成されている
今回passwordは出力だけ隠すようにしたのでInputTypeはFieldとして定義されている

@InputType()
export class UserCreateInput {

    @Field(() => String, {nullable:true})
    id?: string;

    @Field(() => String, {nullable:false})
    password!: string;

    @Field(() => String, {nullable:false})
    name!: string;

    @Field(() => String, {nullable:false})
    email!: string;
}

最後にArgsType
こちららは先ほどのInputTypeを持つArgsになっている
Resolverではこの型を貰えば、そのままPrismaでcreateできるようになっている

@ArgsType()
export class CreateOneUserArgs {

    @Field(() => UserCreateInput, {nullable:false})
    data!: UserCreateInput;
}

最後に

今回、prisma-nestjs-graphqlを使用し型生成を行なってみたが、割とたくさんファイルが生成されており、色んなユースケースに対して使用できそうな感じだった
(ここでは3つの型しか紹介していないが、みた感じ30~40ファイルくらい生成されている)

シンプルなCRUDアプリならかなり強力な型生成だと思う。
一方、ちょっと複雑さがあるようなアプリだとどうなるのかがまだ不明なので、引き続き使ってみて実用化可能かどうかを判断してみないなと思います

とりあえず、Validationは便利そうなので使ってみたい