@ph-cms/client-sdk 0.1.43 → 0.1.45

package/README.md

@@ -1,4 +1,4 @@
-# @ph-cms/client-sdk 0.1.43
+# @ph-cms/client-sdk 0.1.45
 
 PH-CMS 클라이언트 SDK — 브라우저 및 React 애플리케이션을 위한 통합 클라이언트.
 
@@ -8,6 +8,7 @@ PH-CMS 클라이언트 SDK — 브라우저 및 React 애플리케이션을 위
 - Auth Provider 인터페이스 및 구현체 (`LocalAuthProvider`, `FirebaseAuthProvider`, `StaticAuthProvider`)
 - React Context 및 Hooks
 - React Query 통합
+- 장소 검색 모듈 및 React hook
 - 자동 토큰 갱신 (Proactive + Reactive)
 - SSR (Server-Side Rendering) 지원 및 Cookie 연동 가능
 - Firebase ↔ PH-CMS 인증 동기화
@@ -59,6 +60,8 @@ import type {
   BlockUserRequest,
   BlockUserResponse,
   BlockedUserDto,
+  FollowStatusResponse,
+  FollowUserResponse,
   PagedBlockedUserListResponse,
   SuspendUserRequest,
   SuspendUserResponse,
@@ -100,6 +103,9 @@ import type {
   // Common
   PagedResponse,
   UserProfileDto,
+  IntegratedPlace,
+  PlaceSearchQuery,
+  PlaceSearchResponse,
 } from '@ph-cms/client-sdk';
 ```
 
@@ -107,6 +113,38 @@ import type {
 
 ---
 
+## Place Search
+
+SDK에서 통합 장소 검색 API를 바로 호출할 수 있습니다.
+
+### Core Client
+
+```ts
+const result = await client.place.search({
+  keyword: '강남역 맛집',
+});
+```
+
+### React Hook
+
+```ts
+import { usePlaceSearch } from '@ph-cms/client-sdk';
+
+const { data, isLoading } = usePlaceSearch(
+  { keyword: '강남역 맛집' },
+  true,
+);
+```
+
+응답의 각 장소 항목은 항상 동일한 키를 가집니다.
+
+- `phoneNumber`: `string | null`
+- `link`: `string | null`
+- `photos`: `[]` 포함 항상 존재
+- `reviews`: `[]` 포함 항상 존재
+
+---
+
 ## Authentication Architecture
 
 ### Overview
@@ -796,7 +834,7 @@ function UserLikedContents({ userUid }) {
 
 ### Public Profile (`useUserProfile`)
 
-다른 사용자의 공개 프로필(이름, 아바타, 자기소개 등)을 조회할 때 사용하는 훅입니다.
+다른 사용자의 공개 프로필(이름, 아바타, 자기소개, 팔로워 수 등)을 조회할 때 사용하는 훅입니다.
 
 ```tsx
 import { useUserProfile } from '@ph-cms/client-sdk';
@@ -811,10 +849,47 @@ function UserProfileCard({ userId }) {
     <div>
       <img src={profile.avatar_url} alt={profile.display_name} />
       <h3>{profile.display_name} (@{profile.username})</h3>
+      <p>followers: {profile.follower_count}</p>
       <p>{profile.profile_data?.bio}</p>
     </div>
   );
 }
+```
+
+### Follow Status / Follow / Unfollow
+
+특정 사용자에 대한 팔로우 상태를 조회하고, 팔로우/언팔로우할 수 있습니다.
+
+```tsx
+import {
+  useFollowStatus,
+  useFollowUser,
+  useUnfollowUser,
+} from '@ph-cms/client-sdk';
+
+function FollowButton({ userUid }: { userUid: string }) {
+  const { data: status, isLoading } = useFollowStatus(userUid);
+  const { mutate: followUser, isPending: isFollowingPending } = useFollowUser();
+  const { mutate: unfollowUser, isPending: isUnfollowingPending } = useUnfollowUser();
+
+  if (isLoading) return <button disabled>Loading...</button>;
+
+  const isFollowing = status?.is_following ?? false;
+  const isPending = isFollowingPending || isUnfollowingPending;
+
+  return (
+    <button
+      disabled={isPending}
+      onClick={() => {
+        if (isFollowing) unfollowUser(userUid);
+        else followUser(userUid);
+      }}
+    >
+      {isFollowing ? '언팔로우' : '팔로우'}
+    </button>
+  );
+}
+```
 
 ### `useLikedStats` (Liked Statistics)
 
@@ -1214,6 +1289,35 @@ const blockedUsers = await client.user.getBlockedUsers('my-user-uid', { page: 1,
 const { data: blockedList } = useBlockedUsers('my-user-uid', { page: 1 });
 ```
 
+## User Follow (사용자 팔로우)
+
+특정 사용자를 팔로우하거나 언팔로우할 수 있습니다. (인증 필수)
+
+```ts
+// 1. 팔로우 상태 조회
+const followStatus = await client.user.getFollowStatus('target-user-uid');
+// => { is_following: false }
+
+// React Hook 사용
+const { data: status } = useFollowStatus('target-user-uid');
+
+// 2. 사용자 팔로우
+const followResult = await client.user.follow('target-user-uid');
+// => { success: true, message: 'User followed', is_following: true }
+
+// React Hook 사용
+const { mutate: followUser } = useFollowUser();
+followUser('target-user-uid');
+
+// 3. 사용자 언팔로우
+const unfollowResult = await client.user.unfollow('target-user-uid');
+// => { success: true, message: 'User unfollowed', is_following: false }
+
+// React Hook 사용
+const { mutate: unfollowUser } = useUnfollowUser();
+unfollowUser('target-user-uid');
+```
+
 ## Global Ban (글로벌 밴 - 관리자 전용)
 
 특정 사용자의 활동을 전역적으로 정지시키거나 해제할 수 있습니다. (관리자 권한 필수)
@@ -1651,6 +1755,9 @@ const result = await content.list({ channelUid: 'my-channel' });
 | 메서드 | 설명 |
 |---|---|
 | `getProfile(uid: string)` | 유저의 공개 프로필 정보 조회 → `UserProfileDto` |
+| `getFollowStatus(uid: string)` | 현재 로그인 사용자의 대상 유저 팔로우 상태 조회 → `FollowStatusResponse` |
+| `follow(uid: string)` | 특정 사용자 팔로우 → `FollowUserResponse` |
+| `unfollow(uid: string)` | 특정 사용자 언팔로우 → `FollowUserResponse` |
 | `updateProfile(uid: string, data: UpdateUserProfileRequest)` | 유저의 프로필 정보 업데이트 → `UserDto` |
 | `getLikedContents(uid: string, params?: Partial<ListLikedContentQuery>)` | 사용자가 좋아요 누른 콘텐츠 목록 조회 → `PagedContentListResponse` |
 | `getLikedStats(uid: string)` | 사용자가 좋아요 누른 콘텐츠 타입별 통계 조회 → `LikedStatsByTypeResponse` |

package/dist/client.d.ts

@@ -4,6 +4,7 @@ import { AuthModule } from './modules/auth';
 import { ChannelModule } from './modules/channel';
 import { ContentModule } from './modules/content';
 import { MediaModule } from './modules/media';
+import { PlaceModule } from './modules/place';
 import { TermsModule } from './modules/terms';
 import { UserModule } from './modules/user';
 export interface PHCMSClientConfig {
@@ -25,6 +26,7 @@ export declare class PHCMSClient {
     readonly channel: ChannelModule;
     readonly terms: TermsModule;
     readonly media: MediaModule;
+    readonly place: PlaceModule;
     readonly user: UserModule;
     /**
      * Whether a token refresh is currently in flight (used by the 401

package/dist/client.js

@@ -11,6 +11,7 @@ const auth_1 = require("./modules/auth");
 const channel_1 = require("./modules/channel");
 const content_1 = require("./modules/content");
 const media_1 = require("./modules/media");
+const place_1 = require("./modules/place");
 const terms_1 = require("./modules/terms");
 const user_1 = require("./modules/user");
 class PHCMSClient {
@@ -68,6 +69,7 @@ class PHCMSClient {
         this.channel = new channel_1.ChannelModule(this.axiosInstance, normalizedApiPrefix);
         this.terms = new terms_1.TermsModule(this.axiosInstance, normalizedApiPrefix);
         this.media = new media_1.MediaModule(this.axiosInstance, normalizedApiPrefix);
+        this.place = new place_1.PlaceModule(this.axiosInstance, normalizedApiPrefix);
         this.user = new user_1.UserModule(this.axiosInstance, normalizedApiPrefix);
         // Wire the refresh function into the auth provider so it can
         // proactively refresh tokens inside `getToken()` without needing

package/dist/core.d.ts

@@ -8,6 +8,7 @@ export * from './modules/auth';
 export * from './modules/channel';
 export * from './modules/content';
 export * from './modules/media';
+export * from './modules/place';
 export * from './modules/terms';
 export * from './modules/user';
 export * from './types';

package/dist/core.js

@@ -27,6 +27,7 @@ __exportStar(require("./modules/auth"), exports);
 __exportStar(require("./modules/channel"), exports);
 __exportStar(require("./modules/content"), exports);
 __exportStar(require("./modules/media"), exports);
+__exportStar(require("./modules/place"), exports);
 __exportStar(require("./modules/terms"), exports);
 __exportStar(require("./modules/user"), exports);
 __exportStar(require("./types"), exports);

package/dist/hooks/useAuth.d.ts

@@ -23,6 +23,7 @@ export declare const useAuth: () => {
         username: string | null;
         display_name: string;
         avatar_url: string | null;
+        follower_count: number;
         phone_number: string | null;
         email_verified_at: string | null;
         phone_verified_at: string | null;
@@ -59,6 +60,7 @@ export declare const useAuth: () => {
             username: string | null;
             display_name: string;
             avatar_url: string | null;
+            follower_count: number;
             phone_number: string | null;
             email_verified_at: string | null;
             phone_verified_at: string | null;
@@ -98,6 +100,7 @@ export declare const useAuth: () => {
             username: string | null;
             display_name: string;
             avatar_url: string | null;
+            follower_count: number;
             phone_number: string | null;
             email_verified_at: string | null;
             phone_verified_at: string | null;
@@ -137,6 +140,7 @@ export declare const useAuth: () => {
             username: string | null;
             display_name: string;
             avatar_url: string | null;
+            follower_count: number;
             phone_number: string | null;
             email_verified_at: string | null;
             phone_verified_at: string | null;
@@ -173,6 +177,7 @@ export declare const useAuth: () => {
             username: string | null;
             display_name: string;
             avatar_url: string | null;
+            follower_count: number;
             phone_number: string | null;
             email_verified_at: string | null;
             phone_verified_at: string | null;
@@ -209,6 +214,7 @@ export declare const useAuth: () => {
         username: string | null;
         display_name: string;
         avatar_url: string | null;
+        follower_count: number;
         phone_number: string | null;
         email_verified_at: string | null;
         phone_verified_at: string | null;
@@ -251,6 +257,7 @@ export declare const useAuth: () => {
             username: string | null;
             display_name: string;
             avatar_url: string | null;
+            follower_count: number;
             phone_number: string | null;
             email_verified_at: string | null;
             phone_verified_at: string | null;
@@ -290,6 +297,7 @@ export declare const useAuth: () => {
             username: string | null;
             display_name: string;
             avatar_url: string | null;
+            follower_count: number;
             phone_number: string | null;
             email_verified_at: string | null;
             phone_verified_at: string | null;
@@ -329,6 +337,7 @@ export declare const useAuth: () => {
             username: string | null;
             display_name: string;
             avatar_url: string | null;
+            follower_count: number;
             phone_number: string | null;
             email_verified_at: string | null;
             phone_verified_at: string | null;
@@ -365,6 +374,7 @@ export declare const useAuth: () => {
             username: string | null;
             display_name: string;
             avatar_url: string | null;
+            follower_count: number;
             phone_number: string | null;
             email_verified_at: string | null;
             phone_verified_at: string | null;
@@ -401,6 +411,7 @@ export declare const useAuth: () => {
         username: string | null;
         display_name: string;
         avatar_url: string | null;
+        follower_count: number;
         phone_number: string | null;
         email_verified_at: string | null;
         phone_verified_at: string | null;
@@ -443,6 +454,7 @@ export declare const useLogin: () => import("@tanstack/react-query").UseMutation
         username: string | null;
         display_name: string;
         avatar_url: string | null;
+        follower_count: number;
         phone_number: string | null;
         email_verified_at: string | null;
         phone_verified_at: string | null;
@@ -483,6 +495,7 @@ export declare const useLoginAnonymous: () => import("@tanstack/react-query").Us
         username: string | null;
         display_name: string;
         avatar_url: string | null;
+        follower_count: number;
         phone_number: string | null;
         email_verified_at: string | null;
         phone_verified_at: string | null;
@@ -519,6 +532,7 @@ export declare const useUpgradeAnonymous: () => import("@tanstack/react-query").
     username: string | null;
     display_name: string;
     avatar_url: string | null;
+    follower_count: number;
     phone_number: string | null;
     email_verified_at: string | null;
     phone_verified_at: string | null;

package/dist/hooks/usePlace.d.ts

@@ -0,0 +1,38 @@
+import { PlaceSearchQuery } from '@ph-cms/api-contract';
+export declare const placeKeys: {
+    all: readonly ["places"];
+    search: (params: PlaceSearchQuery) => readonly ["places", "search", {
+        keyword: string;
+        lat?: number | undefined;
+        lng?: number | undefined;
+    }];
+};
+export declare const usePlaceSearch: (params: PlaceSearchQuery, enabled?: boolean) => import("@tanstack/react-query").UseQueryResult<{
+    items: {
+        id: string;
+        provider: "google" | "naver";
+        name: string;
+        address: string;
+        location: {
+            lat: number;
+            lng: number;
+        };
+        category: string;
+        phoneNumber: string | null;
+        link: string | null;
+        photos: {
+            url: string;
+            width: number | null;
+            height: number | null;
+            attribution: string | null;
+        }[];
+        reviews: {
+            date: string | null;
+            title: string;
+            author: string | null;
+            link: string;
+            snippet: string;
+        }[];
+    }[];
+    keyword: string;
+}, Error>;

package/dist/hooks/usePlace.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.usePlaceSearch = exports.placeKeys = void 0;
+const react_query_1 = require("@tanstack/react-query");
+const context_1 = require("../context");
+exports.placeKeys = {
+    all: ['places'],
+    search: (params) => [...exports.placeKeys.all, 'search', params],
+};
+const usePlaceSearch = (params, enabled = true) => {
+    const client = (0, context_1.usePHCMS)();
+    return (0, react_query_1.useQuery)({
+        queryKey: exports.placeKeys.search(params),
+        queryFn: () => client.place.search(params),
+        staleTime: 1000 * 60 * 5,
+        enabled: enabled && !!params.keyword,
+    });
+};
+exports.usePlaceSearch = usePlaceSearch;

package/dist/hooks/useUser.d.ts

@@ -3,6 +3,11 @@ export declare const termsKeys: {
     all: readonly ["terms"];
     lists: () => readonly ["terms", "list"];
 };
+export declare const userKeys: {
+    all: readonly ["users"];
+    profile: (uid: string) => readonly ["users", "profile", string];
+    followStatus: (uid: string) => readonly ["users", "follow-status", string];
+};
 /**
  * Access the current user profile and status.
  */
@@ -14,6 +19,7 @@ export declare const useUser: () => {
         username: string | null;
         display_name: string;
         avatar_url: string | null;
+        follower_count: number;
         phone_number: string | null;
         email_verified_at: string | null;
         phone_verified_at: string | null;
@@ -51,8 +57,15 @@ export declare const useUserProfile: (uid: string) => import("@tanstack/react-qu
     username: string | null;
     display_name: string;
     avatar_url: string | null;
+    follower_count: number;
     profile_data: Record<string, any>;
 }, Error>;
+/**
+ * Hook to fetch follow status for a target user.
+ */
+export declare const useFollowStatus: (uid: string, enabled?: boolean) => import("@tanstack/react-query").UseQueryResult<{
+    is_following: boolean;
+}, Error>;
 /**
  * Hook to update a user's profile.
  * Typically used by a user to update their own profile.
@@ -64,6 +77,7 @@ export declare const useUpdateProfile: () => import("@tanstack/react-query").Use
     username: string | null;
     display_name: string;
     avatar_url: string | null;
+    follower_count: number;
     phone_number: string | null;
     email_verified_at: string | null;
     phone_verified_at: string | null;
@@ -92,6 +106,22 @@ export declare const useUpdateProfile: () => import("@tanstack/react-query").Use
     uid: string;
     data: UpdateUserProfileRequest | Record<string, any>;
 }, unknown>;
+/**
+ * Hook to follow a user.
+ */
+export declare const useFollowUser: () => import("@tanstack/react-query").UseMutationResult<{
+    message: string;
+    is_following: boolean;
+    success: boolean;
+}, Error, string, unknown>;
+/**
+ * Hook to unfollow a user.
+ */
+export declare const useUnfollowUser: () => import("@tanstack/react-query").UseMutationResult<{
+    message: string;
+    is_following: boolean;
+    success: boolean;
+}, Error, string, unknown>;
 /**
  * Hook to fetch contents liked by a specific user.
  */

package/dist/hooks/useUser.js

@@ -1,12 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useUnsuspendUser = exports.useSuspendUser = exports.useBlockedUsers = exports.useUnblockUser = exports.useBlockUser = exports.useAgreeTerms = exports.useChannelTerms = exports.useLikedStats = exports.useLikedContents = exports.useUpdateProfile = exports.useUserProfile = exports.useUser = exports.termsKeys = void 0;
+exports.useUnsuspendUser = exports.useSuspendUser = exports.useBlockedUsers = exports.useUnblockUser = exports.useBlockUser = exports.useAgreeTerms = exports.useChannelTerms = exports.useLikedStats = exports.useLikedContents = exports.useUnfollowUser = exports.useFollowUser = exports.useUpdateProfile = exports.useFollowStatus = exports.useUserProfile = exports.useUser = exports.userKeys = exports.termsKeys = void 0;
 const react_query_1 = require("@tanstack/react-query");
 const context_1 = require("../context");
 exports.termsKeys = {
     all: ['terms'],
     lists: () => [...exports.termsKeys.all, 'list'],
 };
+exports.userKeys = {
+    all: ['users'],
+    profile: (uid) => [...exports.userKeys.all, 'profile', uid],
+    followStatus: (uid) => [...exports.userKeys.all, 'follow-status', uid],
+};
 /**
  * Access the current user profile and status.
  */
@@ -21,12 +26,24 @@ exports.useUser = useUser;
 const useUserProfile = (uid) => {
     const client = (0, context_1.usePHCMS)();
     return (0, react_query_1.useQuery)({
-        queryKey: ['user-profile', uid],
+        queryKey: exports.userKeys.profile(uid),
         queryFn: () => client.user.getProfile(uid),
         enabled: !!uid,
     });
 };
 exports.useUserProfile = useUserProfile;
+/**
+ * Hook to fetch follow status for a target user.
+ */
+const useFollowStatus = (uid, enabled = true) => {
+    const client = (0, context_1.usePHCMS)();
+    return (0, react_query_1.useQuery)({
+        queryKey: exports.userKeys.followStatus(uid),
+        queryFn: () => client.user.getFollowStatus(uid),
+        enabled: !!uid && enabled,
+    });
+};
+exports.useFollowStatus = useFollowStatus;
 /**
  * Hook to update a user's profile.
  * Typically used by a user to update their own profile.
@@ -43,6 +60,36 @@ const useUpdateProfile = () => {
     });
 };
 exports.useUpdateProfile = useUpdateProfile;
+/**
+ * Hook to follow a user.
+ */
+const useFollowUser = () => {
+    const client = (0, context_1.usePHCMS)();
+    const queryClient = (0, react_query_1.useQueryClient)();
+    return (0, react_query_1.useMutation)({
+        mutationFn: (uid) => client.user.follow(uid),
+        onSuccess: (_data, uid) => {
+            queryClient.invalidateQueries({ queryKey: exports.userKeys.followStatus(uid) });
+            queryClient.invalidateQueries({ queryKey: exports.userKeys.profile(uid) });
+        },
+    });
+};
+exports.useFollowUser = useFollowUser;
+/**
+ * Hook to unfollow a user.
+ */
+const useUnfollowUser = () => {
+    const client = (0, context_1.usePHCMS)();
+    const queryClient = (0, react_query_1.useQueryClient)();
+    return (0, react_query_1.useMutation)({
+        mutationFn: (uid) => client.user.unfollow(uid),
+        onSuccess: (_data, uid) => {
+            queryClient.invalidateQueries({ queryKey: exports.userKeys.followStatus(uid) });
+            queryClient.invalidateQueries({ queryKey: exports.userKeys.profile(uid) });
+        },
+    });
+};
+exports.useUnfollowUser = useUnfollowUser;
 /**
  * Hook to fetch contents liked by a specific user.
  */

package/dist/index.d.ts

@@ -10,6 +10,7 @@ export * from './modules/auth';
 export * from './modules/channel';
 export * from './modules/content';
 export * from './modules/media';
+export * from './modules/place';
 export * from './modules/terms';
 export * from './modules/user';
 export * from './context';
@@ -18,5 +19,6 @@ export * from './hooks/useContent';
 export * from './hooks/useStampTour';
 export * from './hooks/useFirebaseAuthSync';
 export * from './hooks/useMedia';
+export * from './hooks/usePlace';
 export * from './hooks/useUser';
 export * from './types';

package/dist/index.js

@@ -26,6 +26,7 @@ __exportStar(require("./modules/auth"), exports);
 __exportStar(require("./modules/channel"), exports);
 __exportStar(require("./modules/content"), exports);
 __exportStar(require("./modules/media"), exports);
+__exportStar(require("./modules/place"), exports);
 __exportStar(require("./modules/terms"), exports);
 __exportStar(require("./modules/user"), exports);
 __exportStar(require("./context"), exports);
@@ -34,5 +35,6 @@ __exportStar(require("./hooks/useContent"), exports);
 __exportStar(require("./hooks/useStampTour"), exports);
 __exportStar(require("./hooks/useFirebaseAuthSync"), exports);
 __exportStar(require("./hooks/useMedia"), exports);
+__exportStar(require("./hooks/usePlace"), exports);
 __exportStar(require("./hooks/useUser"), exports);
 __exportStar(require("./types"), exports);

package/dist/modules/place.d.ts

@@ -0,0 +1,8 @@
+import { PlaceSearchQuery, PlaceSearchResponse } from "@ph-cms/api-contract";
+import { AxiosInstance } from "axios";
+export declare class PlaceModule {
+    private client;
+    private prefix;
+    constructor(client: AxiosInstance, prefix?: string);
+    search(params: PlaceSearchQuery): Promise<PlaceSearchResponse>;
+}

package/dist/modules/place.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlaceModule = void 0;
+const api_contract_1 = require("@ph-cms/api-contract");
+const errors_1 = require("../errors");
+class PlaceModule {
+    constructor(client, prefix = '/api') {
+        this.client = client;
+        this.prefix = prefix;
+    }
+    async search(params) {
+        const validation = api_contract_1.PlaceSearchQuerySchema.safeParse(params);
+        if (!validation.success) {
+            throw new errors_1.ValidationError("Invalid place search params", validation.error.errors);
+        }
+        return this.client.get(`${this.prefix}/places/search`, {
+            params,
+        });
+    }
+}
+exports.PlaceModule = PlaceModule;

package/dist/modules/user.d.ts

@@ -1,4 +1,4 @@
-import { LikedStatsByTypeResponse, ListLikedContentQuery, PagedContentListResponse, UpdateUserProfileRequest, UserDto, UserProfileDto, BlockUserRequest, BlockUserResponse, PagedBlockedUserListResponse, SuspendUserRequest, SuspendUserResponse } from "@ph-cms/api-contract";
+import { LikedStatsByTypeResponse, ListLikedContentQuery, PagedContentListResponse, UpdateUserProfileRequest, UserDto, UserProfileDto, FollowStatusResponse, FollowUserResponse, BlockUserRequest, BlockUserResponse, PagedBlockedUserListResponse, SuspendUserRequest, SuspendUserResponse } from "@ph-cms/api-contract";
 import { AxiosInstance } from "axios";
 export declare class UserModule {
     private client;
@@ -10,6 +10,24 @@ export declare class UserModule {
      * @param uid - The UID of the user.
      */
     getProfile(uid: string): Promise<UserProfileDto>;
+    /**
+     * Retrieves whether the current authenticated user follows the target user.
+     *
+     * @param uid - The UID of the target user.
+     */
+    getFollowStatus(uid: string): Promise<FollowStatusResponse>;
+    /**
+     * Follows a user.
+     *
+     * @param uid - The UID of the target user.
+     */
+    follow(uid: string): Promise<FollowUserResponse>;
+    /**
+     * Unfollows a user.
+     *
+     * @param uid - The UID of the target user.
+     */
+    unfollow(uid: string): Promise<FollowUserResponse>;
     /**
      * Updates a user's profile.
      *

package/dist/modules/user.js

@@ -16,6 +16,36 @@ class UserModule {
     async getProfile(uid) {
         return this.client.get(`${this.prefix}/users/${uid}/profile`);
     }
+    /**
+     * Retrieves whether the current authenticated user follows the target user.
+     *
+     * @param uid - The UID of the target user.
+     */
+    async getFollowStatus(uid) {
+        if (!uid)
+            throw new errors_1.ValidationError("UID is required", []);
+        return this.client.get(`${this.prefix}/users/${uid}/follow-status`);
+    }
+    /**
+     * Follows a user.
+     *
+     * @param uid - The UID of the target user.
+     */
+    async follow(uid) {
+        if (!uid)
+            throw new errors_1.ValidationError("UID is required", []);
+        return this.client.post(`${this.prefix}/users/${uid}/follow`);
+    }
+    /**
+     * Unfollows a user.
+     *
+     * @param uid - The UID of the target user.
+     */
+    async unfollow(uid) {
+        if (!uid)
+            throw new errors_1.ValidationError("UID is required", []);
+        return this.client.delete(`${this.prefix}/users/${uid}/follow`);
+    }
     /**
      * Updates a user's profile.
      *

package/dist/types.d.ts

@@ -5,7 +5,7 @@ export type { AuthStatus, PHCMSContextType, PHCMSProviderProps } from './context
 export type { FirebaseAuthSyncProps, UseFirebaseAuthSyncOptions, UseFirebaseAuthSyncReturn } from './hooks/useFirebaseAuthSync';
 export type { StampAvailability, CheckStampAvailabilityParams } from './hooks/useStampTour';
 export type { AnonymousLoginRequest, AuthResponse, FirebaseExchangeRequest, FirebaseRegisterRequest, LoginRequest, RefreshTokenRequest, RegisterRequest, } from '@ph-cms/api-contract';
-export type { UserDto, UserProfileDto } from '@ph-cms/api-contract';
+export type { UserDto, UserProfileDto, FollowStatusResponse, FollowUserResponse, } from '@ph-cms/api-contract';
 export type { ChannelDto, CheckHierarchyQuery } from '@ph-cms/api-contract';
 export type { ContentDto, ContentStatDto, ContentMediaDto, ContentStatus, CreateContentRequest, ListContentQuery, PagedContentListResponse, UpdateContentRequest, } from '@ph-cms/api-contract';
 export type { HierarchySetDto } from '@ph-cms/api-contract';
@@ -13,4 +13,5 @@ export type { PermissionPolicySetDto } from '@ph-cms/api-contract';
 export type { TermDto } from '@ph-cms/api-contract';
 export type { GeoJSON } from '@ph-cms/api-contract';
 export type { MediaUploadTicketBatchRequest, MediaUploadTicketBatchResponse, MediaUploadTicketRequest, MediaUploadTicketResponse } from '@ph-cms/api-contract';
+export type { IntegratedPlace, PlaceSearchQuery, PlaceSearchResponse, } from '@ph-cms/api-contract';
 export type { PagedResponse } from '@ph-cms/api-contract';

package/package.json

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