@ph-cms/client-sdk 0.1.43 → 0.1.44

package/README.md

@@ -1,4 +1,4 @@
-# @ph-cms/client-sdk 0.1.43
+# @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

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/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/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.43",
+  "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.20",
+    "@ph-cms/api-contract": "^0.1.21",
     "@tanstack/react-query": "^5.0.0",
     "axios": "^1.6.0",
     "zod": "^3.22.4"