[FEATURE] 영화 필터 API 라우트 추가

apps/web/pages/api/filter/movie.ts

@@ -0,0 +1,41 @@
+import { tmdbHttpServer, withCommonRoute } from "@/shared/api";
+import { camelCaseObjMapper } from "@/shared/lib";
+
+import {
+  FilteredMovieList,
+  filteredMovieListQuerySchema,
+  SFilteredMovieListReqParams,
+} from "../../../src/entities/filter";
+
+export default withCommonRoute(
+  async (req, res) => {
+    const queries = req.query as unknown as SFilteredMovieListReqParams;
+
+    const result = await tmdbHttpServer.get<FilteredMovieList>("discover/movie", {
+      params: {
+        certification_country: queries.certificationCountry,
+        include_adult: queries.includeAdult,
+        include_video: queries.includeVideo,
+        language: queries.language,
+        page: queries.page,
+        "release_date.gte": queries.releaseDateGte,
+        "release_date.lte": queries.releaseDateLte,
+        sort_by: queries.sortBy,
+        "vote_average.gte": queries.voteAverageGte,
+        "vote_average.lte": queries.voteAverageLte,
+        "vote_count.gte": queries.voteCountGte,
+        "vote_count.lte": queries.voteCountLte,
+        watch_region: queries.watchRegion,
+        with_genre: queries.withGenre,
+        with_release_type: queries.withReleaseType && queries.withReleaseType.join("|"),
+        "with_run_time.gte": queries.withRunTimeGte,
+        "with_run_time.lte": queries.withRunTimeLte,
+      },
+    });
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore
+    return res.status(200).send(camelCaseObjMapper(result.data));
+  },
+  ["GET"],
+  filteredMovieListQuerySchema,
+);

apps/web/src/entities/filter/api/filter-api.ts

@@ -0,0 +1,24 @@
+import { AxiosRequestConfig } from "axios";
+
+import { FilteredMovieListDTO } from "@/entities/filter";
+import { FilteredMovieListReqParams } from "@/entities/filter/api/request-types/movie";
+import { localHttp } from "@/shared/api";
+
+const discoverBaseURL = "filter";
+
+export default class FilterApi {
+  /**
+   * 영화 필터
+   */
+  static async getFilterMovies(
+    args: FilteredMovieListReqParams,
+    axiosRequestConfig?: AxiosRequestConfig,
+  ): Promise<FilteredMovieListDTO> {
+    return localHttp
+      .get(`${discoverBaseURL}/movie`, {
+        params: args,
+        ...axiosRequestConfig,
+      })
+      .then((res) => res.data);
+  }
+}

apps/web/src/entities/filter/api/index.ts

@@ -0,0 +1,3 @@
+export * from "./request-types";
+export * from "./response-types";
+export * from "./filter-api";

apps/web/src/entities/filter/api/queries/index.ts

@@ -0,0 +1,2 @@
+export * from "./query-keys";
+export * from "./use-filtered-movie-list";

apps/web/src/entities/filter/api/queries/query-keys.ts

@@ -0,0 +1,6 @@
+import { FilteredMovieListReqParams } from "@/entities/filter/api/request-types/movie";
+
+export const filteredMediaListQueryKeys = {
+  all: ["filter"] as const,
+  filteredMovieList: (args: FilteredMovieListReqParams) => ["filtered-movie-list", { ...args }] as const,
+};

apps/web/src/entities/filter/api/queries/use-filtered-movie-list.ts

@@ -0,0 +1,24 @@
+import { useQuery } from "@tanstack/react-query";
+
+import FilterApi from "@/entities/filter/api/filter-api";
+import { filteredMediaListQueryKeys } from "@/entities/filter/api/queries/query-keys";
+import { FilteredMovieListReqParams } from "@/entities/filter/api/request-types/movie";
+import FilteredMovieListModel from "@/entities/filter/model/filtered-movie-list";
+
+export const useFilteredMovieList = (args: FilteredMovieListReqParams = {}) => {
+  const { page = 1, watchRegion = "KR", certificationCountry = "KR", language = "ko-KR", ...restArgs } = args;
+
+  const reqArgs = {
+    page,
+    watchRegion,
+    certificationCountry,
+    language,
+    ...restArgs,
+  };
+
+  return useQuery({
+    queryKey: [...filteredMediaListQueryKeys.all, ...filteredMediaListQueryKeys.filteredMovieList(reqArgs)],
+    queryFn: () => FilterApi.getFilterMovies(reqArgs),
+    select: (data) => new FilteredMovieListModel(data),
+  });
+};

apps/web/src/entities/filter/api/request-types/index.ts

@@ -0,0 +1 @@
+export * from "./movie.server";

apps/web/src/entities/filter/api/request-types/movie.server.ts

@@ -0,0 +1,49 @@
+import { z } from "zod";
+
+export const filteredMovieListQuerySchema = z.object({
+  certificationCountry: z.string().optional(),
+  includeAdult: z.coerce.boolean().optional(),
+  includeVideo: z.coerce.boolean().optional(),
+  language: z.string().optional(),
+  page: z.coerce.number().optional(),
+  releaseDateGte: z.coerce.date().optional(),
+  releaseDateLte: z.coerce.date().optional(),
+  sortBy: z
+    .enum([
+      "original_title.asc",
+      "original_title_desc",
+      "popularity.asc",
+      "popularity.desc",
+      "title.asc",
+      "title.desc",
+      "vote_average.asc",
+      "vote_average.desc",
+      "vote_count.asc",
+      "vote_count.desc",
+    ])
+    .optional(),
+  voteAverageGte: z.coerce.number().optional(),
+  voteAverageLte: z.coerce.number().optional(),
+  voteCountGte: z.coerce.number().optional(),
+  voteCountLte: z.coerce.number().optional(),
+  watchRegion: z.string().optional(),
+  withGenre: z.string().optional(),
+  withReleaseType: z.enum(["1", "2", "3", "4", "5"]).array().optional(),
+  withRunTimeGte: z.coerce.number().optional(),
+  withRunTimeLte: z.coerce.number().optional(),
+});
+
+/**
+ * ```
+ * voteAverage - 사용자 점수
+ * voteCount - 투표수
+ * withReleaseType
+ * 1 - Premiere
+ * 2 - Theatrical (limited)
+ * 3 - Theatrical
+ * 4 - Digital
+ * 5 - Physical
+ * 6 - TV
+ * ```
+ */
+export type SFilteredMovieListReqParams = z.infer<typeof filteredMovieListQuerySchema>;

apps/web/src/entities/filter/api/request-types/movie.ts

@@ -0,0 +1,3 @@
+import { SFilteredMovieListReqParams } from "../.";
+
+export interface FilteredMovieListReqParams extends SFilteredMovieListReqParams {}

apps/web/src/entities/filter/api/response-types/index.ts

@@ -0,0 +1,5 @@
+// server
+export * from "./movie.server";
+
+// client
+export * from "./movie";

apps/web/src/entities/filter/api/response-types/movie.server.ts

@@ -0,0 +1,3 @@
+import { MovieList } from "@/entities/movie-list/api/response-types/movie-list.server";
+
+export interface FilteredMovieList extends MovieList {}

apps/web/src/entities/filter/api/response-types/movie.ts

@@ -0,0 +1,3 @@
+import { MovieListDTO } from "@/entities/movie-list";
+
+export interface FilteredMovieListDTO extends MovieListDTO {}

apps/web/src/entities/filter/index.ts

@@ -0,0 +1,2 @@
+export * from "./api";
+export * from "./model";

apps/web/src/entities/filter/model/filtered-movie-list.ts

@@ -0,0 +1,7 @@
+import { MovieListDTO, MovieListModel } from "@/entities/movie-list";
+
+export default class FilteredMovieListModel extends MovieListModel {
+  constructor(data: MovieListDTO) {
+    super(data);
+  }
+}