@ph-cms/client-sdk 0.1.12 → 0.1.14

package/README.md

@@ -56,10 +56,7 @@ import type {
 
   // Channel
   ChannelDto,
-  CreateChannelDto,
-  ListChannelQuery,
   CheckHierarchyQuery,
-  PagedChannelListResponse,
 
   // Content
   ContentDto,
@@ -77,12 +74,9 @@ import type {
 
   // Terms
   TermDto,
-  ListTermsQuery,
-  PagedTermListResponse,
 
   // Geo
   GeoJSON,
-  BoundsQuery,
 
   // Media
   MediaUploadTicketRequest,
@@ -544,9 +538,11 @@ function ProfileEditor({ userUid }) {
 }
 ```
 
-### Standalone (Non-React) Usage
+## Using API Directly (Without Hooks)
 
-React 없이 `PHCMSClient`를 직접 사용할 수 있습니다.
+React Hook을 사용하지 않는 환경(Vanilla JS, Node.js, 또는 React 컴포넌트 외부)에서도 `PHCMSClient`를 직접 사용하여 모든 기능을 이용할 수 있습니다.
+
+### 1. Client 초기화
 
 ```ts
 import { PHCMSClient, LocalAuthProvider } from '@ph-cms/client-sdk';
@@ -556,27 +552,71 @@ const client = new PHCMSClient({
   baseURL: 'https://api.example.com',
   auth: authProvider,
 });
+```
 
-// 로그인 — provider에 토큰이 자동 저장됨
+### 2. 인증 및 사용자 정보
+
+```ts
+// 로그인 (토큰은 provider에 자동 저장됨)
 const authResponse = await client.auth.login({
   email: 'user@example.com',
   password: 'password',
 });
 
-// 프로필 조회
-const me = await client.auth.me();
-console.log(me.email);
+// 현재 사용자 프로필 조회
+// channelUid를 넘기면 해당 채널에 대한 약관 준수 상태 등이 포함됩니다.
+const me = await client.auth.me({ channelUid: 'my-channel-uid' });
+console.log(`Hello, ${me.display_name}`);
+
+// 로그아웃
+await client.auth.logout();
+```
+
+### 3. 콘텐츠 및 채널 관리
+
+```ts
+// 콘텐츠 목록 조회
+const posts = await client.content.list({
+  channelUid: 'my-channel-uid',
+  type: 'post',
+  limit: 10
+});
+
+// 콘텐츠 상세 조회
+const detail = await client.content.get('content-uid');
+
+// 채널 정보 조회
+const channel = await client.channel.getBySlug('my-channel-slug');
+```
+
+### 4. 약관 동의
+
+```ts
+// 채널별 약관 목록 조회
+const terms = await client.terms.listByChannel('my-channel-uid');
+
+// 약관 동의 제출
+await client.terms.agree({
+  channelUid: 'my-channel-uid',
+  termCodes: ['service_terms_v1', 'privacy_policy_v1']
+});
+```
+
+### 5. 토큰 수동 관리 (선택 사항)
+
+일반적으로 SDK가 가로채기(Interceptor)를 통해 토큰을 자동으로 관리하지만, 직접 제어해야 할 경우 다음과 같이 사용합니다.
 
-// 토큰 갱신 (수동)
-// 일반적으로 SDK가 자동으로 처리하지만, 필요 시 직접 호출 가능
+```ts
+// 현재 저장된 리프레시 토큰 가져오기
 const refreshToken = authProvider.getRefreshToken();
+
 if (refreshToken) {
+  // 토큰 갱신 요청
   const newTokens = await client.auth.refresh(refreshToken);
+  
+  // 새 토큰 저장
   authProvider.setTokens(newTokens.accessToken, newTokens.refreshToken);
 }
-
-// 로그아웃
-await client.auth.logout();
 ```
 
 ### Legacy Hooks
@@ -711,10 +751,13 @@ function App() {
 
 ### Content
 
+`useContentList`, `useCreateContent` 등 콘텐츠 관련 훅은 `PHCMSProvider`에 설정된 `channelUid`를 자동으로 사용합니다.
+
 ```tsx
-import { useContentList, useContentDetail } from '@ph-cms/client-sdk';
+import { useContentList } from '@ph-cms/client-sdk';
 
 function ContentList() {
+  // channelUid를 직접 넘기지 않아도 컨텍스트의 값을 사용합니다.
   const { data, isLoading } = useContentList({ limit: 10 });
 
   if (isLoading) return <div>Loading...</div>;
@@ -729,17 +772,6 @@ function ContentList() {
 }
 ```
 
-### Channel
-
-```tsx
-import { useChannelList } from '@ph-cms/client-sdk';
-
-function ChannelList() {
-  const { data, isLoading } = useChannelList({ limit: 20 });
-  // ...
-}
-```
-
 ---
 
 ## Like (좋아요)
@@ -1063,8 +1095,6 @@ try {
 
 ---
 
-## API Reference
-
 ### `PHCMSClient`
 
 ```ts
@@ -1073,6 +1103,7 @@ const client = new PHCMSClient({
   apiPrefix?: string;    // API 경로 접두사 (기본값: '/api')
   auth?: AuthProvider;   // 인증 프로바이더
   timeout?: number;      // 요청 타임아웃 ms (기본값: 10000)
+  axiosInstance?: AxiosInstance; // 직접 커스터마이징한 Axios 인스턴스 (선택 사항)
 });
 
 client.authProvider   // AuthProvider | undefined
@@ -1085,6 +1116,27 @@ client.terms          // TermsModule
 client.media          // MediaModule
 ```
 
+### 커스텀 Axios 인스턴스 사용 (서버 to 서버 등)
+
+인증서(SSL)가 필요하거나 특수한 Agent 설정이 필요한 경우, 직접 생성한 Axios 인스턴스를 주입할 수 있습니다.
+
+```ts
+import axios from 'axios';
+import https from 'https';
+import { PHCMSClient } from '@ph-cms/client-sdk';
+
+const customInstance = axios.create({
+  httpsAgent: new https.Agent({
+    rejectUnauthorized: false, // 혹은 인증서 설정
+  }),
+});
+
+const client = new PHCMSClient({
+  baseURL: 'https://internal-api.ph-cms.com',
+  axiosInstance: customInstance,
+});
+```
+
 ### `UserModule` (`client.user`)
 
 | 메서드 | 설명 |
@@ -1098,7 +1150,7 @@ client.media          // MediaModule
 | `login(data: LoginRequest)` | 이메일/비밀번호 로그인 → `AuthResponse` |
 | `loginWithFirebase(data: FirebaseExchangeRequest)` | Firebase ID 토큰 교환 → `AuthResponse` |
 | `register(data: RegisterRequest)` | 회원가입 → `AuthResponse` |
-| `me()` | 현재 사용자 프로필 조회 → `UserDto` |
+| `me(params?: { channelUid?: string })` | 현재 사용자 프로필 조회 → `UserDto` |
 | `refresh(refreshToken: string)` | 토큰 갱신 → `{ accessToken, refreshToken }` |
 | `logout()` | 로그아웃 (프로바이더 토큰 삭제 + 서버 세션 무효화) |
 
@@ -1119,6 +1171,23 @@ client.media          // MediaModule
 | `toggleLike(uid: string)` | 좋아요 토글 → `ToggleLikeResponse` |
 | `getLikeStatus(uid: string)` | 내 좋아요 여부 확인 → `LikeStatusResponse` |
 
+### `ChannelModule` (`client.channel`)
+
+| 메서드 | 설명 |
+|---|---|
+| `getByUid(uid: string)` | UID로 채널 상세 조회 |
+| `getBySlug(slug: string)` | 슬러그로 채널 상세 조회 |
+| `update(uid: string, data: any)` | 채널 정보 수정 |
+| `checkHierarchy(params: CheckHierarchyQuery)` | 하이어라키 규칙 체크 |
+
+### `TermsModule` (`client.terms`)
+
+| 메서드 | 설명 |
+|---|---|
+| `get(id: number)` | 약관 상세 조회 |
+| `agree(data: { termCodes: string[]; channelUid?: string })` | 약관 동의 제출 |
+| `listByChannel(channelUid: string)` | 채널별 약관 목록 조회 |
+
 ### JWT Utilities
 
 클라이언트에서 토큰 상태를 확인할 수 있는 유틸리티입니다 (서명 검증은 하지 않음).

package/dist/client.d.ts

@@ -11,6 +11,7 @@ export interface PHCMSClientConfig {
     apiPrefix?: string;
     auth?: AuthProvider;
     timeout?: number;
+    axiosInstance?: AxiosInstance;
 }
 export declare class PHCMSClient {
     private config;

package/dist/client.js

@@ -31,13 +31,17 @@ class PHCMSClient {
          */
         this.refreshQueue = [];
         const normalizedApiPrefix = `/${(config.apiPrefix || '/api').replace(/^\/+|\/+$/g, '')}`;
-        this.axiosInstance = axios_1.default.create({
+        this.axiosInstance = config.axiosInstance || axios_1.default.create({
             baseURL: config.baseURL,
             timeout: config.timeout || 10000,
             headers: {
                 'Content-Type': 'application/json',
             },
         });
+        // Ensure baseURL is set if provided, even on a pre-existing instance.
+        if (config.baseURL && !this.axiosInstance.defaults.baseURL) {
+            this.axiosInstance.defaults.baseURL = config.baseURL;
+        }
         // Initialize Modules (before interceptors so the refresh wiring
         // can reference `this.auth`).
         this.auth = new auth_1.AuthModule(this.axiosInstance, config.auth);

package/dist/context.d.ts

@@ -10,7 +10,7 @@ export interface PHCMSContextType {
     isLoading: boolean;
     isError: boolean;
     /** The current channel context for terms compliance. */
-    channelUid?: string;
+    channelUid: string;
     /**
      * Fine-grained authentication status.
      * - `'loading'`: Token exists, `/auth/me` is being fetched.
@@ -26,7 +26,7 @@ export interface PHCMSContextType {
 export interface PHCMSProviderProps {
     client: PHCMSClient;
     queryClient?: QueryClient;
-    channelUid?: string;
+    channelUid: string;
     children: ReactNode;
 }
 /**

package/dist/context.js

@@ -43,6 +43,10 @@ const AUTH_ME_QUERY_KEY = ['auth', 'me'];
  */
 const PHCMSInternalProvider = ({ client, channelUid, children }) => {
     const queryClient = (0, react_query_1.useQueryClient)();
+    // Check for channel identifier
+    if (!channelUid) {
+        throw new Error('PHCMSProvider requires channelUid');
+    }
     // Track token presence in state to trigger re-renders when it changes.
     // Initial value from provider.
     const [hasToken, setHasToken] = (0, react_1.useState)(() => client.authProvider?.hasToken() ?? false);

package/dist/hooks/useAuth.d.ts

@@ -113,6 +113,7 @@ export declare const useAuth: () => {
         accessToken: string;
     }, Error, {
         idToken: string;
+        channelUid?: string | undefined;
     }, unknown>;
     register: import("@tanstack/react-query").UseMutateAsyncFunction<{
         refreshToken: string;
@@ -159,6 +160,81 @@ export declare const useAuth: () => {
         termCodes?: string[] | undefined;
         channelUid?: string | undefined;
     }, unknown>;
+    loginAnonymous: import("@tanstack/react-query").UseMutateAsyncFunction<{
+        refreshToken: string;
+        user: {
+            status: string;
+            uid: string;
+            email: string;
+            username: string | null;
+            display_name: string;
+            avatar_url: string | null;
+            phone_number: string | null;
+            email_verified_at: string | null;
+            phone_verified_at: string | null;
+            locale: string;
+            timezone: string;
+            role: string[];
+            profile_data: Record<string, any>;
+            last_login_at: string | null;
+            created_at: string;
+            updated_at: string;
+            channel_agreements?: {
+                channel_uid: string | null;
+                is_fully_compliant: boolean;
+                agreements: {
+                    code: string;
+                    version: string;
+                    title: string;
+                    term_id: number;
+                    is_agreed: boolean;
+                    is_required: boolean;
+                    is_latest: boolean;
+                    agreed_at: string | null;
+                }[];
+            }[] | undefined;
+        };
+        accessToken: string;
+    }, Error, {
+        channelUid?: string;
+    } | undefined, unknown>;
+    upgradeAnonymous: import("@tanstack/react-query").UseMutateAsyncFunction<{
+        status: string;
+        uid: string;
+        email: string;
+        username: string | null;
+        display_name: string;
+        avatar_url: string | null;
+        phone_number: string | null;
+        email_verified_at: string | null;
+        phone_verified_at: string | null;
+        locale: string;
+        timezone: string;
+        role: string[];
+        profile_data: Record<string, any>;
+        last_login_at: string | null;
+        created_at: string;
+        updated_at: string;
+        channel_agreements?: {
+            channel_uid: string | null;
+            is_fully_compliant: boolean;
+            agreements: {
+                code: string;
+                version: string;
+                title: string;
+                term_id: number;
+                is_agreed: boolean;
+                is_required: boolean;
+                is_latest: boolean;
+                agreed_at: string | null;
+            }[];
+        }[] | undefined;
+    }, Error, {
+        email: string;
+        password: string;
+        display_name?: string;
+        username?: string;
+    }, unknown>;
     logout: import("@tanstack/react-query").UseMutateAsyncFunction<void, Error, void, unknown>;
     loginStatus: import("@tanstack/react-query").UseMutationResult<{
         refreshToken: string;
@@ -236,6 +312,7 @@ export declare const useAuth: () => {
         accessToken: string;
     }, Error, {
         idToken: string;
+        channelUid?: string | undefined;
     }, unknown>;
     registerStatus: import("@tanstack/react-query").UseMutationResult<{
         refreshToken: string;
@@ -282,10 +359,45 @@ export declare const useAuth: () => {
         termCodes?: string[] | undefined;
         channelUid?: string | undefined;
     }, unknown>;
-    logoutStatus: import("@tanstack/react-query").UseMutationResult<void, Error, void, unknown>;
-};
-export declare const useUser: () => {
-    data: {
+    loginAnonymousStatus: import("@tanstack/react-query").UseMutationResult<{
+        refreshToken: string;
+        user: {
+            status: string;
+            uid: string;
+            email: string;
+            username: string | null;
+            display_name: string;
+            avatar_url: string | null;
+            phone_number: string | null;
+            email_verified_at: string | null;
+            phone_verified_at: string | null;
+            locale: string;
+            timezone: string;
+            role: string[];
+            profile_data: Record<string, any>;
+            last_login_at: string | null;
+            created_at: string;
+            updated_at: string;
+            channel_agreements?: {
+                channel_uid: string | null;
+                is_fully_compliant: boolean;
+                agreements: {
+                    code: string;
+                    version: string;
+                    title: string;
+                    term_id: number;
+                    is_agreed: boolean;
+                    is_required: boolean;
+                    is_latest: boolean;
+                    agreed_at: string | null;
+                }[];
+            }[] | undefined;
+        };
+        accessToken: string;
+    }, Error, {
+        channelUid?: string;
+    } | undefined, unknown>;
+    upgradeAnonymousStatus: import("@tanstack/react-query").UseMutationResult<{
         status: string;
         uid: string;
         email: string;
@@ -316,10 +428,13 @@ export declare const useUser: () => {
                 agreed_at: string | null;
             }[];
         }[] | undefined;
-    } | null;
-    isLoading: boolean;
-    isAuthenticated: boolean;
-    error: boolean;
+    }, Error, {
+        email: string;
+        password: string;
+        display_name?: string;
+        username?: string;
+    }, unknown>;
+    logoutStatus: import("@tanstack/react-query").UseMutationResult<void, Error, void, unknown>;
 };
 export declare const useLogin: () => import("@tanstack/react-query").UseMutationResult<{
     refreshToken: string;
@@ -361,3 +476,78 @@ export declare const useLogin: () => import("@tanstack/react-query").UseMutation
     password: string;
 }, unknown>;
 export declare const useLogout: () => import("@tanstack/react-query").UseMutationResult<void, Error, void, unknown>;
+export declare const useLoginAnonymous: () => import("@tanstack/react-query").UseMutationResult<{
+    refreshToken: string;
+    user: {
+        status: string;
+        uid: string;
+        email: string;
+        username: string | null;
+        display_name: string;
+        avatar_url: string | null;
+        phone_number: string | null;
+        email_verified_at: string | null;
+        phone_verified_at: string | null;
+        locale: string;
+        timezone: string;
+        role: string[];
+        profile_data: Record<string, any>;
+        last_login_at: string | null;
+        created_at: string;
+        updated_at: string;
+        channel_agreements?: {
+            channel_uid: string | null;
+            is_fully_compliant: boolean;
+            agreements: {
+                code: string;
+                version: string;
+                title: string;
+                term_id: number;
+                is_agreed: boolean;
+                is_required: boolean;
+                is_latest: boolean;
+                agreed_at: string | null;
+            }[];
+        }[] | undefined;
+    };
+    accessToken: string;
+}, Error, {
+    channelUid?: string;
+} | undefined, unknown>;
+export declare const useUpgradeAnonymous: () => import("@tanstack/react-query").UseMutationResult<{
+    status: string;
+    uid: string;
+    email: string;
+    username: string | null;
+    display_name: string;
+    avatar_url: string | null;
+    phone_number: string | null;
+    email_verified_at: string | null;
+    phone_verified_at: string | null;
+    locale: string;
+    timezone: string;
+    role: string[];
+    profile_data: Record<string, any>;
+    last_login_at: string | null;
+    created_at: string;
+    updated_at: string;
+    channel_agreements?: {
+        channel_uid: string | null;
+        is_fully_compliant: boolean;
+        agreements: {
+            code: string;
+            version: string;
+            title: string;
+            term_id: number;
+            is_agreed: boolean;
+            is_required: boolean;
+            is_latest: boolean;
+            agreed_at: string | null;
+        }[];
+    }[] | undefined;
+}, Error, {
+    email: string;
+    password: string;
+    display_name?: string;
+    username?: string;
+}, unknown>;

package/dist/hooks/useAuth.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useLogout = exports.useLogin = exports.useUser = exports.useAuth = void 0;
+exports.useUpgradeAnonymous = exports.useLoginAnonymous = exports.useLogout = exports.useLogin = exports.useAuth = void 0;
 const react_query_1 = require("@tanstack/react-query");
 const context_1 = require("../context");
 const AUTH_ME_QUERY_KEY = ['auth', 'me'];
@@ -9,7 +9,7 @@ const AUTH_ME_QUERY_KEY = ['auth', 'me'];
  * Returns both the current auth status and the actions.
  */
 const useAuth = () => {
-    const { user, isAuthenticated, isLoading, refreshUser } = (0, context_1.usePHCMSContext)();
+    const { user, isAuthenticated, isLoading, refreshUser, channelUid } = (0, context_1.usePHCMSContext)();
     const client = (0, context_1.usePHCMS)();
     const queryClient = (0, react_query_1.useQueryClient)();
     const loginMutation = (0, react_query_1.useMutation)({
@@ -19,13 +19,34 @@ const useAuth = () => {
         },
     });
     const loginWithFirebaseMutation = (0, react_query_1.useMutation)({
-        mutationFn: (data) => client.auth.loginWithFirebase(data),
+        mutationFn: (data) => client.auth.loginWithFirebase({
+            channelUid: data.channelUid || channelUid,
+            ...data
+        }),
         onSuccess: async () => {
             await refreshUser();
         },
     });
     const registerMutation = (0, react_query_1.useMutation)({
-        mutationFn: (data) => client.auth.register(data),
+        mutationFn: (data) => client.auth.register({
+            channelUid: data.channelUid || channelUid,
+            ...data
+        }),
+        onSuccess: async () => {
+            await refreshUser();
+        },
+    });
+    const loginAnonymousMutation = (0, react_query_1.useMutation)({
+        mutationFn: (data) => client.auth.loginAnonymous({
+            channelUid: data?.channelUid || channelUid,
+            ...data
+        }),
+        onSuccess: async () => {
+            await refreshUser();
+        },
+    });
+    const upgradeAnonymousMutation = (0, react_query_1.useMutation)({
+        mutationFn: (data) => client.auth.upgradeAnonymous(data),
         onSuccess: async () => {
             await refreshUser();
         },
@@ -44,21 +65,19 @@ const useAuth = () => {
         login: loginMutation.mutateAsync,
         loginWithFirebase: loginWithFirebaseMutation.mutateAsync,
         register: registerMutation.mutateAsync,
+        loginAnonymous: loginAnonymousMutation.mutateAsync,
+        upgradeAnonymous: upgradeAnonymousMutation.mutateAsync,
         logout: logoutMutation.mutateAsync,
         // Access to mutation objects for loading/error states if needed
         loginStatus: loginMutation,
         loginWithFirebaseStatus: loginWithFirebaseMutation,
         registerStatus: registerMutation,
+        loginAnonymousStatus: loginAnonymousMutation,
+        upgradeAnonymousStatus: upgradeAnonymousMutation,
         logoutStatus: logoutMutation,
     };
 };
 exports.useAuth = useAuth;
-// Keep individual hooks for backward compatibility or more specific use cases
-const useUser = () => {
-    const { user, isLoading, isAuthenticated, isError } = (0, context_1.usePHCMSContext)();
-    return { data: user, isLoading, isAuthenticated, error: isError };
-};
-exports.useUser = useUser;
 const useLogin = () => {
     const { loginStatus } = (0, exports.useAuth)();
     return loginStatus;
@@ -69,3 +88,13 @@ const useLogout = () => {
     return logoutStatus;
 };
 exports.useLogout = useLogout;
+const useLoginAnonymous = () => {
+    const { loginAnonymousStatus } = (0, exports.useAuth)();
+    return loginAnonymousStatus;
+};
+exports.useLoginAnonymous = useLoginAnonymous;
+const useUpgradeAnonymous = () => {
+    const { upgradeAnonymousStatus } = (0, exports.useAuth)();
+    return upgradeAnonymousStatus;
+};
+exports.useUpgradeAnonymous = useUpgradeAnonymous;

package/dist/hooks/useContent.d.ts

@@ -1,4 +1,4 @@
-import { UpdateContentRequest, ListContentQuery, ContentDto, BoundsQuery } from '@ph-cms/api-contract';
+import { UpdateContentRequest, ListContentQuery, ContentDto } from '@ph-cms/api-contract';
 export declare const contentKeys: {
     all: readonly ["contents"];
     lists: () => readonly ["contents", "list"];
@@ -20,13 +20,6 @@ export declare const contentKeys: {
         withDetail?: boolean | undefined;
         includeDeleted?: boolean | undefined;
     }];
-    geoLists: () => readonly ["contents", "geo-list"];
-    geoList: (bounds: BoundsQuery) => readonly ["contents", "geo-list", {
-        minLat: number;
-        maxLat: number;
-        minLng: number;
-        maxLng: number;
-    }];
     details: () => readonly ["contents", "detail"];
     detail: (uid: string) => readonly ["contents", "detail", string];
     likes: () => readonly ["contents", "like"];
@@ -42,7 +35,6 @@ export declare const useContentList: (params: ListContentQuery, enabled?: boolea
     last: boolean;
     empty: boolean;
 }, Error>;
-export declare const useContentGeoList: (bounds: BoundsQuery) => import("@tanstack/react-query").UseQueryResult<ContentDto[], Error>;
 export declare const useContentDetail: (uid: string) => import("@tanstack/react-query").UseQueryResult<ContentDto, Error>;
 export declare const useIncrementView: () => import("@tanstack/react-query").UseMutationResult<void, Error, string, {
     previousDetail: ContentDto | undefined;

package/dist/hooks/useContent.js

@@ -1,14 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useDeleteContent = exports.useUpdateContent = exports.useToggleLike = exports.useLikeStatus = exports.useCreateContent = exports.useIncrementView = exports.useContentDetail = exports.useContentGeoList = exports.useContentList = exports.contentKeys = void 0;
+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 = {
     all: ['contents'],
     lists: () => [...exports.contentKeys.all, 'list'],
     list: (params) => [...exports.contentKeys.lists(), params],
-    geoLists: () => [...exports.contentKeys.all, 'geo-list'],
-    geoList: (bounds) => [...exports.contentKeys.geoLists(), bounds],
     details: () => [...exports.contentKeys.all, 'detail'],
     detail: (uid) => [...exports.contentKeys.details(), uid],
     likes: () => [...exports.contentKeys.all, 'like'],
@@ -16,23 +14,19 @@ exports.contentKeys = {
 };
 const useContentList = (params, enabled = true) => {
     const client = (0, context_1.usePHCMS)();
+    const { channelUid } = (0, context_1.usePHCMSContext)();
+    const finalParams = {
+        channelUid: params.channelUid || channelUid,
+        ...params,
+    };
     return (0, react_query_1.useQuery)({
-        queryKey: exports.contentKeys.list(params),
-        queryFn: () => client.content.list(params),
+        queryKey: exports.contentKeys.list(finalParams),
+        queryFn: () => client.content.list(finalParams),
         staleTime: 1000 * 60, // 1 minute
         enabled,
     });
 };
 exports.useContentList = useContentList;
-const useContentGeoList = (bounds) => {
-    const client = (0, context_1.usePHCMS)();
-    return (0, react_query_1.useQuery)({
-        queryKey: exports.contentKeys.geoList(bounds),
-        queryFn: () => client.content.listGeo(bounds),
-        enabled: !!(bounds.minLat && bounds.maxLat && bounds.minLng && bounds.maxLng),
-    });
-};
-exports.useContentGeoList = useContentGeoList;
 const useContentDetail = (uid) => {
     const client = (0, context_1.usePHCMS)();
     return (0, react_query_1.useQuery)({
@@ -75,9 +69,13 @@ const useIncrementView = () => {
 exports.useIncrementView = useIncrementView;
 const useCreateContent = () => {
     const client = (0, context_1.usePHCMS)();
+    const { channelUid } = (0, context_1.usePHCMSContext)();
     const queryClient = (0, react_query_1.useQueryClient)();
     return (0, react_query_1.useMutation)({
-        mutationFn: (data) => client.content.create(data),
+        mutationFn: (data) => client.content.create({
+            channelUid: data.channelUid || channelUid,
+            ...data,
+        }),
         onSuccess: () => {
             queryClient.invalidateQueries({ queryKey: exports.contentKeys.lists() });
         },
@@ -152,7 +150,6 @@ const useToggleLike = () => {
         onSettled: (data, error, uid) => {
             // Invalidate the lists so they fetch the latest liked status and like counts
             queryClient.invalidateQueries({ queryKey: exports.contentKeys.lists() });
-            queryClient.invalidateQueries({ queryKey: exports.contentKeys.geoLists() });
         },
     });
 };

package/dist/hooks/useFirebaseAuthSync.js

@@ -70,7 +70,7 @@ const context_1 = require("../context");
  */
 const useFirebaseAuthSync = (options) => {
     const { firebaseAuth, logoutOnFirebaseSignOut = true, onSyncSuccess, onSyncError, } = options;
-    const { client, isAuthenticated, isLoading, refreshUser } = (0, context_1.usePHCMSContext)();
+    const { client, isAuthenticated, isLoading, refreshUser, channelUid } = (0, context_1.usePHCMSContext)();
     // Use refs for values that change frequently but should not re-trigger
     // the effect (which would tear down and re-create the Firebase listener).
     const isAuthenticatedRef = (0, react_1.useRef)(isAuthenticated);
@@ -106,7 +106,7 @@ const useFirebaseAuthSync = (options) => {
                 setIsSyncing(true);
                 try {
                     const idToken = await fbUser.getIdToken();
-                    await client.auth.loginWithFirebase({ idToken });
+                    await client.auth.loginWithFirebase({ idToken, channelUid });
                     // loginWithFirebase stores the tokens in the provider.
                     // Now refresh the context so `isAuthenticated` and `user` update.
                     await refreshUser();

package/dist/hooks/useStampTour.js

@@ -12,9 +12,13 @@ exports.stampTourKeys = {
 };
 const useCreateStampTour = () => {
     const client = (0, context_1.usePHCMS)();
+    const { channelUid } = (0, context_1.usePHCMSContext)();
     const queryClient = (0, react_query_1.useQueryClient)();
     return (0, react_query_1.useMutation)({
-        mutationFn: (data) => client.content.createStampTour(data),
+        mutationFn: (data) => client.content.createStampTour({
+            channelUid: data.channelUid || channelUid,
+            ...data,
+        }),
         onSuccess: () => {
             // Invalidate content lists since a new tour is a content item
             queryClient.invalidateQueries({ queryKey: useContent_1.contentKeys.lists() });

package/dist/hooks/useUser.d.ts

@@ -1,4 +1,48 @@
 import { UpdateUserProfileRequest } from '@ph-cms/api-contract';
+export declare const termsKeys: {
+    all: readonly ["terms"];
+    lists: () => readonly ["terms", "list"];
+};
+/**
+ * Access the current user profile and status.
+ */
+export declare const useUser: () => {
+    data: {
+        status: string;
+        uid: string;
+        email: string;
+        username: string | null;
+        display_name: string;
+        avatar_url: string | null;
+        phone_number: string | null;
+        email_verified_at: string | null;
+        phone_verified_at: string | null;
+        locale: string;
+        timezone: string;
+        role: string[];
+        profile_data: Record<string, any>;
+        last_login_at: string | null;
+        created_at: string;
+        updated_at: string;
+        channel_agreements?: {
+            channel_uid: string | null;
+            is_fully_compliant: boolean;
+            agreements: {
+                code: string;
+                version: string;
+                title: string;
+                term_id: number;
+                is_agreed: boolean;
+                is_required: boolean;
+                is_latest: boolean;
+                agreed_at: string | null;
+            }[];
+        }[] | undefined;
+    } | null;
+    isLoading: boolean;
+    isAuthenticated: boolean;
+    error: boolean;
+};
 /**
  * Hook to update a user's profile.
  * Typically used by a user to update their own profile.
@@ -38,3 +82,23 @@ export declare const useUpdateProfile: () => import("@tanstack/react-query").Use
     uid: string;
     data: UpdateUserProfileRequest | Record<string, any>;
 }, unknown>;
+/**
+ * List terms required/available for the current channel.
+ */
+export declare const useChannelTerms: () => import("@tanstack/react-query").UseQueryResult<{
+    code: string;
+    id: number;
+    version: string;
+    title: string;
+    content: string;
+    isActive: boolean;
+    createdAt: string;
+    isRequired?: boolean | undefined;
+}[], Error>;
+/**
+ * Submit term agreements for the current user.
+ */
+export declare const useAgreeTerms: () => import("@tanstack/react-query").UseMutationResult<void, Error, {
+    termCodes: string[];
+    channelUid?: string;
+}, unknown>;

package/dist/hooks/useUser.js

@@ -1,8 +1,20 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useUpdateProfile = void 0;
+exports.useAgreeTerms = exports.useChannelTerms = exports.useUpdateProfile = exports.useUser = exports.termsKeys = void 0;
 const react_query_1 = require("@tanstack/react-query");
 const context_1 = require("../context");
+exports.termsKeys = {
+    all: ['terms'],
+    lists: () => [...exports.termsKeys.all, 'list'],
+};
+/**
+ * Access the current user profile and status.
+ */
+const useUser = () => {
+    const { user, isLoading, isAuthenticated, isError } = (0, context_1.usePHCMSContext)();
+    return { data: user, isLoading, isAuthenticated, error: isError };
+};
+exports.useUser = useUser;
 /**
  * Hook to update a user's profile.
  * Typically used by a user to update their own profile.
@@ -19,3 +31,29 @@ const useUpdateProfile = () => {
     });
 };
 exports.useUpdateProfile = useUpdateProfile;
+/**
+ * List terms required/available for the current channel.
+ */
+const useChannelTerms = () => {
+    const { client, channelUid } = (0, context_1.usePHCMSContext)();
+    return (0, react_query_1.useQuery)({
+        queryKey: [...exports.termsKeys.all, 'channel', channelUid],
+        queryFn: () => client.terms.listByChannel(channelUid),
+        enabled: !!channelUid,
+    });
+};
+exports.useChannelTerms = useChannelTerms;
+/**
+ * Submit term agreements for the current user.
+ */
+const useAgreeTerms = () => {
+    const client = (0, context_1.usePHCMS)();
+    const { channelUid } = (0, context_1.usePHCMSContext)();
+    return (0, react_query_1.useMutation)({
+        mutationFn: (data) => client.terms.agree({
+            channelUid: data.channelUid || channelUid,
+            ...data,
+        }),
+    });
+};
+exports.useAgreeTerms = useAgreeTerms;

package/dist/index.d.ts

@@ -13,11 +13,9 @@ export * from './modules/terms';
 export * from './modules/user';
 export * from './context';
 export * from './hooks/useAuth';
-export * from './hooks/useChannel';
 export * from './hooks/useContent';
 export * from './hooks/useStampTour';
 export * from './hooks/useFirebaseAuthSync';
 export * from './hooks/useMedia';
-export * from './hooks/useTerms';
 export * from './hooks/useUser';
 export * from './types';

package/dist/index.js

@@ -29,11 +29,9 @@ __exportStar(require("./modules/terms"), exports);
 __exportStar(require("./modules/user"), exports);
 __exportStar(require("./context"), exports);
 __exportStar(require("./hooks/useAuth"), exports);
-__exportStar(require("./hooks/useChannel"), exports);
 __exportStar(require("./hooks/useContent"), exports);
 __exportStar(require("./hooks/useStampTour"), exports);
 __exportStar(require("./hooks/useFirebaseAuthSync"), exports);
 __exportStar(require("./hooks/useMedia"), exports);
-__exportStar(require("./hooks/useTerms"), exports);
 __exportStar(require("./hooks/useUser"), exports);
 __exportStar(require("./types"), exports);

package/dist/modules/auth.d.ts

@@ -1,4 +1,4 @@
-import { AuthResponse, FirebaseExchangeRequest, LoginRequest, RegisterRequest, UserDto } from "@ph-cms/api-contract";
+import { AuthResponse, FirebaseExchangeRequest, LoginRequest, RegisterRequest, UserDto, AnonymousLoginRequest } from "@ph-cms/api-contract";
 import { AxiosInstance } from "axios";
 import { AuthProvider } from "../auth/interfaces";
 export declare class AuthModule {
@@ -16,10 +16,18 @@ export declare class AuthModule {
     register(data: RegisterRequest): Promise<AuthResponse>;
     me(params?: {
         channelUid?: string;
+        channelSlug?: string;
     }): Promise<UserDto>;
     refresh(refreshToken: string): Promise<{
         accessToken: string;
         refreshToken: string;
     }>;
+    loginAnonymous(data: AnonymousLoginRequest): Promise<AuthResponse>;
+    upgradeAnonymous(data: {
+        email: string;
+        password: string;
+        display_name?: string;
+        username?: string;
+    }): Promise<UserDto>;
     logout(): Promise<void>;
 }

package/dist/modules/auth.js

@@ -53,6 +53,20 @@ class AuthModule {
     async refresh(refreshToken) {
         return this.client.post('/api/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);
+        if (this.provider) {
+            this.provider.setTokens(response.accessToken, response.refreshToken);
+        }
+        return response;
+    }
+    async upgradeAnonymous(data) {
+        return this.client.post('/api/auth/anonymous/upgrade', data);
+    }
     async logout() {
         if (this.provider) {
             await this.provider.logout();

package/dist/modules/channel.d.ts

@@ -1,12 +1,10 @@
-import { ChannelDto, CheckHierarchyQuery, CreateChannelDto, ListChannelQuery, PagedChannelListResponse } from "@ph-cms/api-contract";
+import { ChannelDto, CheckHierarchyQuery } from "@ph-cms/api-contract";
 import { AxiosInstance } from "axios";
 export declare class ChannelModule {
     private client;
     constructor(client: AxiosInstance);
-    list(params: ListChannelQuery): Promise<PagedChannelListResponse>;
     getByUid(uid: string): Promise<ChannelDto>;
     getBySlug(slug: string): Promise<ChannelDto>;
-    create(data: CreateChannelDto): Promise<ChannelDto>;
     update(uid: string, data: any): Promise<ChannelDto>;
     checkHierarchy(params: CheckHierarchyQuery): Promise<{
         allowed: boolean;

package/dist/modules/channel.js

@@ -7,13 +7,6 @@ class ChannelModule {
     constructor(client) {
         this.client = client;
     }
-    async list(params) {
-        const validation = api_contract_1.ListChannelQuerySchema.safeParse(params);
-        if (!validation.success) {
-            throw new errors_1.ValidationError("Invalid list channel params", validation.error.errors);
-        }
-        return this.client.get('/api/channels', { params });
-    }
     async getByUid(uid) {
         if (!uid)
             throw new errors_1.ValidationError("UID is required", []);
@@ -24,13 +17,6 @@ class ChannelModule {
             throw new errors_1.ValidationError("Slug is required", []);
         return this.client.get(`/api/channels/s/${slug}`);
     }
-    async create(data) {
-        const validation = api_contract_1.CreateChannelSchema.safeParse(data);
-        if (!validation.success) {
-            throw new errors_1.ValidationError("Invalid create channel params", validation.error.errors);
-        }
-        return this.client.post('/api/channels', data);
-    }
     async update(uid, data) {
         // TODO: Add schema validation for update channel
         if (!uid)

package/dist/modules/content.d.ts

@@ -1,10 +1,9 @@
-import { BoundsQuery, CollectStampRequest, ContentDto, CreateContentRequest, CreateStampTourRequest, LikeStatusResponse, ListContentQuery, PagedContentListResponse, StampStatusDto, ToggleLikeResponse, TourStatsDto, UpdateContentRequest, UpdateStampTourRequest } from "@ph-cms/api-contract";
+import { CollectStampRequest, ContentDto, CreateContentRequest, CreateStampTourRequest, LikeStatusResponse, ListContentQuery, PagedContentListResponse, StampStatusDto, ToggleLikeResponse, TourStatsDto, UpdateContentRequest, UpdateStampTourRequest } from "@ph-cms/api-contract";
 import { AxiosInstance } from "axios";
 export declare class ContentModule {
     private client;
     constructor(client: AxiosInstance);
     list(params: ListContentQuery): Promise<PagedContentListResponse>;
-    listGeo(bounds: BoundsQuery): Promise<ContentDto[]>;
     get(uid: string): Promise<ContentDto>;
     incrementView(uid: string): Promise<void>;
     create(data: CreateContentRequest): Promise<ContentDto>;

package/dist/modules/content.js

@@ -14,13 +14,6 @@ class ContentModule {
         }
         return this.client.get('/api/contents', { params });
     }
-    async listGeo(bounds) {
-        const validation = api_contract_1.BoundsQuerySchema.safeParse(bounds);
-        if (!validation.success) {
-            throw new errors_1.ValidationError("Invalid bounds params", validation.error.errors);
-        }
-        return this.client.get('/api/contents/geo', { params: bounds });
-    }
     async get(uid) {
         if (!uid)
             throw new errors_1.ValidationError("UID is required", []);

package/dist/modules/terms.d.ts

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

package/dist/modules/terms.js

@@ -5,9 +5,6 @@ class TermsModule {
     constructor(client) {
         this.client = client;
     }
-    async list(params) {
-        return this.client.get('/api/terms', { params });
-    }
     async get(id) {
         return this.client.get(`/api/terms/${id}`);
     }

package/dist/types.d.ts

@@ -6,11 +6,11 @@ export type { FirebaseAuthSyncProps, UseFirebaseAuthSyncOptions, UseFirebaseAuth
 export type { StampAvailability, CheckStampAvailabilityParams } from './hooks/useStampTour';
 export type { AuthResponse, FirebaseExchangeRequest, LoginRequest, RefreshTokenRequest, RegisterRequest } from '@ph-cms/api-contract';
 export type { UserDto } from '@ph-cms/api-contract';
-export type { ChannelDto, CheckHierarchyQuery, CreateChannelDto, ListChannelQuery, PagedChannelListResponse } from '@ph-cms/api-contract';
+export type { ChannelDto, CheckHierarchyQuery } from '@ph-cms/api-contract';
 export type { ContentDto, ContentMediaDto, CreateContentRequest, ListContentQuery, PagedContentListResponse, UpdateContentRequest } from '@ph-cms/api-contract';
 export type { HierarchySetDto } from '@ph-cms/api-contract';
 export type { PermissionPolicySetDto } from '@ph-cms/api-contract';
-export type { ListTermsQuery, PagedTermListResponse, TermDto } from '@ph-cms/api-contract';
-export type { BoundsQuery, GeoJSON } 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 { PagedResponse } from '@ph-cms/api-contract';

package/package.json

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

package/dist/hooks/useChannel.d.ts

@@ -1,65 +0,0 @@
-import { ListChannelQuery } from '@ph-cms/api-contract';
-export declare const channelKeys: {
-    all: readonly ["channels"];
-    lists: () => readonly ["channels", "list"];
-    list: (params: ListChannelQuery) => readonly ["channels", "list", {
-        status?: string | undefined;
-        limit?: number | undefined;
-        offset?: number | undefined;
-        ownerUid?: string | undefined;
-    }];
-};
-export declare const useChannelList: (params: ListChannelQuery) => import("@tanstack/react-query").UseQueryResult<{
-    items: {
-        status: string;
-        uid: string;
-        created_at: string;
-        updated_at: string;
-        name: string;
-        description: string | null;
-        slug: string;
-        hierarchySet: {
-            uid: string;
-            created_at: string;
-            updated_at: string;
-            name: string;
-            description: string | null;
-        } | null;
-        permissionPolicySet: {
-            uid: string;
-            name: string;
-            description: string | null;
-        } | null;
-    }[];
-    total: number;
-    page: number;
-    limit: number;
-    totalPages: number;
-}, Error>;
-export declare const useCreateChannel: () => import("@tanstack/react-query").UseMutationResult<{
-    status: string;
-    uid: string;
-    created_at: string;
-    updated_at: string;
-    name: string;
-    description: string | null;
-    slug: string;
-    hierarchySet: {
-        uid: string;
-        created_at: string;
-        updated_at: string;
-        name: string;
-        description: string | null;
-    } | null;
-    permissionPolicySet: {
-        uid: string;
-        name: string;
-        description: string | null;
-    } | null;
-}, Error, {
-    name: string;
-    slug: string;
-    hierarchySetUid: string;
-    description?: string | undefined;
-    permissionPolicySetUid?: string | undefined;
-}, unknown>;

package/dist/hooks/useChannel.js

@@ -1,30 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.useCreateChannel = exports.useChannelList = exports.channelKeys = void 0;
-const react_query_1 = require("@tanstack/react-query");
-const context_1 = require("../context");
-exports.channelKeys = {
-    all: ['channels'],
-    lists: () => [...exports.channelKeys.all, 'list'],
-    list: (params) => [...exports.channelKeys.lists(), params],
-};
-const useChannelList = (params) => {
-    const client = (0, context_1.usePHCMS)();
-    return (0, react_query_1.useQuery)({
-        queryKey: exports.channelKeys.list(params),
-        queryFn: () => client.channel.list(params),
-        staleTime: 1000 * 60 * 5, // 5 minutes
-    });
-};
-exports.useChannelList = useChannelList;
-const useCreateChannel = () => {
-    const client = (0, context_1.usePHCMS)();
-    const queryClient = (0, react_query_1.useQueryClient)();
-    return (0, react_query_1.useMutation)({
-        mutationFn: (data) => client.channel.create(data),
-        onSuccess: () => {
-            queryClient.invalidateQueries({ queryKey: exports.channelKeys.lists() });
-        },
-    });
-};
-exports.useCreateChannel = useCreateChannel;

package/dist/hooks/useTerms.d.ts

@@ -1,39 +0,0 @@
-import { ListTermsQuery } from '@ph-cms/api-contract';
-export declare const termsKeys: {
-    all: readonly ["terms"];
-    lists: () => readonly ["terms", "list"];
-    list: (params?: ListTermsQuery) => readonly ["terms", "list", {
-        code?: string | undefined;
-        limit?: number | undefined;
-        isActive?: boolean | undefined;
-        offset?: number | undefined;
-    } | undefined];
-};
-export declare const useTermsList: (params?: ListTermsQuery) => import("@tanstack/react-query").UseQueryResult<{
-    items: {
-        code: string;
-        id: number;
-        version: string;
-        title: string;
-        content: string;
-        isActive: boolean;
-        createdAt: string;
-    }[];
-    total: number;
-    page: number;
-    limit: number;
-    totalPages: number;
-}, Error>;
-export declare const useChannelTerms: (channelUid: string) => import("@tanstack/react-query").UseQueryResult<{
-    code: string;
-    id: number;
-    version: string;
-    title: string;
-    content: string;
-    isActive: boolean;
-    createdAt: string;
-}[], Error>;
-export declare const useAgreeTerms: () => import("@tanstack/react-query").UseMutationResult<void, Error, {
-    termCodes: string[];
-    channelUid?: string;
-}, unknown>;

package/dist/hooks/useTerms.js

@@ -1,35 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.useAgreeTerms = exports.useChannelTerms = exports.useTermsList = exports.termsKeys = void 0;
-const react_query_1 = require("@tanstack/react-query");
-const context_1 = require("../context");
-exports.termsKeys = {
-    all: ['terms'],
-    lists: () => [...exports.termsKeys.all, 'list'],
-    list: (params) => [...exports.termsKeys.lists(), params],
-};
-const useTermsList = (params) => {
-    const client = (0, context_1.usePHCMS)();
-    return (0, react_query_1.useQuery)({
-        queryKey: exports.termsKeys.list(params),
-        queryFn: () => client.terms.list(params),
-        staleTime: 1000 * 60 * 60, // 1 hour
-    });
-};
-exports.useTermsList = useTermsList;
-const useChannelTerms = (channelUid) => {
-    const client = (0, context_1.usePHCMS)();
-    return (0, react_query_1.useQuery)({
-        queryKey: [...exports.termsKeys.all, 'channel', channelUid],
-        queryFn: () => client.terms.listByChannel(channelUid),
-        enabled: !!channelUid,
-    });
-};
-exports.useChannelTerms = useChannelTerms;
-const useAgreeTerms = () => {
-    const client = (0, context_1.usePHCMS)();
-    return (0, react_query_1.useMutation)({
-        mutationFn: (data) => client.terms.agree(data),
-    });
-};
-exports.useAgreeTerms = useAgreeTerms;