This project is looking for maintainers.
We are not using this package anymore ourselves, so we can no longer validate/review/test any incoming PRs anymore and ensure correct functionality.
If you are an experienced open source contributor and are interested in taking over maintenance, please open a GitHub issue and let's discuss how to proceed.
Generates ConnectDTO, CreateDTO, UpdateDTO, and Entity classes for models in your Prisma Schema. This is useful if you want to leverage OpenAPI in your NestJS application - but also helps with GraphQL resources as well). NestJS Swagger requires input parameters in controllers to be described through classes because it leverages TypeScript's emitted metadata and Reflection to generate models/components for the OpenAPI spec. It does the same for response models/components on your controller methods.
These classes can also be used with the built-in ValidationPipe and Serialization.
npm install --save-dev @vegardit/prisma-generator-nestjs-dtogenerator nestjsDto {
provider = "prisma-generator-nestjs-dto"
output = "../src/generated/nestjs-dto"
outputToNestJsResourceStructure = "false"
exportRelationModifierClasses = "true"
reExport = "false"
createDtoPrefix = "Create"
updateDtoPrefix = "Update"
dtoSuffix = "Dto"
entityPrefix = ""
entitySuffix = ""
fileNamingStyle = "camel"
}All parameters are optional.
- [
output]: (default:"../src/generated/nestjs-dto") - output path relative to yourschema.prismafile - [
outputToNestJsResourceStructure]: (default:"false") - writesdtos andentitiesto subfolders aligned with NestJS CRUD generator. Resource module name is derived from lower-cased model name inschema.prisma - [
exportRelationModifierClasses]: (default:"true") - Should extra classes generated for relationship field operations on DTOs be exported? - [
reExport]: (default:false) - Should an index.ts be created for every folder? - [
createDtoPrefix]: (default:"Create") - phrase to prefix everyCreateDTOclass with - [
updateDtoPrefix]: (default:"Update") - phrase to prefix everyUpdateDTOclass with - [
dtoSuffix]: (default:"Dto") - phrase to suffix everyCreateDTOandUpdateDTOclass with - [
entityPrefix]: (default:"") - phrase to prefix everyEntityclass with - [
entitySuffix]: (default:"") - phrase to suffix everyEntityclass with - [
fileNamingStyle]: (default:"camel") - how to name generated files. Valid choices are"camel","pascal","kebab"and"snake".
Annotations provide additional information to help this generator understand your intentions. They are applied as tripple slash comments to a field node in your Prisma Schema. You can apply multiple annotations to the same field.
model Post {
/// @DtoCreateOptional
/// @DtoUpdateHidden
createdAt DateTime @default(now())
}- @DtoReadOnly - omits field in
CreateDTOandUpdateDTO - @DtoEntityHidden - omits field in
Entity - @DtoCreateOptional - adds field optionally to
CreateDTO- useful for fields that would otherwise be omitted (e.g.@id,@updatedAt) - @DtoUpdateOptional- adds field optionally to
UpdateDTO- useful for fields that would otherwise be omitted (e.g.@id,@updatedAt) - @DtoRelationRequired - marks relation required in
Entityalthough it's optional in PrismaSchema - useful when you don't want (SQL)ON DELETE CASCADEbehavior - but your logical data schema sees this relation as required (Note: becomes obsolete once referentialActions are released and stable) - @DtoRelationCanCreateOnCreate - adds create option on a relation field in the generated
CreateDTO- useful when you want to allow to create related model instances - @DtoRelationCanConnectOnCreate - adds connect option on a relation field in the generated
CreateDTO- useful when you want/need to connect to an existing related instance - @DtoRelationCanCreateOnUpdate - adds create option on a relation field in the generated
UpdateDTO- useful when you want to allow to create related model instances - @DtoRelationCanConnectOnUpdate - adds connect option on a relation field in the generated
UpdateDTO- useful when you want/need to connect to an existing related instance
Prisma Schema
generator nestjsDto {
provider = "prisma-generator-nestjs-dto"
output = "../src"
outputToNestJsResourceStructure = "true"
}
model Question {
id String @id @default(dbgenerated("gen_random_uuid()")) @db.Uuid
/// @DtoReadOnly
createdAt DateTime @default(now())
/// @DtoRelationRequired
createdBy User? @relation("CreatedQuestions", fields: [createdById], references: [id])
createdById String? @db.Uuid
updatedAt DateTime @updatedAt
/// @DtoRelationRequired
updatedBy User? @relation("UpdatedQuestions", fields: [updatedById], references: [id])
updatedById String? @db.Uuid
/// @DtoRelationRequired
/// @DtoRelationCanConnectOnCreate
category Category? @relation(fields: [categoryId], references: [id])
categoryId String? @db.Uuid
/// @DtoCreateOptional
/// @DtoRelationCanCreateOnCreate
/// @DtoRelationCanConnectOnCreate
/// @DtoRelationCanCreateOnUpdate
/// @DtoRelationCanConnectOnUpdate
tags Tag[]
title String
content String
responses Response[]
}
Generated results
// src/question/dto/connect-question.dto.ts
export class ConnectQuestionDto {
id: string;
}// src/question/dto/create-question.dto.ts
import { ApiExtraModels } from '@nestjs/swagger';
import { ConnectCategoryDto } from '../../category/dto/connect-category.dto';
import { CreateTagDto } from '../../tag/dto/create-tag.dto';
import { ConnectTagDto } from '../../tag/dto/connect-tag.dto';
export class CreateQuestionCategoryRelationInputDto {
connect: ConnectCategoryDto;
}
export class CreateQuestionTagsRelationInputDto {
create?: CreateTagDto[];
connect?: ConnectTagDto[];
}
@ApiExtraModels(
ConnectCategoryDto,
CreateQuestionCategoryRelationInputDto,
CreateTagDto,
ConnectTagDto,
CreateQuestionTagsRelationInputDto,
)
export class CreateQuestionDto {
category: CreateQuestionCategoryRelationInputDto;
tags?: CreateQuestionTagsRelationInputDto;
title: string;
content: string;
}// src/question/dto/update-question.dto.ts
import { ApiExtraModels } from '@nestjs/swagger';
import { CreateTagDto } from '../../tag/dto/create-tag.dto';
import { ConnectTagDto } from '../../tag/dto/connect-tag.dto';
export class UpdateQuestionTagsRelationInputDto {
create?: CreateTagDto[];
connect?: ConnectTagDto[];
}
@ApiExtraModels(CreateTagDto, ConnectTagDto, UpdateQuestionTagsRelationInputDto)
export class UpdateQuestionDto {
tags?: UpdateQuestionTagsRelationInputDto;
title?: string;
content?: string;
}// src/question/entities/question.entity.ts
import { User } from '../../user/entities/user.entity';
import { Category } from '../../category/entities/category.entity';
import { Tag } from '../../tag/entities/tag.entity';
import { Response } from '../../response/entities/response.entity';
export class Question {
id: string;
createdAt: Date;
createdBy?: User;
createdById: string;
updatedAt: Date;
updatedBy?: User;
updatedById: string;
category?: Category;
categoryId: string;
tags?: Tag[];
title: string;
content: string;
responses?: Response[];
}Generally we read field properties from the DMMF.Field information provided by @prisma/generator-helper. Since a few scenarios don't become quite clear from that, we also check for additional annotations (or decorators) in a field's documentation (that is anything provided as a tripple slash comments for that field in your prisma.schema).
Initially, we wanted DTO classes to implement Prisma.<ModelName><(Create|Update)>Input but that turned out to conflict with required relation fields.
This kind of DTO represents the structure of input-data to expect from 'outside' (e.g. REST API consumer) when attempting to connect to a model through a relation field.
A Models ConnectDTO class is composed from a unique'd list of isId and isUnique scalar fields. If the ConnectDTO class has exactly one property, the property is marked as required. If there are more than one properties, all properties are optional (since setting a single one of them is already sufficient for a unique query) - you must however specify at least one property.
ConnectDTOs are used for relation fields in CreateDTOs and UpdateDTOs.
This kind of DTO represents the structure of input-data to expect from 'outside' (e.g. REST API consumer) when attempting to create a new instance of a Model.
Typically the requirements for database schema differ from what we want to allow users to do.
As an example (and this is the opinion represented in this generator), we don't think that relation scalar fields should be exposed to users for create, update, or delete activities (btw. TypeScript types generated in PrismaClient exclude these fields as well). If however, your schema defines a required relation, creating an entity of that Model would become quite difficult without the relation data.
In some cases you can derive information regarding related instances from context (e.g. HTTP path on the rest endpoint /api/post/:postid/comment to create a Comment with relation to a Post). For all other cases, we have the
@DtoRelationCanCreateOnCreate@DtoRelationCanConnectOnCreate@DtoRelationCanCreateOnUpdate@DtoRelationCanConnectOnUpdate
annotations that generate corresponding input properties on CreateDTO and UpdateDTO (optional or required - depending on the nature of the relation).
When generating a Models CreateDTO class, field that meet any of the following conditions are omitted (order matters):
isReadOnlyOR is annotated with@DtoReadOnly(Note: this apparently includes relation scalar fields)- field represents a relation (
field.kind === 'object') and is not annotated with@DtoRelationCanCreateOnCreateor@DtoRelationCanConnectOnCreate - field is a relation scalar
- field is not annotated with
@DtoCreateOptionalAND
When generating a Models UpdateDTO class, field that meet any of the following conditions are omitted (order matters):
- field is annotated with
@DtoUpdateOptional isReadOnlyOR is annotated with@DtoReadOnly(Note: this apparently includes relation scalar fields)isId(id fields are not supposed to be updated by the user)- field represents a relation (
field.kind === 'object') and is not annotated with@DtoRelationCanCreateOnUpdateor@DtoRelationCanConnectOnUpdate - field is a relation scalar
- field is not annotated with
@DtoUpdateOptionalAND
When generating a Models Entity class, only fields annotated with @DtoEntityHidden are omitted.
All other fields are only manipulated regarding their isRequired and isNullable flags.
By default, every scalar field in an entity is required meaning it doesn't get the TypeScript "optional member flag" ? next to it's name. Fields that are marked as optional in PrismaSchema are treated as nullable - meaning their TypeScript type is a union of field.type and null (e.g. string | null).
Relation and relation scalar fields are treated differently. If you don't specifically include a relation in your query, those fields will not exist in the response.
- every relation field is always optional (
isRequired = false) - relations are nullable except when
- the relation field is a one-to-many or many-to-many (i.e. list) type (would return empty array if no related records found)
- the relation was originally flagged as required (
isRequired = true) - the relation field is annotated with
@DtoRelationRequired(do this when you mark a relation as optional in PrismaSchema because you don't want (SQL)ON DELETE CASCADEbehavior - but your logical data schema sees this relation as required)
All files are released under the Apache License 2.0.