feat(season): add support for versioned season DTOs

- Delete `SeasonDocsResponseDto` in `src/season/dto/season-docs.response.dto.ts`
- Add `SeasonDocsResponseDtoV1` in `src/season/dto/v1/season-docs.response.dto.ts`
- Add `SeasonV1` and `EpisodeV1` in `src/season/dto/v1/season.dto.ts`
- Add `SeasonDocsResponseDtoV1_4` in `src/season/dto/v1.4/season-docs.response.dto.ts`
- Add `SeasonV1_4` and `EpisodeV1_4` in `src/season/dto/v1.4/season.dto.ts`

The changes introduce versioned DTOs for seasons, allowing for more flexibility and compatibility with different API versions.

Author: mdwitr0

src/season/dto/season-docs.response.dto.ts

@@ -0,0 +1,9 @@
+import { AbstractDocsResponseDto } from '../../../common/dto/abstract/abstract-docs.response.dto';
+import { SeasonV1_4 } from './season.dto';
+
+export class SeasonDocsResponseDtoV1_4 extends AbstractDocsResponseDto(SeasonV1_4) {
+  constructor(partial: Partial<SeasonDocsResponseDtoV1_4>) {
+    super(partial);
+    Object.assign(this, partial);
+  }
+}

src/season/dto/v1.4/season-docs.response.dto.ts

@@ -0,0 +1,56 @@
+import { ApiPropertyOptional } from '@nestjs/swagger';
+import { ShortImage } from '../../../movie/schemas/movie.schema';
+import { EpisodeV1, SeasonV1 } from '../v1/season.dto';
+import { Expose } from 'class-transformer';
+
+export class EpisodeV1_4 extends EpisodeV1 {
+  @Expose()
+  @ApiPropertyOptional({ type: () => ShortImage })
+  still: ShortImage;
+
+  @Expose()
+  @ApiPropertyOptional()
+  airDate?: string;
+
+  @Expose()
+  @ApiPropertyOptional({ deprecated: true })
+  date?: string;
+
+  @Expose()
+  @ApiPropertyOptional()
+  enDescription?: string;
+}
+
+export class SeasonV1_4 extends SeasonV1 {
+  @Expose()
+  @ApiPropertyOptional({ type: () => ShortImage })
+  poster?: ShortImage;
+
+  @Expose()
+  @ApiPropertyOptional()
+  name?: string;
+
+  @Expose()
+  @ApiPropertyOptional()
+  enName?: string;
+
+  @Expose()
+  @ApiPropertyOptional()
+  duration?: number;
+
+  @Expose()
+  @ApiPropertyOptional()
+  description?: string;
+
+  @Expose()
+  @ApiPropertyOptional()
+  enDescription?: string;
+
+  @Expose()
+  @ApiPropertyOptional()
+  airDate?: string;
+
+  @Expose()
+  @ApiPropertyOptional({ type: () => EpisodeV1_4, isArray: true })
+  episodes: EpisodeV1_4[];
+}

src/season/dto/v1.4/season.dto.ts

@@ -0,0 +1,9 @@
+import { AbstractDocsResponseDto } from '../../../common/dto/abstract/abstract-docs.response.dto';
+import { SeasonV1 } from './season.dto';
+
+export class SeasonDocsResponseDtoV1 extends AbstractDocsResponseDto(SeasonV1) {
+  constructor(partial: Partial<SeasonDocsResponseDtoV1>) {
+    super(partial);
+    Object.assign(this, partial);
+  }
+}

src/season/dto/v1/season-docs.response.dto.ts

@@ -0,0 +1,32 @@
+import { ApiPropertyOptional } from '@nestjs/swagger';
+
+export class EpisodeV1 {
+  @ApiPropertyOptional()
+  number?: number;
+
+  @ApiPropertyOptional()
+  name?: string;
+
+  @ApiPropertyOptional()
+  enName?: string;
+
+  @ApiPropertyOptional({ deprecated: true })
+  date?: string;
+
+  @ApiPropertyOptional()
+  description?: string;
+}
+
+export class SeasonV1 {
+  @ApiPropertyOptional()
+  movieId: number;
+
+  @ApiPropertyOptional()
+  number?: number;
+
+  @ApiPropertyOptional()
+  episodesCount?: number;
+
+  @ApiPropertyOptional({ type: () => EpisodeV1, isArray: true })
+  episodes: EpisodeV1[];
+}