@ph-cms/client-sdk 0.1.37 → 0.1.42

package/README.md

@@ -1,4 +1,4 @@
-# @ph-cms/client-sdk 0.1.37
+# @ph-cms/client-sdk 0.1.42
 
 PH-CMS 클라이언트 SDK — 브라우저 및 React 애플리케이션을 위한 통합 클라이언트.
 
@@ -56,6 +56,12 @@ import type {
 
   // User
   UserDto,
+  BlockUserRequest,
+  BlockUserResponse,
+  BlockedUserDto,
+  PagedBlockedUserListResponse,
+  SuspendUserRequest,
+  SuspendUserResponse,
 
   // Channel
   ChannelDto,
@@ -72,6 +78,8 @@ import type {
   ListLikersQuery,
   ListLikedContentQuery,
   PagedContentListResponse,
+  ReportContentRequest,
+  ReportContentResponse,
 
   // Hierarchy / Policy
   HierarchySetDto,
@@ -807,6 +815,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`)
@@ -1123,6 +1153,89 @@ 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 }]
+```
+
+## Content Report (콘텐츠 신고)
+
+부적절한 콘텐츠를 신고할 수 있습니다. (인증 필수)
+
+```ts
+// 모듈 직접 사용
+const result = await client.content.report('content-uid', {
+  reason: 'SPAM',
+  description: '이 콘텐츠는 스팸입니다.'
+});
+// => { message: 'Report submitted successfully' }
+
+// React Hook 사용
+const { mutate: reportContent } = useReportContent();
+
+reportContent({
+  uid: 'content-uid',
+  data: {
+    reason: 'INAPPROPRIATE',
+    description: '부적절한 내용이 포함되어 있습니다.'
+  }
+});
+```
+
+## User Block (사용자 차단)
+
+특정 사용자를 차단하거나 차단 해제할 수 있습니다. (인증 필수)
+
+```ts
+// 1. 사용자 차단
+const blockResult = await client.user.block('target-user-uid', {
+  reason: '부적절한 언행'
+});
+// => { success: true, message: 'User blocked' }
+
+// React Hook 사용
+const { mutate: blockUser } = useBlockUser();
+blockUser({ uid: 'target-user-uid', data: { reason: '사유' } });
+
+// 2. 사용자 차단 해제
+const unblockResult = await client.user.unblock('target-user-uid');
+// => { success: true, message: 'User unblocked' }
+
+// React Hook 사용
+const { mutate: unblockUser } = useUnblockUser();
+unblockUser('target-user-uid');
+
+// 3. 차단한 사용자 목록 조회
+const blockedUsers = await client.user.getBlockedUsers('my-user-uid', { page: 1, limit: 10 });
+// => PagedBlockedUserListResponse
+
+// React Hook 사용
+const { data: blockedList } = useBlockedUsers('my-user-uid', { page: 1 });
+```
+
+## Global Ban (글로벌 밴 - 관리자 전용)
+
+특정 사용자의 활동을 전역적으로 정지시키거나 해제할 수 있습니다. (관리자 권한 필수)
+
+```ts
+// 1. 사용자 활동 정지 (Suspend)
+const suspendResult = await client.user.suspend('target-user-uid', {
+  reason: '운영 정책 위반'
+});
+// => { success: true, message: 'User suspended' }
+
+// React Hook 사용
+const { mutate: suspendUser } = useSuspendUser();
+suspendUser({ uid: 'target-user-uid', data: { reason: '사유' } });
+
+// 2. 사용자 활동 정지 해제 (Unsuspend)
+const unsuspendResult = await client.user.unsuspend('target-user-uid');
+// => { success: true, message: 'User unsuspended' }
+
+// React Hook 사용
+const { mutate: unsuspendUser } = useUnsuspendUser();
+unsuspendUser('target-user-uid');
 ```
 
 ## Stamp Tour
@@ -1540,6 +1653,12 @@ 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` |
+| `block(uid: string, data?: BlockUserRequest)` | 특정 사용자 차단 → `BlockUserResponse` |
+| `unblock(uid: string)` | 특정 사용자 차단 해제 → `BlockUserResponse` |
+| `getBlockedUsers(uid: string, params?: { page?: number; limit?: number })` | 차단한 사용자 목록 조회 → `PagedBlockedUserListResponse` |
+| `suspend(uid: string, data?: SuspendUserRequest)` | 유저 활동 정지 (글로벌 밴) → `SuspendUserResponse` |
+| `unsuspend(uid: string)` | 유저 활동 정지 해제 → `SuspendUserResponse` |
 
 ### `AuthModule` (`client.auth`)
 
@@ -1572,6 +1691,7 @@ const result = await content.list({ channelUid: 'my-channel' });
 | `toggleLike(uid: string)` | 좋아요 토글 → `ToggleLikeResponse` |
 | `getLikeStatus(uid: string)` | 내 좋아요 여부 확인 → `LikeStatusResponse` |
 | `getLikers(uid: string, params?: Partial<ListLikersQuery>)` | 콘텐츠에 좋아요 누른 사용자 목록 조회 → `PagedResponse<UserProfileDto>` |
+| `report(uid: string, data: ReportContentRequest)` | 콘텐츠 신고 → `ReportContentResponse` |
 
 ### `ChannelModule` (`client.channel`)
 

package/dist/hooks/useAuth.d.ts

@@ -17,7 +17,7 @@ export type RegisterInput = FirebaseRegisterInput | EmailRegisterInput;
  */
 export declare const useAuth: () => {
     user: {
-        status: string;
+        status: "active" | "inactive" | "suspended" | "pending";
         uid: string;
         email: string;
         username: string | null;
@@ -53,7 +53,7 @@ export declare const useAuth: () => {
     login: import("@tanstack/react-query").UseMutateAsyncFunction<{
         refreshToken: string;
         user: {
-            status: string;
+            status: "active" | "inactive" | "suspended" | "pending";
             uid: string;
             email: string;
             username: string | null;
@@ -92,7 +92,7 @@ export declare const useAuth: () => {
     loginWithFirebase: import("@tanstack/react-query").UseMutateAsyncFunction<{
         refreshToken: string;
         user: {
-            status: string;
+            status: "active" | "inactive" | "suspended" | "pending";
             uid: string;
             email: string;
             username: string | null;
@@ -131,7 +131,7 @@ export declare const useAuth: () => {
     register: import("@tanstack/react-query").UseMutateAsyncFunction<{
         refreshToken: string;
         user: {
-            status: string;
+            status: "active" | "inactive" | "suspended" | "pending";
             uid: string;
             email: string;
             username: string | null;
@@ -167,7 +167,7 @@ export declare const useAuth: () => {
     loginAnonymous: import("@tanstack/react-query").UseMutateAsyncFunction<{
         refreshToken: string;
         user: {
-            status: string;
+            status: "active" | "inactive" | "suspended" | "pending";
             uid: string;
             email: string;
             username: string | null;
@@ -203,7 +203,7 @@ export declare const useAuth: () => {
         channelUid?: string;
     } | undefined, unknown>;
     upgradeAnonymous: import("@tanstack/react-query").UseMutateAsyncFunction<{
-        status: string;
+        status: "active" | "inactive" | "suspended" | "pending";
         uid: string;
         email: string;
         username: string | null;
@@ -245,7 +245,7 @@ export declare const useAuth: () => {
     loginStatus: import("@tanstack/react-query").UseMutationResult<{
         refreshToken: string;
         user: {
-            status: string;
+            status: "active" | "inactive" | "suspended" | "pending";
             uid: string;
             email: string;
             username: string | null;
@@ -284,7 +284,7 @@ export declare const useAuth: () => {
     loginWithFirebaseStatus: import("@tanstack/react-query").UseMutationResult<{
         refreshToken: string;
         user: {
-            status: string;
+            status: "active" | "inactive" | "suspended" | "pending";
             uid: string;
             email: string;
             username: string | null;
@@ -323,7 +323,7 @@ export declare const useAuth: () => {
     registerStatus: import("@tanstack/react-query").UseMutationResult<{
         refreshToken: string;
         user: {
-            status: string;
+            status: "active" | "inactive" | "suspended" | "pending";
             uid: string;
             email: string;
             username: string | null;
@@ -359,7 +359,7 @@ export declare const useAuth: () => {
     loginAnonymousStatus: import("@tanstack/react-query").UseMutationResult<{
         refreshToken: string;
         user: {
-            status: string;
+            status: "active" | "inactive" | "suspended" | "pending";
             uid: string;
             email: string;
             username: string | null;
@@ -395,7 +395,7 @@ export declare const useAuth: () => {
         channelUid?: string;
     } | undefined, unknown>;
     upgradeAnonymousStatus: import("@tanstack/react-query").UseMutationResult<{
-        status: string;
+        status: "active" | "inactive" | "suspended" | "pending";
         uid: string;
         email: string;
         username: string | null;
@@ -437,7 +437,7 @@ export declare const useAuth: () => {
 export declare const useLogin: () => import("@tanstack/react-query").UseMutationResult<{
     refreshToken: string;
     user: {
-        status: string;
+        status: "active" | "inactive" | "suspended" | "pending";
         uid: string;
         email: string;
         username: string | null;
@@ -477,7 +477,7 @@ export declare const useLogout: () => import("@tanstack/react-query").UseMutatio
 export declare const useLoginAnonymous: () => import("@tanstack/react-query").UseMutationResult<{
     refreshToken: string;
     user: {
-        status: string;
+        status: "active" | "inactive" | "suspended" | "pending";
         uid: string;
         email: string;
         username: string | null;
@@ -513,7 +513,7 @@ export declare const useLoginAnonymous: () => import("@tanstack/react-query").Us
     channelUid?: string;
 } | undefined, unknown>;
 export declare const useUpgradeAnonymous: () => import("@tanstack/react-query").UseMutationResult<{
-    status: string;
+    status: "active" | "inactive" | "suspended" | "pending";
     uid: string;
     email: string;
     username: string | null;

package/dist/hooks/useContent.d.ts

@@ -1,4 +1,4 @@
-import { UpdateContentRequest, ListContentQuery, ContentDto } from '@ph-cms/api-contract';
+import { UpdateContentRequest, ListContentQuery, ContentDto, ReportContentRequest } from '@ph-cms/api-contract';
 export declare const contentKeys: {
     all: readonly ["contents"];
     lists: () => readonly ["contents", "list"];
@@ -82,3 +82,9 @@ export declare const useUpdateContent: () => import("@tanstack/react-query").Use
     data: UpdateContentRequest;
 }, unknown>;
 export declare const useDeleteContent: () => import("@tanstack/react-query").UseMutationResult<void, Error, string, unknown>;
+export declare const useReportContent: () => import("@tanstack/react-query").UseMutationResult<{
+    message: string;
+}, Error, {
+    uid: string;
+    data: ReportContentRequest;
+}, unknown>;

package/dist/hooks/useContent.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useDeleteContent = exports.useUpdateContent = exports.useToggleLike = exports.useLikeStatus = exports.useCreateContent = exports.useIncrementView = exports.useContentDetail = exports.useContentList = exports.contentKeys = void 0;
+exports.useReportContent = exports.useDeleteContent = exports.useUpdateContent = exports.useToggleLike = exports.useLikeStatus = exports.useCreateContent = exports.useIncrementView = exports.useContentDetail = exports.useContentList = exports.contentKeys = void 0;
 const react_query_1 = require("@tanstack/react-query");
 const context_1 = require("../context");
 exports.contentKeys = {
@@ -177,3 +177,10 @@ const useDeleteContent = () => {
     });
 };
 exports.useDeleteContent = useDeleteContent;
+const useReportContent = () => {
+    const client = (0, context_1.usePHCMS)();
+    return (0, react_query_1.useMutation)({
+        mutationFn: ({ uid, data }) => client.content.report(uid, data),
+    });
+};
+exports.useReportContent = useReportContent;

package/dist/hooks/useUser.d.ts

@@ -1,4 +1,4 @@
-import { ListLikedContentQuery, UpdateUserProfileRequest } from '@ph-cms/api-contract';
+import { ListLikedContentQuery, UpdateUserProfileRequest, BlockUserRequest, SuspendUserRequest } from '@ph-cms/api-contract';
 export declare const termsKeys: {
     all: readonly ["terms"];
     lists: () => readonly ["terms", "list"];
@@ -8,7 +8,7 @@ export declare const termsKeys: {
  */
 export declare const useUser: () => {
     data: {
-        status: string;
+        status: "active" | "inactive" | "suspended" | "pending";
         uid: string;
         email: string;
         username: string | null;
@@ -58,7 +58,7 @@ export declare const useUserProfile: (uid: string) => import("@tanstack/react-qu
  * Typically used by a user to update their own profile.
  */
 export declare const useUpdateProfile: () => import("@tanstack/react-query").UseMutationResult<{
-    status: string;
+    status: "active" | "inactive" | "suspended" | "pending";
     uid: string;
     email: string;
     username: string | null;
@@ -105,6 +105,13 @@ export declare const useLikedContents: (uid: string, params?: Partial<ListLikedC
     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.
  */
@@ -126,3 +133,59 @@ export declare const useAgreeTerms: () => import("@tanstack/react-query").UseMut
     termCodes: string[];
     channelUid?: string;
 }, unknown>;
+/**
+ * Hook to block a user.
+ */
+export declare const useBlockUser: () => import("@tanstack/react-query").UseMutationResult<{
+    message: string;
+    success: boolean;
+}, Error, {
+    uid: string;
+    data?: BlockUserRequest;
+}, unknown>;
+/**
+ * Hook to unblock a user.
+ */
+export declare const useUnblockUser: () => import("@tanstack/react-query").UseMutationResult<{
+    message: string;
+    success: boolean;
+}, Error, string, unknown>;
+/**
+ * Hook to fetch the list of blocked users.
+ */
+export declare const useBlockedUsers: (uid: string, params?: {
+    page?: number;
+    limit?: number;
+}) => import("@tanstack/react-query").UseQueryResult<{
+    items: {
+        uid: string;
+        username: string | null;
+        display_name: string;
+        avatar_url: string | null;
+        reason: string | null;
+        blocked_at: string;
+    }[];
+    total: number;
+    page: number;
+    limit: number;
+    totalPages: number;
+}, Error>;
+/**
+ * Hook to suspend a user (Global Ban).
+ * Admin only.
+ */
+export declare const useSuspendUser: () => import("@tanstack/react-query").UseMutationResult<{
+    message: string;
+    success: boolean;
+}, Error, {
+    uid: string;
+    data?: SuspendUserRequest;
+}, unknown>;
+/**
+ * Hook to unsuspend a user.
+ * Admin only.
+ */
+export declare const useUnsuspendUser: () => import("@tanstack/react-query").UseMutationResult<{
+    message: string;
+    success: boolean;
+}, Error, string, unknown>;

package/dist/hooks/useUser.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useAgreeTerms = exports.useChannelTerms = 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.useUpdateProfile = exports.useUserProfile = exports.useUser = exports.termsKeys = void 0;
 const react_query_1 = require("@tanstack/react-query");
 const context_1 = require("../context");
 exports.termsKeys = {
@@ -55,6 +55,18 @@ const useLikedContents = (uid, params = {}) => {
     });
 };
 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.
  */
@@ -81,3 +93,57 @@ const useAgreeTerms = () => {
     });
 };
 exports.useAgreeTerms = useAgreeTerms;
+/**
+ * Hook to block a user.
+ */
+const useBlockUser = () => {
+    const client = (0, context_1.usePHCMS)();
+    return (0, react_query_1.useMutation)({
+        mutationFn: ({ uid, data }) => client.user.block(uid, data),
+    });
+};
+exports.useBlockUser = useBlockUser;
+/**
+ * Hook to unblock a user.
+ */
+const useUnblockUser = () => {
+    const client = (0, context_1.usePHCMS)();
+    return (0, react_query_1.useMutation)({
+        mutationFn: (uid) => client.user.unblock(uid),
+    });
+};
+exports.useUnblockUser = useUnblockUser;
+/**
+ * Hook to fetch the list of blocked users.
+ */
+const useBlockedUsers = (uid, params = {}) => {
+    const client = (0, context_1.usePHCMS)();
+    return (0, react_query_1.useQuery)({
+        queryKey: ['user-blocked-users', uid, params],
+        queryFn: () => client.user.getBlockedUsers(uid, params),
+        enabled: !!uid,
+    });
+};
+exports.useBlockedUsers = useBlockedUsers;
+/**
+ * Hook to suspend a user (Global Ban).
+ * Admin only.
+ */
+const useSuspendUser = () => {
+    const client = (0, context_1.usePHCMS)();
+    return (0, react_query_1.useMutation)({
+        mutationFn: ({ uid, data }) => client.user.suspend(uid, data),
+    });
+};
+exports.useSuspendUser = useSuspendUser;
+/**
+ * Hook to unsuspend a user.
+ * Admin only.
+ */
+const useUnsuspendUser = () => {
+    const client = (0, context_1.usePHCMS)();
+    return (0, react_query_1.useMutation)({
+        mutationFn: (uid) => client.user.unsuspend(uid),
+    });
+};
+exports.useUnsuspendUser = useUnsuspendUser;

package/dist/modules/content.d.ts

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

package/dist/modules/content.js

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

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, BlockUserRequest, BlockUserResponse, PagedBlockedUserListResponse, SuspendUserRequest, SuspendUserResponse } from "@ph-cms/api-contract";
 import { AxiosInstance } from "axios";
 export declare class UserModule {
     private client;
@@ -28,4 +28,48 @@ 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>;
+    /**
+     * Blocks a user.
+     *
+     * @param uid - The UID of the user to block.
+     * @param data - The block reason (optional).
+     */
+    block(uid: string, data?: BlockUserRequest): Promise<BlockUserResponse>;
+    /**
+     * Unblocks a user.
+     *
+     * @param uid - The UID of the user to unblock.
+     */
+    unblock(uid: string): Promise<BlockUserResponse>;
+    /**
+     * Retrieves the list of blocked users.
+     *
+     * @param uid - The UID of the user (must be self or admin).
+     * @param params - Paging parameters.
+     */
+    getBlockedUsers(uid: string, params?: {
+        page?: number;
+        limit?: number;
+    }): Promise<PagedBlockedUserListResponse>;
+    /**
+     * Suspends a user (Global Ban).
+     * Admin only.
+     *
+     * @param uid - The UID of the user to suspend.
+     * @param data - Optional reason for suspension.
+     */
+    suspend(uid: string, data?: SuspendUserRequest): Promise<SuspendUserResponse>;
+    /**
+     * Unsuspends a user.
+     * Admin only.
+     *
+     * @param uid - The UID of the user to unsuspend.
+     */
+    unsuspend(uid: string): Promise<SuspendUserResponse>;
 }

package/dist/modules/user.js

@@ -44,5 +44,74 @@ 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`);
+    }
+    /**
+     * Blocks a user.
+     *
+     * @param uid - The UID of the user to block.
+     * @param data - The block reason (optional).
+     */
+    async block(uid, data = {}) {
+        if (!uid)
+            throw new errors_1.ValidationError("UID is required", []);
+        const validation = api_contract_1.BlockUserSchema.safeParse(data);
+        if (!validation.success) {
+            throw new errors_1.ValidationError("Invalid block user data", validation.error.errors);
+        }
+        return this.client.post(`${this.prefix}/users/${uid}/block`, data);
+    }
+    /**
+     * Unblocks a user.
+     *
+     * @param uid - The UID of the user to unblock.
+     */
+    async unblock(uid) {
+        if (!uid)
+            throw new errors_1.ValidationError("UID is required", []);
+        return this.client.delete(`${this.prefix}/users/${uid}/block`);
+    }
+    /**
+     * Retrieves the list of blocked users.
+     *
+     * @param uid - The UID of the user (must be self or admin).
+     * @param params - Paging parameters.
+     */
+    async getBlockedUsers(uid, params = {}) {
+        if (!uid)
+            throw new errors_1.ValidationError("UID is required", []);
+        return this.client.get(`${this.prefix}/users/${uid}/blocks`, { params });
+    }
+    /**
+     * Suspends a user (Global Ban).
+     * Admin only.
+     *
+     * @param uid - The UID of the user to suspend.
+     * @param data - Optional reason for suspension.
+     */
+    async suspend(uid, data = {}) {
+        if (!uid)
+            throw new errors_1.ValidationError("UID is required", []);
+        return this.client.post(`${this.prefix}/users/${uid}/suspend`, data);
+    }
+    /**
+     * Unsuspends a user.
+     * Admin only.
+     *
+     * @param uid - The UID of the user to unsuspend.
+     */
+    async unsuspend(uid) {
+        if (!uid)
+            throw new errors_1.ValidationError("UID is required", []);
+        return this.client.delete(`${this.prefix}/users/${uid}/suspend`);
+    }
 }
 exports.UserModule = UserModule;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ph-cms/client-sdk",
-  "version": "0.1.37",
+  "version": "0.1.42",
   "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.19",
     "@tanstack/react-query": "^5.0.0",
     "axios": "^1.6.0",
     "zod": "^3.22.4"