📦 DTOs and Pagination

The DTOs are intended for app-level controllers. They include Swagger metadata and class-validator/class-transformer decorators where runtime validation is meaningful.

📄 PageOptionsDTO

PageOptionsDTO defaults to page = 1 and perPage = 10. Both values are transformed to numbers and validated as integers.

import { ValidationPipe } from '@nestjs/common';

app.useGlobalPipes(
  new ValidationPipe({
    transform: true,
    whitelist: true,
  }),
);

import { QueryDTO } from '@querry-kit/nest-prisma-query';

@Get()
async query(@Query() query: QueryDTO<ProjectTypeMap>) {
  const { items, pageMeta } = await this.projectsService.query(query);
  return new PaginatedDTO(items.map(ProjectDTO.fromModel), pageMeta);
}

The supported pagination range is:

page >= 1
perPage >= 1
perPage <= 1000

🧾 Query DTOs

Use the DTO matching the service method:

FindOneDTO<ProjectTypeMap>
FindManyDTO<ProjectTypeMap>
FindByIdDTO<ProjectTypeMap>
FindUniqueDTO<ProjectTypeMap>
AggregateDTO<ProjectTypeMap>
CountDTO<ProjectTypeMap>
QueryDTO<ProjectTypeMap>

QueryDTO and FindByIdDTO expose fields?: string for controller-level integration with @querry-kit/nest-fields-query. This package does not derive select or include from fields.

📬 Response Shape

QueryService.query returns a service-level shape:

type Paginated<Project> = {
  items: Project[];
  itemCount: number;
  pageMeta: PageMetaDTO;
};

Controllers usually convert it to the public DTO shape:

const { items, pageMeta } = await this.projectsService.query<Project>(query);

return new PaginatedDTO(items.map(ProjectDTO.fromModel), pageMeta);

PageMetaDTO computes pageCount, hasPrevPage, and hasNextPage from itemCount, page, and perPage.