[MERGE] main -> staging post EE release

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

@@ -8,17 +8,20 @@ import { EntitiesService } from "./entities/entities.service";
 import { EntitiesController } from "./entities/entities.controller";
 import { EntityAssociationsController } from "./entities/entity-associations.controller";
 import { HealthModule } from "@terramatch-microservices/common/health/health.module";
+import { ProjectPitchesController } from "./entities/project-pitches.controller";
+import { ProjectPitchService } from "./entities/project-pitch.service";
 
 @Module({
   imports: [SentryModule.forRoot(), CommonModule, HealthModule],
-  controllers: [EntitiesController, EntityAssociationsController, TreesController],
+  controllers: [ProjectPitchesController, EntitiesController, EntityAssociationsController, TreesController],
   providers: [
     {
       provide: APP_FILTER,
       useClass: SentryGlobalFilter
     },
     EntitiesService,
-    TreeService
+    TreeService,
+    ProjectPitchService
   ]
 })
 export class AppModule {}

apps/entity-service/src/entities/dto/project-pitch-param.dto.ts

@@ -0,0 +1,6 @@
+import { ApiProperty } from "@nestjs/swagger";
+
+export class ProjectPitchParamDto {
+  @ApiProperty({ description: "Entity UUID for association" })
+  uuid: string;
+}

apps/entity-service/src/entities/dto/project-pitch-query.dto.ts

@@ -0,0 +1,39 @@
+import { ApiProperty, IntersectionType } from "@nestjs/swagger";
+import { IsEnum, IsOptional, ValidateNested } from "class-validator";
+import { NumberPage } from "@terramatch-microservices/common/dto/page.dto";
+
+class QuerySort {
+  @ApiProperty({ name: "sort[field]", required: false })
+  @IsOptional()
+  field?: string;
+
+  @ApiProperty({ name: "sort[direction]", required: false, enum: ["ASC", "DESC"], default: "ASC" })
+  @IsEnum(["ASC", "DESC"])
+  @IsOptional()
+  direction?: "ASC" | "DESC";
+}
+
+class FilterItem {
+  [key: string]: string | undefined;
+}
+
+export class ProjectPitchQueryDto extends IntersectionType(QuerySort, NumberPage) {
+  @ValidateNested()
+  @IsOptional()
+  page?: NumberPage;
+
+  @ValidateNested()
+  @IsOptional()
+  sort?: QuerySort;
+
+  @ApiProperty({ required: false })
+  @IsOptional()
+  search?: string;
+
+  @ApiProperty({
+    required: false,
+    description: "Search query used for filtering selectable options in autocomplete fields."
+  })
+  @IsOptional()
+  filter?: FilterItem;
+}