@ph-cms/client-sdk 0.1.32 → 0.1.33

package/README.md

@@ -1,4 +1,4 @@
-# @ph-cms/client-sdk 0.1.32
+# @ph-cms/client-sdk 0.1.33
 
 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';
 ```
 
@@ -1082,6 +1085,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 +1512,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`)
 
@@ -1525,6 +1543,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/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.33",
   "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.12",
     "@tanstack/react-query": "^5.0.0",
     "axios": "^1.6.0",
     "zod": "^3.22.4"