@ph-cms/client-sdk 0.1.36 → 0.1.38

package/README.md

@@ -1,4 +1,4 @@
-# @ph-cms/client-sdk 0.1.35
+# @ph-cms/client-sdk 0.1.38
 
 PH-CMS 클라이언트 SDK — 브라우저 및 React 애플리케이션을 위한 통합 클라이언트.
 
@@ -458,7 +458,7 @@ function AuthComponent() {
     loginWithFirebase, // (data: FirebaseExchangeRequest) => Promise<AuthResponse>
     register,          // (data: RegisterInput) => Promise<AuthResponse>  ← method: 'email' | 'firebase'
     loginAnonymous,    // (data?: AnonymousLoginRequest) => Promise<AuthResponse>
-    upgradeAnonymous,  // (data: { email, password, display_name?, username? }) => Promise<UserDto>
+    upgradeAnonymous,  // (data: { email, password, display_name?, username?, phone_number? }) => Promise<UserDto>
     logout,            // () => Promise<void>
 
     // 뮤테이션 상태 (isPending, error 등)
@@ -614,9 +614,9 @@ function FirebaseGuestButton() {
 function UpgradeForm() {
   const { upgradeAnonymous, upgradeAnonymousStatus, user } = useAuth();
 
-  const handleUpgrade = async (email: string, password: string, displayName: string) => {
-    await upgradeAnonymous({ email, password, display_name: displayName });
-    // 성공 → role에서 'anonymous' 제거됨 → 기존 히스토리 유지
+  const handleUpgrade = async (email: string, password: string, displayName: string, phoneNumber?: string) => {
+    await upgradeAnonymous({ email, password, display_name: displayName, phone_number: phoneNumber });
+    // 성공 → role이 ['user']로 전환됨 → 기존 히스토리 유지
   };
 
   if (!user?.role.includes('anonymous')) return null;
@@ -629,11 +629,13 @@ function UpgradeForm() {
         fd.get('email') as string,
         fd.get('password') as string,
         fd.get('display_name') as string,
+        fd.get('phone_number') as string || undefined,
       );
     }}>
       <input name="email" type="email" placeholder="이메일" />
       <input name="password" type="password" placeholder="비밀번호" />
       <input name="display_name" placeholder="이름" />
+      <input name="phone_number" placeholder="전화번호 (선택)" />
       <button type="submit" disabled={upgradeAnonymousStatus.isPending}>
         {upgradeAnonymousStatus.isPending ? '전환 중...' : '계정 만들기'}
       </button>
@@ -762,6 +764,28 @@ function MyComponent() {
 }
 ```
 
+### Liked Contents (`useLikedContents`)
+
+특정 사용자가 좋아요를 누른 콘텐츠 목록을 조회합니다.
+
+```tsx
+import { useLikedContents } from '@ph-cms/client-sdk';
+
+function UserLikedContents({ userUid }) {
+  const { data, isLoading } = useLikedContents(userUid, { type: 'post', page: 1, limit: 10 });
+
+  if (isLoading) return <div>Loading...</div>;
+
+  return (
+    <ul>
+      {data?.content.map(item => (
+        <li key={item.uid}>{item.title}</li>
+      ))}
+    </ul>
+  );
+}
+```
+
 ### Public Profile (`useUserProfile`)
 
 다른 사용자의 공개 프로필(이름, 아바타, 자기소개 등)을 조회할 때 사용하는 훅입니다.
@@ -783,6 +807,28 @@ function UserProfileCard({ userId }) {
     </div>
   );
 }
+
+### `useLikedStats` (Liked Statistics)
+
+특정 사용자가 좋아요를 누른 콘텐츠의 타입별 통계를 조회합니다.
+
+```tsx
+import { useLikedStats } from '@ph-cms/client-sdk';
+
+function UserLikedStats({ userUid }) {
+  const { data: stats, isLoading } = useLikedStats(userUid);
+
+  if (isLoading) return <div>Loading...</div>;
+
+  return (
+    <ul>
+      {stats?.map(item => (
+        <li key={item.type}>{item.type}: {item.count}</li>
+      ))}
+    </ul>
+  );
+}
+```
 ```
 
 ### Profile Update (`useUpdateProfile`)
@@ -1099,6 +1145,10 @@ const likers = await client.content.getLikers('content-uid', { page: 1, limit: 1
 // 2. 특정 사용자가 좋아요를 누른 콘텐츠 목록 (타입 필터링 지원)
 const likedContents = await client.user.getLikedContents('user-uid', { type: 'post', page: 1 });
 // => PagedContentListResponse
+
+// 3. 특정 사용자가 좋아요를 누른 콘텐츠 타입별 통계
+const likedStats = await client.user.getLikedStats('user-uid');
+// => [{ type: 'post', count: 5 }, { type: 'place', count: 2 }]
 ```
 
 ## Stamp Tour
@@ -1516,6 +1566,7 @@ const result = await content.list({ channelUid: 'my-channel' });
 | `getProfile(uid: string)` | 유저의 공개 프로필 정보 조회 → `UserProfileDto` |
 | `updateProfile(uid: string, data: UpdateUserProfileRequest)` | 유저의 프로필 정보 업데이트 → `UserDto` |
 | `getLikedContents(uid: string, params?: Partial<ListLikedContentQuery>)` | 사용자가 좋아요 누른 콘텐츠 목록 조회 → `PagedContentListResponse` |
+| `getLikedStats(uid: string)` | 사용자가 좋아요 누른 콘텐츠 타입별 통계 조회 → `LikedStatsByTypeResponse` |
 
 ### `AuthModule` (`client.auth`)
 
@@ -1525,6 +1576,8 @@ const result = await content.list({ channelUid: 'my-channel' });
 | `loginWithFirebase(data: FirebaseExchangeRequest)` | Firebase ID 토큰 교환 → `AuthResponse` |
 | `register(data: RegisterRequest)` | 이메일 회원가입 → `AuthResponse` (`channelUid` \| `channelSlug` 필수, `phone_number` 지원) |
 | `registerWithFirebase(data: FirebaseRegisterRequest)` | 서버 사이드 Firebase 회원가입 → `AuthResponse` (`channelUid` \| `channelSlug` 필수, `phone_number` 지원) |
+| `loginAnonymous(data?: AnonymousLoginRequest)` | 익명 계정 생성/로그인 → `AuthResponse` |
+| `upgradeAnonymous(data: { email, password, display_name?, username?, phone_number? })` | 익명 → 정식 이메일 계정 전환 → `UserDto` (role: `['user']`) |
 | `me(params?: { channelUid?: string })` | 현재 사용자 프로필 조회 → `UserDto` |
 | `refresh(refreshToken: string)` | 토큰 갱신 → `{ accessToken, refreshToken }` |
 | `logout()` | 로그아웃 (프로바이더 토큰 삭제 + 서버 세션 무효화) |

package/dist/hooks/useAuth.d.ts

@@ -238,6 +238,7 @@ export declare const useAuth: () => {
         password: string;
         display_name?: string;
         username?: string;
+        phone_number?: string;
     }, unknown>;
     logout: import("@tanstack/react-query").UseMutateAsyncFunction<void, Error, void, unknown>;
     getToken: () => Promise<string | null>;
@@ -429,6 +430,7 @@ export declare const useAuth: () => {
         password: string;
         display_name?: string;
         username?: string;
+        phone_number?: string;
     }, unknown>;
     logoutStatus: import("@tanstack/react-query").UseMutationResult<void, Error, void, unknown>;
 };
@@ -546,5 +548,6 @@ export declare const useUpgradeAnonymous: () => import("@tanstack/react-query").
     password: string;
     display_name?: string;
     username?: string;
+    phone_number?: string;
 }, unknown>;
 export {};

package/dist/hooks/useUser.d.ts

@@ -1,4 +1,4 @@
-import { UpdateUserProfileRequest } from '@ph-cms/api-contract';
+import { ListLikedContentQuery, UpdateUserProfileRequest } from '@ph-cms/api-contract';
 export declare const termsKeys: {
     all: readonly ["terms"];
     lists: () => readonly ["terms", "list"];
@@ -92,6 +92,26 @@ export declare const useUpdateProfile: () => import("@tanstack/react-query").Use
     uid: string;
     data: UpdateUserProfileRequest | Record<string, any>;
 }, unknown>;
+/**
+ * Hook to fetch contents liked by a specific user.
+ */
+export declare const useLikedContents: (uid: string, params?: Partial<ListLikedContentQuery>) => import("@tanstack/react-query").UseQueryResult<{
+    number: number;
+    totalPages: number;
+    content: import("@ph-cms/api-contract").ContentDto[];
+    size: number;
+    totalElements: number;
+    first: boolean;
+    last: boolean;
+    empty: boolean;
+}, Error>;
+/**
+ * Hook to fetch statistics of liked contents by type for a specific user.
+ */
+export declare const useLikedStats: (uid: string) => import("@tanstack/react-query").UseQueryResult<{
+    type: string;
+    count: number;
+}[], Error>;
 /**
  * List terms required/available for the current channel.
  */

package/dist/hooks/useUser.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useAgreeTerms = exports.useChannelTerms = exports.useUpdateProfile = exports.useUserProfile = exports.useUser = exports.termsKeys = void 0;
+exports.useAgreeTerms = exports.useChannelTerms = exports.useLikedStats = exports.useLikedContents = exports.useUpdateProfile = exports.useUserProfile = exports.useUser = exports.termsKeys = void 0;
 const react_query_1 = require("@tanstack/react-query");
 const context_1 = require("../context");
 exports.termsKeys = {
@@ -43,6 +43,30 @@ const useUpdateProfile = () => {
     });
 };
 exports.useUpdateProfile = useUpdateProfile;
+/**
+ * Hook to fetch contents liked by a specific user.
+ */
+const useLikedContents = (uid, params = {}) => {
+    const client = (0, context_1.usePHCMS)();
+    return (0, react_query_1.useQuery)({
+        queryKey: ['user-liked-contents', uid, params],
+        queryFn: () => client.user.getLikedContents(uid, params),
+        enabled: !!uid,
+    });
+};
+exports.useLikedContents = useLikedContents;
+/**
+ * Hook to fetch statistics of liked contents by type for a specific user.
+ */
+const useLikedStats = (uid) => {
+    const client = (0, context_1.usePHCMS)();
+    return (0, react_query_1.useQuery)({
+        queryKey: ['user-liked-stats', uid],
+        queryFn: () => client.user.getLikedStats(uid),
+        enabled: !!uid,
+    });
+};
+exports.useLikedStats = useLikedStats;
 /**
  * List terms required/available for the current channel.
  */

package/dist/modules/auth.d.ts

@@ -36,6 +36,7 @@ export declare class AuthModule {
         password: string;
         display_name?: string;
         username?: string;
+        phone_number?: string;
     }): Promise<UserDto>;
     logout(): Promise<void>;
 }

package/dist/modules/user.d.ts

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

package/dist/modules/user.js

@@ -44,5 +44,15 @@ class UserModule {
         }
         return this.client.get(`${this.prefix}/users/${uid}/liked-contents`, { params });
     }
+    /**
+     * Retrieves statistics of liked contents by type for a specific user.
+     *
+     * @param uid - The UID of the user.
+     */
+    async getLikedStats(uid) {
+        if (!uid)
+            throw new errors_1.ValidationError("UID is required", []);
+        return this.client.get(`${this.prefix}/users/${uid}/liked-stats`);
+    }
 }
 exports.UserModule = UserModule;

package/package.json

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