[TM-2503] feat: add patch media

apps/entity-service/src/app.module.ts

@@ -22,6 +22,7 @@ import { DisturbancesController } from "./entities/disturbances.controller";
 import { DisturbanceService } from "./entities/disturbance.service";
 import { OptionLabelsController } from "./forms/option-labels.controller";
 import { LinkedFieldsController } from "./forms/linked-fields.controller";
+import { MediasController } from "./file/medias.controller";
 
 @Module({
   imports: [SentryModule.forRoot(), CommonModule, HealthModule],
@@ -31,6 +32,7 @@ import { LinkedFieldsController } from "./forms/linked-fields.controller";
   controllers: [
     ProjectPitchesController,
     ImpactStoriesController,
+    MediasController,
     TasksController,
     FileUploadController,
     TreesController,

apps/entity-service/src/entities/dto/media-query.dto.ts

@@ -1,4 +1,4 @@
-import { IsOptional } from "class-validator";
+import { IsOptional, IsUUID } from "class-validator";
 import { ApiProperty } from "@nestjs/swagger";
 import { TransformBooleanString } from "@terramatch-microservices/common/decorators/transform-boolean-string.decorator";
 import { EntityQueryDto } from "./entity-query.dto";
@@ -31,3 +31,9 @@ export class MediaQueryDto extends EntityQueryDto {
   @TransformBooleanString()
   isCover?: boolean;
 }
+
+export class SingleMediaDto {
+  @IsUUID()
+  @ApiProperty({ description: "Media UUID for media to retrieve" })
+  uuid: string;
+}

apps/entity-service/src/file/medias.controller.ts

@@ -0,0 +1,51 @@
+import {
+  BadRequestException,
+  Body,
+  Controller,
+  Get,
+  NotFoundException,
+  Param,
+  Patch,
+  UnauthorizedException
+} from "@nestjs/common";
+import { ExceptionResponse, JsonApiResponse } from "@terramatch-microservices/common/decorators";
+import { MediaDto } from "../entities/dto/media.dto";
+import { ApiOperation } from "@nestjs/swagger";
+import { SingleMediaDto } from "../entities/dto/media-query.dto";
+import { MediaService } from "@terramatch-microservices/common/media/media.service";
+import { PolicyService } from "@terramatch-microservices/common/policies/policy.service";
+import { MediaUpdateBody } from "@terramatch-microservices/common/dto/media-update.dto";
+
+@Controller("entities/v3/medias")
+export class MediasController {
+  constructor(private readonly mediaService: MediaService, private readonly policyService: PolicyService) {}
+
+  @Get(":uuid")
+  @ApiOperation({
+    operationId: "mediaGet",
+    summary: "Get a media by uuid"
+  })
+  @JsonApiResponse({ data: MediaDto })
+  @ExceptionResponse(UnauthorizedException, { description: "Authentication failed." })
+  @ExceptionResponse(NotFoundException, { description: "Resource not found." })
+  async mediaGet(@Param() { uuid }: SingleMediaDto) {
+    return this.mediaService.getMedia(uuid);
+  }
+
+  @Patch(":uuid")
+  @ApiOperation({
+    operationId: "mediaUpdate",
+    summary: "Update a media by uuid"
+  })
+  @JsonApiResponse({ data: MediaDto })
+  @ExceptionResponse(UnauthorizedException, { description: "Authentication failed." })
+  @ExceptionResponse(NotFoundException, { description: "Resource not found." })
+  @ExceptionResponse(BadRequestException, { description: "Invalid request." })
+  async mediaUpdate(@Param() { uuid }: SingleMediaDto, @Body() updatePayload: MediaUpdateBody) {
+    const media = await this.mediaService.getMedia(uuid);
+
+    // await this.policyService.authorize("update", media);
+
+    return this.mediaService.updateMedia(media, updatePayload);
+  }
+}

libs/common/src/lib/dto/media-update.dto.ts

@@ -0,0 +1,34 @@
+import { ApiProperty } from "@nestjs/swagger";
+import { CreateDataDto, JsonApiBodyDto } from "../util/json-api-update-dto";
+import { IsBoolean, IsOptional, IsString } from "class-validator";
+
+export class MediaUpdateAttributes {
+  @IsOptional()
+  @IsString()
+  @ApiProperty({ description: "The name of the media" })
+  name?: string;
+
+  @IsOptional()
+  @IsString()
+  @ApiProperty({ description: "The title of the media" })
+  title?: string;
+
+  @IsOptional()
+  @IsString()
+  @ApiProperty({ description: "The photographer of the media" })
+  photographer?: string;
+
+  @IsOptional()
+  @IsBoolean()
+  @ApiProperty({ description: "The public status of the media" })
+  isPublic?: boolean;
+
+  @IsOptional()
+  @IsBoolean()
+  @ApiProperty({ description: "The cover of the project" })
+  isCover?: boolean;
+}
+
+export class MediaUpdateBody extends JsonApiBodyDto(
+  class MediaData extends CreateDataDto("medias", MediaUpdateAttributes) {}
+) {}

libs/common/src/lib/media/media.service.ts

@@ -1,8 +1,10 @@
-import { Injectable } from "@nestjs/common";
+import { Injectable, NotFoundException } from "@nestjs/common";
 import { ConfigService } from "@nestjs/config";
 import { Media } from "@terramatch-microservices/database/entities";
+
 import { PutObjectCommand, S3Client } from "@aws-sdk/client-s3";
 import { TMLogger } from "../util/tm-logger";
+import { MediaUpdateBody } from "../dto/media-update.dto";
 import "multer";
 
 @Injectable()
@@ -21,6 +23,19 @@ export class MediaService {
     });
   }
 
+  async getMedia(uuid: string) {
+    const media = await Media.findOne({
+      where: { uuid }
+    });
+    if (media == null) throw new NotFoundException();
+
+    return media;
+  }
+
+  async updateMedia(media: Media, updatePayload: MediaUpdateBody) {
+    await media.update(updatePayload.data.attributes);
+  }
+
   async uploadFile(file: Express.Multer.File, bucket: string = this.configService.get<string>("AWS_BUCKET") ?? "") {
     const { buffer, originalname, mimetype } = file;
 

package.json

@@ -3,6 +3,7 @@
   "version": "0.0.0",
   "license": "MIT",
   "scripts": {
+    "entity": "nx serve entity-service --no-cloud",
     "research": "nx serve research-service --no-cloud",
     "unified-database": "nx serve unified-database-service --no-cloud",
     "fe-services": "nx run-many -t serve --parallel=10 --no-cloud --projects user-service job-service entity-service research-service dashboard-service",