feat: allow creating one or many participants

Author: openscript

apps/backend/src/research/participants/participants.controller.ts

@@ -1,13 +1,23 @@
 import { Body, Controller, Delete, Get, Param, Patch, Post } from "@nestjs/common";
 import { ParticipantsService } from "./participants.service";
-import { ApiNotFoundResponse, ApiOperation, ApiTags, ApiUnprocessableEntityResponse } from "@nestjs/swagger";
+import {
+  ApiBody,
+  ApiExtraModels,
+  ApiNotFoundResponse,
+  ApiOperation,
+  ApiTags,
+  ApiUnprocessableEntityResponse,
+  getSchemaPath,
+} from "@nestjs/swagger";
 import { ParticipantCreationDto, ParticipantMutationDto, ParticipantResponseDto } from "./participant.dto";
 import { ErrorResponseDto } from "../../common/dto/error.dto";
 import { Roles } from "../../system/users/roles.decorator";
 import { UserRole } from "../../system/users/user.entity";
 import { QuestionnairesService } from "../questionnaires/questionnaires.service";
+import { OneOrMany } from "../../types";
 
 @ApiTags("Participants")
+@ApiExtraModels(ParticipantCreationDto)
 @Controller("participants")
 export class ParticipantsController {
   constructor(
@@ -18,7 +28,27 @@ export class ParticipantsController {
   @Post()
   @ApiOperation({ summary: "Create a participant" })
   @ApiUnprocessableEntityResponse({ description: "Unique id constraint violation", type: ErrorResponseDto })
-  create(@Body() participant: ParticipantCreationDto): Promise<ParticipantResponseDto> {
+  @ApiBody({
+    schema: {
+      oneOf: [
+        { $ref: getSchemaPath(ParticipantCreationDto) },
+        {
+          type: "array",
+          items: { $ref: getSchemaPath(ParticipantCreationDto) },
+        },
+      ],
+    },
+    examples: {
+      single: { value: { id: 1, birthday: "2024-11-01T00:05:02.718Z" } },
+      multiple: {
+        value: [
+          { id: 1, birthday: "2024-11-01T00:05:02.718Z" },
+          { id: 2, birthday: "2024-11-01T00:05:02.718Z" },
+        ],
+      },
+    },
+  })
+  create(@Body() participant: OneOrMany<ParticipantCreationDto>): Promise<ParticipantResponseDto[]> {
     return this.participantService.create(participant);
   }
 

apps/backend/src/research/participants/participants.service.ts

@@ -3,6 +3,7 @@ import { Injectable, UnprocessableEntityException } from "@nestjs/common";
 import { EntityManager, EntityRepository, FilterQuery, UniqueConstraintViolationException } from "@mikro-orm/core";
 import { ParticipantCreationDto, ParticipantMutationDto } from "./participant.dto";
 import { Participant } from "./participant.entity";
+import { OneOrMany } from "../../types";
 
 @Injectable()
 export class ParticipantsService {
@@ -12,20 +13,25 @@ export class ParticipantsService {
     private readonly em: EntityManager
   ) {}
 
-  async create(participantCreationDto: ParticipantCreationDto) {
-    const participant = new Participant();
-    participant.birthday = participantCreationDto.birthday;
+  async create(participantCreationDto: OneOrMany<ParticipantCreationDto>) {
+    const participantDtos = Array.isArray(participantCreationDto) ? participantCreationDto : [participantCreationDto];
+    const participants = participantDtos.map((dto) => {
+      const participant = new Participant();
+      participant.id = dto.id;
+      participant.birthday = dto.birthday;
+      return participant;
+    });
 
     try {
-      await this.em.persist(participant).flush();
+      await this.em.persist(participants).flush();
     } catch (e) {
       if (e instanceof UniqueConstraintViolationException) {
         throw new UnprocessableEntityException("Participant with this id already exists");
       }
       throw e;
     }
 
-    return participant.toObject();
+    return participants.map((p) => p.toObject());
   }
 
   async findAll() {

apps/backend/src/types.d.ts

@@ -26,3 +26,5 @@ declare global {
       ? T[S]
       : never;
 }
+
+export type OneOrMany<T> = T | T[];

apps/frontend/src/api.gen.ts

@@ -619,7 +619,6 @@ export interface components {
              * @example 2024-11-01T00:05:02.718Z
              */
             birthday?: string;
-            latestQuestionnaire?: components["schemas"]["QuestionnaireListResponseDto"];
         };
         ParticipantResponseDto: {
             /**
@@ -1604,7 +1603,7 @@ export interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["ParticipantCreationDto"];
+                "application/json": components["schemas"]["ParticipantCreationDto"] | components["schemas"]["ParticipantCreationDto"][];
             };
         };
         responses: {
@@ -1613,7 +1612,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ParticipantResponseDto"];
+                    "application/json": components["schemas"]["ParticipantResponseDto"][];
                 };
             };
             /** @description Unique id constraint violation */