refactor: /presentations DTO 구현 및 API 연동 (#111)

src/api/client.ts

@@ -19,12 +19,21 @@ import { useAuthStore } from '@/stores/authStore';
 export const API_TIMEOUT_MS = 10000;
 
 /**
- * API 에러 응답 타입
+ * API 에러 응답 타입 (FAILURE 응답의 error 필드)
  */
-export interface ApiError {
-  message: string;
-  code?: string;
-  status?: number;
+export interface ApiErrorResponse {
+  errorCode: string;
+  reason: string;
+  data?: unknown;
+}
+
+/**
+ * API FAILURE 응답 구조
+ */
+export interface ApiFailureResponse {
+  resultType: 'FAILURE';
+  error: ApiErrorResponse;
+  success: null;
 }
 
 /**
@@ -69,14 +78,15 @@ apiClient.interceptors.request.use(
  */
 apiClient.interceptors.response.use(
   (response) => response,
-  (error: AxiosError<ApiError>) => {
+  (error: AxiosError<ApiFailureResponse>) => {
     const status = error.response?.status;
-    const message = error.response?.data?.message || '알 수 없는 오류가 발생했습니다';
+    const errorData = error.response?.data?.error;
+    const reason = errorData?.reason || '알 수 없는 오류가 발생했습니다';
 
     // [하이브리드 전략]
     // 시스템 에러 (401 인증, 500 서버 장애)는 Axios가 즉시 처리
     if (status === 401 || (status && status >= 500)) {
-      handleApiError(status, message);
+      handleApiError(status, reason);
       // 다운스트림(React Query 등)에서 중복 처리하지 않도록 플래그 설정
       error.isHandled = true;
     }

src/api/dto/analytics.dto.ts

@@ -0,0 +1,6 @@
+/**
+ * 대본 복원 요청 DTO
+ */
+export interface RestoreScriptRequestDto {
+  version: number;
+}

src/api/dto/auth.dto.ts

@@ -0,0 +1,30 @@
+/**
+ * 인증 관련 DTO
+ */
+
+/**
+ * 소셜 로그인 성공 응답의 사용자 정보
+ */
+export interface SocialLoginUserDto {
+  id: string;
+  email: string;
+  name: string;
+  sessionId: string;
+}
+
+/**
+ * 소셜 로그인 성공 응답의 토큰 정보
+ */
+export interface SocialLoginTokensDto {
+  accessToken: string;
+  refreshToken: string;
+}
+
+/**
+ * 소셜 로그인 성공 응답
+ */
+export interface SocialLoginSuccessDto {
+  message: string;
+  user: SocialLoginUserDto;
+  tokens: SocialLoginTokensDto;
+}

src/api/dto/index.ts

@@ -0,0 +1,11 @@
+/**
+ * @file index.ts
+ * @description DTO 배럴 export
+ */
+
+export type { SocialLoginSuccessDto, SocialLoginTokensDto, SocialLoginUserDto } from './auth.dto';
+export type { CreateProjectDto, UpdateProjectDto } from './projects.dto';
+export type { CreateSlideDto, UpdateSlideDto } from './slides.dto';
+export type { UpdateScriptDto, RestoreScriptDto } from './scripts.dto';
+export type { CreateOpinionDto } from './opinions.dto';
+export type { ToggleSlideReactionDto } from './reactions.dto';

src/api/dto/reactions.dto.ts

@@ -0,0 +1,8 @@
+import type { ReactionType } from '@/types/script';
+
+/**
+ * 슬라이드 리액션 토글 요청 DTO
+ */
+export interface ToggleSlideReactionDto {
+  type: ReactionType;
+}

src/api/dto/scripts.dto.ts

@@ -0,0 +1,39 @@
+/**
+ * 대본 저장 및 수정 DTO
+ */
+export interface UpdateScriptRequestDto {
+  script: string;
+}
+/**
+ * 대본 조회 DTO
+ */
+export interface GetScriptResponseDto {
+  message: string;
+  slideId: string;
+  charCount: number;
+  scriptText: string;
+  estimatedDurationSeconds: number;
+  createdAt: string;
+  updatedAt: string;
+}
+/**
+ * 대본 버전 히스토리 목록 조회 DTO
+ */
+export interface GetScriptVersionHistoryResponseDto {
+  versionNumber: number;
+  scriptText: string;
+  charCount: number;
+  createdAt: string;
+}
+/**
+ * 특정 버전으로 대본 복원 DTO
+ */
+export interface RestoreScriptResponseDto {
+  message: string;
+  slideId: string;
+  charCount: number;
+  scriptText: string;
+  estimatedDurationSeconds: number;
+  createdAt: string;
+  updatedAt: string;
+}

src/api/dto/slides.dto.ts

@@ -0,0 +1,33 @@
+/**
+ * 슬라이드 목록 조회 DTO
+ */
+export interface CreateSlideResponseDto {
+  slideId: string;
+  projectId: string;
+  title: string;
+  slideNum: number;
+  imageUrl: string;
+  createdAt: string;
+  updatedAt: string;
+}
+
+/**
+ * 슬라이드 제목 수정 요청 DTO
+ */
+export interface UpdateSlideTitleRequestDto {
+  title?: string;
+}
+
+/**
+ * 슬라이드 상세 조회 DTO
+ */
+export interface GetSlideResponseDto {
+  slideId: string;
+  projectId: string;
+  title: string;
+  slideNum: number;
+  imageUrl: string;
+  prevSlideId: string | null;
+  nextSlideId: string | null;
+  updatedAt: string;
+}

src/api/dto/video.dto.ts

@@ -0,0 +1,65 @@
+/**
+ * 영상 타임스탬프 댓글 생성
+ */
+export interface CreateOpinionDto {
+  content: string;
+  /** 답글인 경우 부모 의견 내용 고쳐라이D */
+  parentId?: string;
+}
+
+/**
+ * 영상 녹화 관련 DTO 정의
+ */
+export interface StartVideoRequest {
+  projectId: number;
+  title: string;
+}
+
+export interface StartVideoResponse {
+  resultType: 'SUCCESS' | 'FAILURE';
+  error: null | {
+    errorCode: string;
+    reason: string;
+    data?: unknown;
+  };
+  success: {
+    videoId: number;
+  };
+}
+
+export interface FinishVideoRequest {
+  slideLogs: Array<{
+    slideId: number;
+    timestampMs: number;
+  }>;
+}
+
+export interface FinishVideoResponse {
+  resultType: 'SUCCESS' | 'FAILURE';
+  error: null | {
+    errorCode: string;
+    reason: string;
+    data?: unknown;
+  };
+  success: {
+    videoId: string;
+    status: string;
+    slideCount: number;
+    slideDurations: Array<{
+      slideId: string;
+      totalDurationMs: number;
+    }>;
+  };
+}
+
+export interface ChunkUploadResponse {
+  resultType: 'SUCCESS' | 'FAILURE';
+  error: null | {
+    errorCode: string;
+    reason: string;
+    data?: unknown;
+  };
+  success: {
+    ok: boolean;
+  };
+}

src/api/endpoints/analytics.ts

@@ -18,18 +18,7 @@ export async function getSummaryAnalytics(projectId: string): Promise<SummaryAna
   );
 
   if (response.data.resultType === 'FAILURE') {
-    // 1. reason이 객체인지 문자열인지 확인해서 처리
-    const reason = response.data.reason;
-    let errorMessage = '분석 요약 조회에 실패했습니다.';
-
-    if (typeof reason === 'string') {
-      errorMessage = reason; // 문자열이면 그대로 사용
-    } else if (reason && typeof reason === 'object') {
-      errorMessage = reason.message || errorMessage; // 객체면 .message 추출
-    }
-
-    // 2. 이제 errorMessage는 무조건 string이므로 에러가 사라집니다.
-    throw new Error(errorMessage);
+    throw new Error(response.data.error.reason);
   }
 
   // success가 없으면 에러 처리 (옵셔널 체이닝 문제 방지)

src/api/endpoints/auth.ts

@@ -0,0 +1,68 @@
+/**
+ * @file auth.ts
+ * @description 인증 관련 API 엔드포인트
+ */
+import { apiClient } from '@/api';
+import type { SocialLoginSuccessDto } from '@/api/dto';
+import type { ApiResponse } from '@/types/api';
+
+/**
+ * Google OAuth 콜백 처리
+ *
+ * @param code - OAuth 인증 코드
+ * @returns 로그인 성공 정보 (user, tokens)
+ *
+ * @example
+ * const result = await getGoogleCallback('authorization-code');
+ */
+export async function getGoogleCallback(code: string): Promise<SocialLoginSuccessDto> {
+  const response = await apiClient.get<ApiResponse<SocialLoginSuccessDto>>(
+    `/auth/google/callback`,
+    { params: { code } },
+  );
+
+  if (response.data.resultType === 'SUCCESS') {
+    return response.data.success;
+  }
+  throw new Error(response.data.error.reason);
+}
+
+/**
+ * Kakao OAuth 콜백 처리
+ *
+ * @param code - OAuth 인증 코드
+ * @returns 로그인 성공 정보 (user, tokens)
+ *
+ * @example
+ * const result = await getKakaoCallback('authorization-code');
+ */
+export async function getKakaoCallback(code: string): Promise<SocialLoginSuccessDto> {
+  const response = await apiClient.get<ApiResponse<SocialLoginSuccessDto>>(`/auth/kakao/callback`, {
+    params: { code },
+  });
+
+  if (response.data.resultType === 'SUCCESS') {
+    return response.data.success;
+  }
+  throw new Error(response.data.error.reason);
+}
+
+/**
+ * Naver OAuth 콜백 처리
+ *
+ * @param code - OAuth 인증 코드
+ * @returns 로그인 성공 정보 (user, tokens)
+ *
+ * @example
+ * const result = await getNaverCallback('authorization-code');
+ */
+export async function getNaverCallback(code: string): Promise<SocialLoginSuccessDto> {
+  const response = await apiClient.get<ApiResponse<SocialLoginSuccessDto>>(`/auth/naver/callback`, {
+    params: { code },
+  });
+
+  if (response.data.resultType === 'SUCCESS') {
+    return response.data.success;
+  }
+  throw new Error(response.data.error.reason);
+}