@ph-cms/client-sdk 0.1.42 → 0.1.43

package/README.md

@@ -1,4 +1,4 @@
-# @ph-cms/client-sdk 0.1.42
+# @ph-cms/client-sdk 0.1.43
 
 PH-CMS 클라이언트 SDK — 브라우저 및 React 애플리케이션을 위한 통합 클라이언트.
 
@@ -1679,7 +1679,7 @@ const result = await content.list({ channelUid: 'my-channel' });
 | 메서드 | 설명 |
 |---|---|
 | `list(query: ListContentQuery)` | 콘텐츠 목록 조회 → `PagedContentListResponse` |
-| `get(uid: string)` | 단일 콘텐츠 상세 조회 → `ContentDto` |
+| `get(uid: string, params?: { withParent?: boolean; withDetail?: boolean })` | 단일 콘텐츠 상세 조회 → `ContentDto` |
 | `create(data: CreateContentRequest)` | 일반 콘텐츠 생성 → `ContentDto` |
 | `update(uid: string, data: UpdateContentRequest)` | 콘텐츠 수정 → `ContentDto` |
 | `delete(uid: string)` | 콘텐츠 삭제 |
@@ -1693,6 +1693,13 @@ const result = await content.list({ channelUid: 'my-channel' });
 | `getLikers(uid: string, params?: Partial<ListLikersQuery>)` | 콘텐츠에 좋아요 누른 사용자 목록 조회 → `PagedResponse<UserProfileDto>` |
 | `report(uid: string, data: ReportContentRequest)` | 콘텐츠 신고 → `ReportContentResponse` |
 
+예시:
+
+```ts
+await client.content.list({ withParent: true, withDetail: true, page: 1, limit: 20 });
+await client.content.get('cnt_123', { withParent: true, withDetail: true });
+```
+
 ### `ChannelModule` (`client.channel`)
 
 | 메서드 | 설명 |

package/dist/hooks/useContent.d.ts

@@ -9,6 +9,8 @@ export declare const contentKeys: {
         type?: string | undefined;
         channelUid?: string | undefined;
         channelSlug?: string | undefined;
+        withDetail?: boolean | undefined;
+        withParent?: boolean | undefined;
         tags?: string[] | undefined;
         parentUid?: string | undefined;
         authorUid?: string | undefined;
@@ -17,11 +19,17 @@ export declare const contentKeys: {
         keyword?: string | undefined;
         orderBy?: "title" | "created_at" | "updated_at" | "published_at" | "view_count" | "like_count" | undefined;
         orderDir?: "asc" | "desc" | undefined;
-        withDetail?: boolean | undefined;
         includeDeleted?: boolean | undefined;
     }];
     details: () => readonly ["contents", "detail"];
-    detail: (uid: string) => readonly ["contents", "detail", string];
+    detailPrefix: (uid: string) => readonly ["contents", "detail", string];
+    detail: (uid: string, params?: {
+        withParent?: boolean;
+        withDetail?: boolean;
+    }) => readonly ["contents", "detail", string, {
+        withParent?: boolean;
+        withDetail?: boolean;
+    }];
     likes: () => readonly ["contents", "like"];
     like: (uid: string) => readonly ["contents", "like", string];
 };
@@ -35,7 +43,10 @@ export declare const useContentList: (params: ListContentQuery, enabled?: boolea
     last: boolean;
     empty: boolean;
 }, Error>;
-export declare const useContentDetail: (uid: string) => import("@tanstack/react-query").UseQueryResult<ContentDto, Error>;
+export declare const useContentDetail: (uid: string, params?: {
+    withParent?: boolean;
+    withDetail?: boolean;
+}) => import("@tanstack/react-query").UseQueryResult<ContentDto, Error>;
 export declare const useIncrementView: () => import("@tanstack/react-query").UseMutationResult<void, Error, string, {
     previousDetail: ContentDto | undefined;
     uid: string;

package/dist/hooks/useContent.js

@@ -8,7 +8,8 @@ exports.contentKeys = {
     lists: () => [...exports.contentKeys.all, 'list'],
     list: (params) => [...exports.contentKeys.lists(), params],
     details: () => [...exports.contentKeys.all, 'detail'],
-    detail: (uid) => [...exports.contentKeys.details(), uid],
+    detailPrefix: (uid) => [...exports.contentKeys.details(), uid],
+    detail: (uid, params) => [...exports.contentKeys.details(), uid, params ?? {}],
     likes: () => [...exports.contentKeys.all, 'like'],
     like: (uid) => [...exports.contentKeys.likes(), uid],
 };
@@ -27,11 +28,11 @@ const useContentList = (params, enabled = true) => {
     });
 };
 exports.useContentList = useContentList;
-const useContentDetail = (uid) => {
+const useContentDetail = (uid, params) => {
     const client = (0, context_1.usePHCMS)();
     return (0, react_query_1.useQuery)({
-        queryKey: exports.contentKeys.detail(uid),
-        queryFn: () => client.content.get(uid),
+        queryKey: exports.contentKeys.detail(uid, params),
+        queryFn: () => client.content.get(uid, params),
         enabled: !!uid,
     });
 };
@@ -43,7 +44,7 @@ const useIncrementView = () => {
         mutationFn: (uid) => client.content.incrementView(uid),
         onMutate: async (uid) => {
             // Cancel any outgoing refetches for the content detail
-            await queryClient.cancelQueries({ queryKey: exports.contentKeys.detail(uid) });
+            await queryClient.cancelQueries({ queryKey: exports.contentKeys.detailPrefix(uid) });
             // Snapshot the previous detail
             const previousDetail = queryClient.getQueryData(exports.contentKeys.detail(uid));
             // Optimistically update the view count in the detail cache
@@ -99,7 +100,7 @@ const useToggleLike = () => {
         onMutate: async (uid) => {
             // Cancel any outgoing refetches so they don't overwrite our optimistic update
             await queryClient.cancelQueries({ queryKey: exports.contentKeys.like(uid) });
-            await queryClient.cancelQueries({ queryKey: exports.contentKeys.detail(uid) });
+            await queryClient.cancelQueries({ queryKey: exports.contentKeys.detailPrefix(uid) });
             // Snapshot the previous values
             const previousLikeStatus = queryClient.getQueryData(exports.contentKeys.like(uid));
             const previousDetail = queryClient.getQueryData(exports.contentKeys.detail(uid));
@@ -161,6 +162,7 @@ const useUpdateContent = () => {
         mutationFn: ({ uid, data }) => client.content.update(uid, data),
         onSuccess: (data, variables) => {
             queryClient.invalidateQueries({ queryKey: exports.contentKeys.detail(variables.uid) });
+            queryClient.invalidateQueries({ queryKey: exports.contentKeys.detailPrefix(variables.uid) });
             queryClient.invalidateQueries({ queryKey: exports.contentKeys.lists() });
         },
     });

package/dist/modules/content.d.ts

@@ -5,7 +5,10 @@ export declare class ContentModule {
     private prefix;
     constructor(client: AxiosInstance, prefix?: string);
     list(params: ListContentQuery): Promise<PagedContentListResponse>;
-    get(uid: string): Promise<ContentDto>;
+    get(uid: string, params?: {
+        withParent?: boolean;
+        withDetail?: boolean;
+    }): Promise<ContentDto>;
     incrementView(uid: string): Promise<void>;
     create(data: CreateContentRequest): Promise<ContentDto>;
     update(uid: string, data: UpdateContentRequest): Promise<ContentDto>;

package/dist/modules/content.js

@@ -15,10 +15,10 @@ class ContentModule {
         }
         return this.client.get(`${this.prefix}/contents`, { params });
     }
-    async get(uid) {
+    async get(uid, params) {
         if (!uid)
             throw new errors_1.ValidationError("UID is required", []);
-        return this.client.get(`${this.prefix}/contents/${uid}`);
+        return this.client.get(`${this.prefix}/contents/${uid}`, { params });
     }
     async incrementView(uid) {
         if (!uid)

package/package.json

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