@ph-cms/client-sdk 0.1.32 → 0.1.35

package/README.md

@@ -1,4 +1,4 @@
-# @ph-cms/client-sdk 0.1.32
+# @ph-cms/client-sdk 0.1.35
 
 PH-CMS 클라이언트 SDK — 브라우저 및 React 애플리케이션을 위한 통합 클라이언트.
 
@@ -69,6 +69,8 @@ import type {
   CreateStampTourRequest,
   UpdateStampTourRequest,
   ListContentQuery,
+  ListLikersQuery,
+  ListLikedContentQuery,
   PagedContentListResponse,
 
   // Hierarchy / Policy
@@ -89,6 +91,7 @@ import type {
 
   // Common
   PagedResponse,
+  UserProfileDto,
 } from '@ph-cms/client-sdk';
 ```
 
@@ -664,6 +667,7 @@ function RegisterForm() {
       email: 'user@example.com',
       password: 'password123',
       display_name: '홍길동',
+      phone_number: '010-1234-5678', // 선택 사항
       termCodes: ['SERVICE_TERM', 'PRIVACY_TERM'], // 동의할 약관 코드 목록
       // channelUid는 PHCMSProvider에 설정된 값이 자동 사용됨
       // 명시적으로 지정하려면: channelUid: 'my-channel'
@@ -698,6 +702,7 @@ function FirebaseRegisterForm() {
       email: 'user@example.com',
       password: 'password123',
       display_name: '홍길동',
+      phone_number: '010-1234-5678', // 선택 사항
       termCodes: ['SERVICE_TERM', 'PRIVACY_TERM'],
       // channelUid는 PHCMSProvider에 설정된 값이 자동 사용됨
     });
@@ -1082,6 +1087,20 @@ const { data: status } = useLikeStatus('content-uid');
 console.log(status?.liked); // true or false
 ```
 
+### 좋아요 관련 목록 조회 (Public)
+
+특정 콘텐츠를 좋아하는 사용자 목록이나, 특정 사용자가 좋아하는 콘텐츠 목록을 조회할 수 있습니다.
+
+```ts
+// 1. 특정 콘텐츠에 좋아요를 누른 사용자 목록
+const likers = await client.content.getLikers('content-uid', { page: 1, limit: 10 });
+// => PagedResponse<UserProfileDto>
+
+// 2. 특정 사용자가 좋아요를 누른 콘텐츠 목록 (타입 필터링 지원)
+const likedContents = await client.user.getLikedContents('user-uid', { type: 'post', page: 1 });
+// => PagedContentListResponse
+```
+
 ## Stamp Tour
 
 스탬프 투어 기능을 사용하여 특정 지점(Marker) 방문을 인증하고 진행 현황을 조회하거나, 새로운 투어를 생성할 수 있습니다.
@@ -1495,7 +1514,8 @@ const result = await content.list({ channelUid: 'my-channel' });
 | 메서드 | 설명 |
 |---|---|
 | `getProfile(uid: string)` | 유저의 공개 프로필 정보 조회 → `UserProfileDto` |
-| `updateProfile(uid: string, data: UpdateUserProfileRequest)` | 유저의 프로필 정보 업데이트 (일반 유저는 `UpdateUserProfileRequest` 필드만 허용) → `UserDto` |
+| `updateProfile(uid: string, data: UpdateUserProfileRequest)` | 유저의 프로필 정보 업데이트 → `UserDto` |
+| `getLikedContents(uid: string, params?: Partial<ListLikedContentQuery>)` | 사용자가 좋아요 누른 콘텐츠 목록 조회 → `PagedContentListResponse` |
 
 ### `AuthModule` (`client.auth`)
 
@@ -1503,8 +1523,8 @@ const result = await content.list({ channelUid: 'my-channel' });
 |---|---|
 | `login(data: LoginRequest)` | 이메일/비밀번호 로그인 → `AuthResponse` |
 | `loginWithFirebase(data: FirebaseExchangeRequest)` | Firebase ID 토큰 교환 → `AuthResponse` |
-| `register(data: RegisterRequest)` | 이메일 회원가입 → `AuthResponse` (`channelUid` \| `channelSlug` 필수) |
-| `registerWithFirebase(data: FirebaseRegisterRequest)` | 서버 사이드 Firebase 회원가입 → `AuthResponse` (`channelUid` \| `channelSlug` 필수) |
+| `register(data: RegisterRequest)` | 이메일 회원가입 → `AuthResponse` (`channelUid` \| `channelSlug` 필수, `phone_number` 지원) |
+| `registerWithFirebase(data: FirebaseRegisterRequest)` | 서버 사이드 Firebase 회원가입 → `AuthResponse` (`channelUid` \| `channelSlug` 필수, `phone_number` 지원) |
 | `me(params?: { channelUid?: string })` | 현재 사용자 프로필 조회 → `UserDto` |
 | `refresh(refreshToken: string)` | 토큰 갱신 → `{ accessToken, refreshToken }` |
 | `logout()` | 로그아웃 (프로바이더 토큰 삭제 + 서버 세션 무효화) |
@@ -1525,6 +1545,7 @@ const result = await content.list({ channelUid: 'my-channel' });
 | `getTourStats(tourUid: string)` | 투어 전체 통계 조회 → `TourStatsDto` |
 | `toggleLike(uid: string)` | 좋아요 토글 → `ToggleLikeResponse` |
 | `getLikeStatus(uid: string)` | 내 좋아요 여부 확인 → `LikeStatusResponse` |
+| `getLikers(uid: string, params?: Partial<ListLikersQuery>)` | 콘텐츠에 좋아요 누른 사용자 목록 조회 → `PagedResponse<UserProfileDto>` |
 
 ### `ChannelModule` (`client.channel`)
 

package/dist/hooks/useContent.d.ts

@@ -5,7 +5,7 @@ export declare const contentKeys: {
     list: (params: ListContentQuery) => readonly ["contents", "list", {
         page: number;
         limit: number;
-        status?: string | undefined;
+        status?: "published" | "draft" | "private" | undefined;
         type?: string | undefined;
         channelUid?: string | undefined;
         channelSlug?: string | undefined;

package/dist/modules/content.d.ts

@@ -1,4 +1,4 @@
-import { CollectStampRequest, ContentDto, CreateContentRequest, CreateStampTourRequest, LikeStatusResponse, ListContentQuery, PagedContentListResponse, StampStatusDto, ToggleLikeResponse, TourStatsDto, UpdateContentRequest, UpdateStampTourRequest } from "@ph-cms/api-contract";
+import { CollectStampRequest, ContentDto, CreateContentRequest, CreateStampTourRequest, LikeStatusResponse, ListContentQuery, ListLikersQuery, PagedContentListResponse, PagedResponse, StampStatusDto, ToggleLikeResponse, TourStatsDto, UpdateContentRequest, UpdateStampTourRequest, UserProfileDto } from "@ph-cms/api-contract";
 import { AxiosInstance } from "axios";
 export declare class ContentModule {
     private client;
@@ -20,4 +20,5 @@ export declare class ContentModule {
     getTourStats(tourUid: string): Promise<TourStatsDto>;
     toggleLike(uid: string): Promise<ToggleLikeResponse>;
     getLikeStatus(uid: string): Promise<LikeStatusResponse>;
+    getLikers(uid: string, params?: Partial<ListLikersQuery>): Promise<PagedResponse<UserProfileDto>>;
 }

package/dist/modules/content.js

@@ -95,5 +95,14 @@ class ContentModule {
             throw new errors_1.ValidationError("UID is required", []);
         return this.client.get(`${this.prefix}/contents/${uid}/like`);
     }
+    async getLikers(uid, params = {}) {
+        if (!uid)
+            throw new errors_1.ValidationError("UID is required", []);
+        const validation = api_contract_1.ListLikersQuerySchema.safeParse(params);
+        if (!validation.success) {
+            throw new errors_1.ValidationError("Invalid list likers params", validation.error.errors);
+        }
+        return this.client.get(`${this.prefix}/contents/${uid}/likers`, { params });
+    }
 }
 exports.ContentModule = ContentModule;

package/dist/modules/user.d.ts

@@ -1,4 +1,4 @@
-import { UpdateUserProfileRequest, UserDto, UserProfileDto } from "@ph-cms/api-contract";
+import { ListLikedContentQuery, PagedContentListResponse, UpdateUserProfileRequest, UserDto, UserProfileDto } from "@ph-cms/api-contract";
 import { AxiosInstance } from "axios";
 export declare class UserModule {
     private client;
@@ -21,4 +21,11 @@ export declare class UserModule {
      * @param data - The update payload.
      */
     updateProfile(uid: string, data: UpdateUserProfileRequest | Record<string, any>): Promise<UserDto>;
+    /**
+     * Retrieves contents liked by a specific user.
+     *
+     * @param uid - The UID of the user.
+     * @param params - Query parameters for filtering and pagination.
+     */
+    getLikedContents(uid: string, params?: Partial<ListLikedContentQuery>): Promise<PagedContentListResponse>;
 }

package/dist/modules/user.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UserModule = void 0;
+const api_contract_1 = require("@ph-cms/api-contract");
+const errors_1 = require("../errors");
 class UserModule {
     constructor(client, prefix = '/api') {
         this.client = client;
@@ -27,5 +29,20 @@ class UserModule {
     async updateProfile(uid, data) {
         return this.client.patch(`${this.prefix}/users/${uid}`, data);
     }
+    /**
+     * Retrieves contents liked by a specific user.
+     *
+     * @param uid - The UID of the user.
+     * @param params - Query parameters for filtering and pagination.
+     */
+    async getLikedContents(uid, params = {}) {
+        if (!uid)
+            throw new errors_1.ValidationError("UID is required", []);
+        const validation = api_contract_1.ListLikedContentQuerySchema.safeParse(params);
+        if (!validation.success) {
+            throw new errors_1.ValidationError("Invalid list liked contents params", validation.error.errors);
+        }
+        return this.client.get(`${this.prefix}/users/${uid}/liked-contents`, { params });
+    }
 }
 exports.UserModule = UserModule;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ph-cms/client-sdk",
-  "version": "0.1.32",
+  "version": "0.1.35",
   "description": "Unified PH-CMS Client SDK (React + Core)",
   "keywords": [],
   "license": "MIT",
@@ -30,7 +30,7 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@ph-cms/api-contract": "^0.1.11",
+    "@ph-cms/api-contract": "^0.1.14",
     "@tanstack/react-query": "^5.0.0",
     "axios": "^1.6.0",
     "zod": "^3.22.4"