@ph-cms/client-sdk 0.1.19 → 0.1.22

package/README.md

@@ -1240,6 +1240,19 @@ client.terms          // TermsModule
 client.media          // MediaModule
 ```
 
+`apiPrefix`는 생성 시 각 모듈에 직접 주입됩니다. 예를 들어 `apiPrefix: '/v2/api'`로 설정하면 모든 모듈의 요청 URL이 `/v2/api/contents/...`, `/v2/api/auth/...` 형태로 전송됩니다.
+
+```ts
+// 기본값: /api
+const client = new PHCMSClient({ baseURL: 'https://api.example.com' });
+
+// 커스텀 prefix
+const client = new PHCMSClient({
+  baseURL: 'https://api.example.com',
+  apiPrefix: '/v2/api',
+});
+```
+
 ### 커스텀 Axios 인스턴스 사용 (서버 to 서버 등)
 
 인증서(SSL)가 필요하거나 특수한 Agent 설정이 필요한 경우, 직접 생성한 Axios 인스턴스를 주입할 수 있습니다.
@@ -1267,17 +1280,37 @@ const client = new PHCMSClient({
 
 이 경우 React 의존성이 제거된 `/core` 서브패스를 사용하세요.
 
+**`PHCMSClient`를 통해 사용 (권장)**
+
 ```ts
-import { PHCMSClient, ContentModule } from '@ph-cms/client-sdk/core';
+import { PHCMSClient } from '@ph-cms/client-sdk/core';
 
 const client = new PHCMSClient({
   baseURL: 'https://api.ph-cms.com',
+  apiPrefix: '/api', // 생략 시 기본값 '/api'
 });
 
-// 모듈을 직접 사용
+// apiPrefix가 각 모듈에 직접 주입되므로 URL이 올바르게 구성됩니다
 const result = await client.content.list({ channelUid: 'my-channel' });
 ```
 
+**모듈 클래스를 직접 인스턴스화하는 경우**
+
+모듈 생성자의 두 번째 인자로 prefix를 전달합니다.
+
+```ts
+import axios from 'axios';
+import { ContentModule } from '@ph-cms/client-sdk/core';
+
+const axiosInstance = axios.create({ baseURL: 'https://api.ph-cms.com' });
+
+// 두 번째 인자로 prefix 전달 (기본값: '/api')
+const content = new ContentModule(axiosInstance, '/v2/api');
+
+const result = await content.list({ channelUid: 'my-channel' });
+// → GET https://api.ph-cms.com/v2/api/contents
+```
+
 `/core`에서 export되는 항목은 다음과 같습니다 (React 관련 항목 제외):
 
 | 카테고리 | export 항목 |

package/dist/client.d.ts

@@ -35,6 +35,7 @@ export declare class PHCMSClient {
     private refreshQueue;
     /** Exposes the auth provider so UI layers can check token state synchronously. */
     get authProvider(): AuthProvider | undefined;
+    private readonly normalizedApiPrefix;
     constructor(config: PHCMSClientConfig);
     /**
      * If a refresh is already in flight, queue the caller. Otherwise kick

package/dist/client.js

@@ -30,7 +30,8 @@ class PHCMSClient {
          * refresh call finishes.
          */
         this.refreshQueue = [];
-        const normalizedApiPrefix = `/${(config.apiPrefix || '/api').replace(/^\/+|\/+$/g, '')}`;
+        this.normalizedApiPrefix = `/${(config.apiPrefix || '/api').replace(/^\/+|\/+$/g, '')}`;
+        const normalizedApiPrefix = this.normalizedApiPrefix;
         this.axiosInstance = config.axiosInstance || axios_1.default.create({
             baseURL: config.baseURL,
             timeout: config.timeout || 10000,
@@ -44,12 +45,12 @@ class PHCMSClient {
         }
         // Initialize Modules (before interceptors so the refresh wiring
         // can reference `this.auth`).
-        this.auth = new auth_1.AuthModule(this.axiosInstance, config.auth);
-        this.content = new content_1.ContentModule(this.axiosInstance);
-        this.channel = new channel_1.ChannelModule(this.axiosInstance);
-        this.terms = new terms_1.TermsModule(this.axiosInstance);
-        this.media = new media_1.MediaModule(this.axiosInstance);
-        this.user = new user_1.UserModule(this.axiosInstance);
+        this.auth = new auth_1.AuthModule(this.axiosInstance, config.auth, normalizedApiPrefix);
+        this.content = new content_1.ContentModule(this.axiosInstance, normalizedApiPrefix);
+        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.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
         // a direct reference to the AuthModule / axios instance.
@@ -59,26 +60,16 @@ class PHCMSClient {
         // interceptor, avoiding a recursive `getToken()` call.
         if (config.auth) {
             config.auth.setRefreshFn(async (refreshToken) => {
-                const response = await this.axiosInstance.post('/api/auth/refresh', { refreshToken }, { _skipAuth: true });
+                const response = await this.axiosInstance.post(`${normalizedApiPrefix}/auth/refresh`, { refreshToken }, { _skipAuth: true });
                 // The response interceptor unwraps `response.data`, so at
                 // this point `response` is already the data payload.
                 return response;
             });
         }
         // ---------------------------------------------------------------
-        // Request Interceptor: Rewrite API prefix & attach auth token
+        // Request Interceptor: Attach auth token
         // ---------------------------------------------------------------
         this.axiosInstance.interceptors.request.use(async (reqConfig) => {
-            // --- URL rewriting ---
-            if (typeof reqConfig.url === 'string') {
-                if (reqConfig.url === '/api') {
-                    reqConfig.url = normalizedApiPrefix;
-                }
-                else if (reqConfig.url.startsWith('/api/')) {
-                    reqConfig.url = `${normalizedApiPrefix}${reqConfig.url.slice('/api'.length)}`;
-                }
-            }
-            // --- Auth header ---
             // Skip auth for requests explicitly flagged (e.g. refresh calls)
             if (!reqConfig._skipAuth && this.config.auth) {
                 const token = await this.config.auth.getToken();
@@ -154,7 +145,7 @@ class PHCMSClient {
         }
         this.isRefreshing = true;
         try {
-            const result = await this.axiosInstance.post('/api/auth/refresh', { refreshToken }, { _skipAuth: true });
+            const result = await this.axiosInstance.post(`${this.normalizedApiPrefix}/auth/refresh`, { refreshToken }, { _skipAuth: true });
             // Store the new tokens in the provider.
             this.config.auth.setTokens(result.accessToken, result.refreshToken);
             // Resolve all queued callers.

package/dist/modules/auth.d.ts

@@ -4,7 +4,8 @@ import { AuthProvider } from "../auth/interfaces";
 export declare class AuthModule {
     private client;
     private provider?;
-    constructor(client: AxiosInstance, provider?: AuthProvider | undefined);
+    private prefix;
+    constructor(client: AxiosInstance, provider?: AuthProvider | undefined, prefix?: string);
     /**
      * Logs in the user and updates the AuthProvider tokens automatically.
      */

package/dist/modules/auth.js

@@ -4,9 +4,10 @@ exports.AuthModule = void 0;
 const api_contract_1 = require("@ph-cms/api-contract");
 const errors_1 = require("../errors");
 class AuthModule {
-    constructor(client, provider) {
+    constructor(client, provider, prefix = '/api') {
         this.client = client;
         this.provider = provider;
+        this.prefix = prefix;
     }
     /**
      * Logs in the user and updates the AuthProvider tokens automatically.
@@ -16,7 +17,7 @@ class AuthModule {
         if (!validation.success) {
             throw new errors_1.ValidationError("Invalid login data", validation.error.errors);
         }
-        const response = await this.client.post('/api/auth/login', data);
+        const response = await this.client.post(`${this.prefix}/auth/login`, data);
         if (this.provider) {
             this.provider.setTokens(response.accessToken, response.refreshToken);
         }
@@ -30,7 +31,7 @@ class AuthModule {
         if (!validation.success) {
             throw new errors_1.ValidationError("Invalid Firebase token data", validation.error.errors);
         }
-        const response = await this.client.post('/api/auth/firebase/exchange', data);
+        const response = await this.client.post(`${this.prefix}/auth/firebase/exchange`, data);
         if (this.provider) {
             this.provider.setTokens(response.accessToken, response.refreshToken);
         }
@@ -41,31 +42,31 @@ class AuthModule {
         if (!validation.success) {
             throw new errors_1.ValidationError("Invalid register data", validation.error.errors);
         }
-        const response = await this.client.post('/api/auth/register', data);
+        const response = await this.client.post(`${this.prefix}/auth/register`, data);
         if (this.provider) {
             this.provider.setTokens(response.accessToken, response.refreshToken);
         }
         return response;
     }
     async me(params) {
-        return this.client.get('/api/auth/me', { params });
+        return this.client.get(`${this.prefix}/auth/me`, { params });
     }
     async refresh(refreshToken) {
-        return this.client.post('/api/auth/refresh', { refreshToken });
+        return this.client.post(`${this.prefix}/auth/refresh`, { refreshToken });
     }
     async loginAnonymous(data) {
         const validation = api_contract_1.AnonymousLoginSchema.safeParse(data);
         if (!validation.success) {
             throw new errors_1.ValidationError("Invalid anonymous login data", validation.error.errors);
         }
-        const response = await this.client.post('/api/auth/anonymous', data);
+        const response = await this.client.post(`${this.prefix}/auth/anonymous`, data);
         if (this.provider) {
             this.provider.setTokens(response.accessToken, response.refreshToken);
         }
         return response;
     }
     async upgradeAnonymous(data) {
-        return this.client.post('/api/auth/anonymous/upgrade', data);
+        return this.client.post(`${this.prefix}/auth/anonymous/upgrade`, data);
     }
     async logout() {
         if (this.provider) {
@@ -73,7 +74,7 @@ class AuthModule {
         }
         // Call the server endpoint to invalidate the session if applicable.
         // JWT-based auth is stateless, but the server may implement a blacklist.
-        await this.client.post('/api/auth/logout').catch(() => { }); // Ignore error on logout
+        await this.client.post(`${this.prefix}/auth/logout`).catch(() => { }); // Ignore error on logout
     }
 }
 exports.AuthModule = AuthModule;

package/dist/modules/channel.d.ts

@@ -2,7 +2,8 @@ import { ChannelDto, CheckHierarchyQuery } from "@ph-cms/api-contract";
 import { AxiosInstance } from "axios";
 export declare class ChannelModule {
     private client;
-    constructor(client: AxiosInstance);
+    private prefix;
+    constructor(client: AxiosInstance, prefix?: string);
     getByUid(uid: string): Promise<ChannelDto>;
     getBySlug(slug: string): Promise<ChannelDto>;
     update(uid: string, data: any): Promise<ChannelDto>;

package/dist/modules/channel.js

@@ -4,31 +4,32 @@ exports.ChannelModule = void 0;
 const api_contract_1 = require("@ph-cms/api-contract");
 const errors_1 = require("../errors");
 class ChannelModule {
-    constructor(client) {
+    constructor(client, prefix = '/api') {
         this.client = client;
+        this.prefix = prefix;
     }
     async getByUid(uid) {
         if (!uid)
             throw new errors_1.ValidationError("UID is required", []);
-        return this.client.get(`/api/channels/u/${uid}`);
+        return this.client.get(`${this.prefix}/channels/u/${uid}`);
     }
     async getBySlug(slug) {
         if (!slug)
             throw new errors_1.ValidationError("Slug is required", []);
-        return this.client.get(`/api/channels/s/${slug}`);
+        return this.client.get(`${this.prefix}/channels/s/${slug}`);
     }
     async update(uid, data) {
         // TODO: Add schema validation for update channel
         if (!uid)
             throw new errors_1.ValidationError("UID is required", []);
-        return this.client.patch(`/api/channels/u/${uid}`, data);
+        return this.client.patch(`${this.prefix}/channels/u/${uid}`, data);
     }
     async checkHierarchy(params) {
         const validation = api_contract_1.CheckHierarchyQuerySchema.safeParse(params);
         if (!validation.success) {
             throw new errors_1.ValidationError("Invalid check hierarchy params", validation.error.errors);
         }
-        return this.client.get('/api/contents/check-hierarchy', { params });
+        return this.client.get(`${this.prefix}/contents/check-hierarchy`, { params });
     }
 }
 exports.ChannelModule = ChannelModule;

package/dist/modules/content.d.ts

@@ -2,7 +2,8 @@ import { CollectStampRequest, ContentDto, CreateContentRequest, CreateStampTourR
 import { AxiosInstance } from "axios";
 export declare class ContentModule {
     private client;
-    constructor(client: AxiosInstance);
+    private prefix;
+    constructor(client: AxiosInstance, prefix?: string);
     list(params: ListContentQuery): Promise<PagedContentListResponse>;
     get(uid: string): Promise<ContentDto>;
     incrementView(uid: string): Promise<void>;

package/dist/modules/content.js

@@ -4,32 +4,33 @@ exports.ContentModule = void 0;
 const api_contract_1 = require("@ph-cms/api-contract");
 const errors_1 = require("../errors");
 class ContentModule {
-    constructor(client) {
+    constructor(client, prefix = '/api') {
         this.client = client;
+        this.prefix = prefix;
     }
     async list(params) {
         const validation = api_contract_1.ListContentQuerySchema.safeParse(params);
         if (!validation.success) {
             throw new errors_1.ValidationError("Invalid list params", validation.error.errors);
         }
-        return this.client.get('/api/contents', { params });
+        return this.client.get(`${this.prefix}/contents`, { params });
     }
     async get(uid) {
         if (!uid)
             throw new errors_1.ValidationError("UID is required", []);
-        return this.client.get(`/api/contents/${uid}`);
+        return this.client.get(`${this.prefix}/contents/${uid}`);
     }
     async incrementView(uid) {
         if (!uid)
             throw new errors_1.ValidationError("UID is required", []);
-        await this.client.post(`/api/contents/${uid}/view`);
+        await this.client.patch(`${this.prefix}/contents/${uid}/view`);
     }
     async create(data) {
         const validation = api_contract_1.CreateContentSchema.safeParse(data);
         if (!validation.success) {
             throw new errors_1.ValidationError("Invalid create content data", validation.error.errors);
         }
-        return this.client.post('/api/contents', data);
+        return this.client.post(`${this.prefix}/contents`, data);
     }
     async update(uid, data) {
         if (!uid)
@@ -38,19 +39,19 @@ class ContentModule {
         if (!validation.success) {
             throw new errors_1.ValidationError("Invalid update content data", validation.error.errors);
         }
-        return this.client.put(`/api/contents/${uid}`, data);
+        return this.client.put(`${this.prefix}/contents/${uid}`, data);
     }
     async delete(uid) {
         if (!uid)
             throw new errors_1.ValidationError("UID is required", []);
-        return this.client.delete(`/api/contents/${uid}`);
+        return this.client.delete(`${this.prefix}/contents/${uid}`);
     }
     async createStampTour(data) {
         const validation = api_contract_1.CreateStampTourSchema.safeParse(data);
         if (!validation.success) {
             throw new errors_1.ValidationError("Invalid create stamp tour data", validation.error.errors);
         }
-        return this.client.post('/api/contents/stamp-tours', data);
+        return this.client.post(`${this.prefix}/contents/stamp-tours`, data);
     }
     async updateStampTour(uid, data) {
         if (!uid)
@@ -59,7 +60,7 @@ class ContentModule {
         if (!validation.success) {
             throw new errors_1.ValidationError("Invalid update stamp tour data", validation.error.errors);
         }
-        return this.client.put(`/api/contents/stamp-tours/${uid}`, data);
+        return this.client.put(`${this.prefix}/contents/stamp-tours/${uid}`, data);
     }
     async stamp(tourUid, markerUid, data) {
         if (!tourUid || !markerUid)
@@ -68,27 +69,27 @@ class ContentModule {
         if (!validation.success) {
             throw new errors_1.ValidationError("Invalid stamp data", validation.error.errors);
         }
-        return this.client.post(`/api/contents/${tourUid}/stamp/${markerUid}`, data);
+        return this.client.post(`${this.prefix}/contents/${tourUid}/stamp/${markerUid}`, data);
     }
     async getStampStatus(tourUid) {
         if (!tourUid)
             throw new errors_1.ValidationError("tourUid is required", []);
-        return this.client.get(`/api/contents/${tourUid}/stamp-status`);
+        return this.client.get(`${this.prefix}/contents/${tourUid}/stamp-status`);
     }
     async getTourStats(tourUid) {
         if (!tourUid)
             throw new errors_1.ValidationError("tourUid is required", []);
-        return this.client.get(`/api/contents/${tourUid}/stamp-stats`);
+        return this.client.get(`${this.prefix}/contents/${tourUid}/stamp-stats`);
     }
     async toggleLike(uid) {
         if (!uid)
             throw new errors_1.ValidationError("UID is required", []);
-        return this.client.post(`/api/contents/${uid}/like`);
+        return this.client.post(`${this.prefix}/contents/${uid}/like`, {});
     }
     async getLikeStatus(uid) {
         if (!uid)
             throw new errors_1.ValidationError("UID is required", []);
-        return this.client.get(`/api/contents/${uid}/like`);
+        return this.client.get(`${this.prefix}/contents/${uid}/like`);
     }
 }
 exports.ContentModule = ContentModule;

package/dist/modules/media.d.ts

@@ -2,7 +2,8 @@ import { AxiosInstance } from "axios";
 import { MediaUploadTicketBatchRequest, MediaUploadTicketBatchResponse, ContentMediaDto } from "@ph-cms/api-contract";
 export declare class MediaModule {
     private client;
-    constructor(client: AxiosInstance);
+    private prefix;
+    constructor(client: AxiosInstance, prefix?: string);
     /**
      * 미디어 업로드 티켓(Presigned URL) 발급 요청
      */

package/dist/modules/media.js

@@ -8,8 +8,9 @@ const axios_1 = __importDefault(require("axios"));
 const api_contract_1 = require("@ph-cms/api-contract");
 const errors_1 = require("../errors");
 class MediaModule {
-    constructor(client) {
+    constructor(client, prefix = '/api') {
         this.client = client;
+        this.prefix = prefix;
     }
     /**
      * 미디어 업로드 티켓(Presigned URL) 발급 요청
@@ -19,7 +20,7 @@ class MediaModule {
         if (!validation.success) {
             throw new errors_1.ValidationError("Invalid upload ticket request", validation.error.errors);
         }
-        return this.client.post('/api/media/upload-tickets', data);
+        return this.client.post(`${this.prefix}/media/upload-tickets`, data);
     }
     /**
      * 미디어 상세 정보 조회
@@ -27,7 +28,7 @@ class MediaModule {
     async getMedia(uid) {
         if (!uid)
             throw new errors_1.ValidationError("Media UID is required", []);
-        return this.client.get(`/api/media/${uid}`);
+        return this.client.get(`${this.prefix}/media/${uid}`);
     }
     /**
      * S3 Presigned URL을 사용하여 파일 직접 업로드

package/dist/modules/terms.d.ts

@@ -2,7 +2,8 @@ import { AxiosInstance } from "axios";
 import { TermDto } from "@ph-cms/api-contract";
 export declare class TermsModule {
     private client;
-    constructor(client: AxiosInstance);
+    private prefix;
+    constructor(client: AxiosInstance, prefix?: string);
     get(id: number): Promise<TermDto>;
     agree(data: {
         termCodes: string[];

package/dist/modules/terms.js

@@ -2,17 +2,18 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TermsModule = void 0;
 class TermsModule {
-    constructor(client) {
+    constructor(client, prefix = '/api') {
         this.client = client;
+        this.prefix = prefix;
     }
     async get(id) {
-        return this.client.get(`/api/terms/${id}`);
+        return this.client.get(`${this.prefix}/terms/${id}`);
     }
     async agree(data) {
-        await this.client.post('/api/terms/agree', data);
+        await this.client.post(`${this.prefix}/terms/agree`, data);
     }
     async listByChannel(channelUid) {
-        return this.client.get(`/api/terms/channels/${channelUid}`);
+        return this.client.get(`${this.prefix}/terms/channels/${channelUid}`);
     }
 }
 exports.TermsModule = TermsModule;

package/dist/modules/user.d.ts

@@ -2,7 +2,8 @@ import { UpdateUserProfileRequest, UserDto } from "@ph-cms/api-contract";
 import { AxiosInstance } from "axios";
 export declare class UserModule {
     private client;
-    constructor(client: AxiosInstance);
+    private prefix;
+    constructor(client: AxiosInstance, prefix?: string);
     /**
      * Updates a user's profile.
      *

package/dist/modules/user.js

@@ -2,8 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UserModule = void 0;
 class UserModule {
-    constructor(client) {
+    constructor(client, prefix = '/api') {
         this.client = client;
+        this.prefix = prefix;
     }
     /**
      * Updates a user's profile.
@@ -16,7 +17,7 @@ class UserModule {
      * @param data - The update payload.
      */
     async updateProfile(uid, data) {
-        return this.client.patch(`/api/users/${uid}`, data);
+        return this.client.patch(`${this.prefix}/users/${uid}`, data);
     }
 }
 exports.UserModule = UserModule;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ph-cms/client-sdk",
-  "version": "0.1.19",
+  "version": "0.1.22",
   "description": "Unified PH-CMS Client SDK (React + Core)",
   "keywords": [],
   "license": "MIT",