feat: add the support feature to the passenger api

apps/edr-passenger-api/src/modules/support/support.dto.ts

@@ -0,0 +1,127 @@
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { Type } from 'class-transformer';
+import {
+  IsEmail,
+  IsEnum,
+  IsInt,
+  IsOptional,
+  IsString,
+  Length,
+  Max,
+  MaxLength,
+  Min,
+  MinLength,
+} from 'class-validator';
+
+export enum SupportStatusDto {
+  OPEN = 'OPEN',
+  RESOLVED = 'RESOLVED',
+  CLOSED = 'CLOSED',
+}
+
+export class CreateConversationDto {
+  @ApiProperty({ description: 'Short subject / topic of the request.' })
+  @IsString()
+  @Length(3, 200)
+  subject!: string;
+
+  @ApiProperty({ description: 'The first message body.' })
+  @IsString()
+  @MinLength(1)
+  @MaxLength(4000)
+  initialMessage!: string;
+}
+
+export class SendMessageDto {
+  @ApiProperty({ description: 'Message text.' })
+  @IsString()
+  @MinLength(1)
+  @MaxLength(4000)
+  text!: string;
+}
+
+export class CreateGuestConversationDto {
+  @ApiProperty({ description: 'Client-generated anonymous id (localStorage).' })
+  @IsString()
+  @Length(8, 120)
+  guestId!: string;
+
+  @ApiProperty({ description: 'Guest full name.' })
+  @IsString()
+  @Length(1, 120)
+  name!: string;
+
+  @ApiProperty({ description: 'Guest email for follow-up.' })
+  @IsEmail()
+  email!: string;
+
+  @ApiPropertyOptional({ description: 'Guest phone (optional).' })
+  @IsOptional()
+  @IsString()
+  @MaxLength(40)
+  phone?: string;
+
+  @ApiProperty()
+  @IsString()
+  @Length(3, 200)
+  subject!: string;
+
+  @ApiProperty()
+  @IsString()
+  @MinLength(1)
+  @MaxLength(4000)
+  initialMessage!: string;
+}
+
+export class GuestSendMessageDto {
+  @ApiProperty({ description: 'The guest id that owns the conversation.' })
+  @IsString()
+  @Length(8, 120)
+  guestId!: string;
+
+  @ApiProperty({ description: 'Message text.' })
+  @IsString()
+  @MinLength(1)
+  @MaxLength(4000)
+  text!: string;
+}
+
+export class GuestIdBodyDto {
+  @ApiProperty()
+  @IsString()
+  @Length(8, 120)
+  guestId!: string;
+}
+
+export class UpdateStatusDto {
+  @ApiProperty({ enum: SupportStatusDto })
+  @IsEnum(SupportStatusDto)
+  status!: SupportStatusDto;
+}
+
+export class ListConversationsQueryDto {
+  @ApiPropertyOptional({ enum: SupportStatusDto })
+  @IsOptional()
+  @IsEnum(SupportStatusDto)
+  status?: SupportStatusDto;
+
+  @ApiPropertyOptional({ description: 'Search subject / passenger name.' })
+  @IsOptional()
+  @IsString()
+  search?: string;
+
+  @ApiPropertyOptional({ minimum: 1, default: 1 })
+  @IsOptional()
+  @Type(() => Number)
+  @IsInt()
+  @Min(1)
+  page?: number;
+
+  @ApiPropertyOptional({ minimum: 1, maximum: 100, default: 100 })
+  @IsOptional()
+  @Type(() => Number)
+  @IsInt()
+  @Min(1)
+  @Max(100)
+  limit?: number;
+}