@ph-cms/client-sdk 0.1.42 → 0.1.44

package/README.md

@@ -1,4 +1,4 @@
-# @ph-cms/client-sdk 0.1.42
+# @ph-cms/client-sdk 0.1.44
 
 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 인증 동기화
@@ -100,6 +101,9 @@ import type {
   // Common
   PagedResponse,
   UserProfileDto,
+  IntegratedPlace,
+  PlaceSearchQuery,
+  PlaceSearchResponse,
 } from '@ph-cms/client-sdk';
 ```
 
@@ -107,6 +111,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
@@ -1679,7 +1715,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 +1729,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/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/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/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/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/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/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/types.d.ts

@@ -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.42",
+  "version": "0.1.44",
   "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.21",
     "@tanstack/react-query": "^5.0.0",
     "axios": "^1.6.0",
     "zod": "^3.22.4"