@ph-cms/client-sdk 0.1.11 → 0.1.13

package/README.md

@@ -799,10 +799,72 @@ function CreateTourForm() {
     alert('투어가 생성되었습니다.');
   };
 
-  return <button onClick={handleCreate} disabled={isPending}>투어 만들기</button>;
+  return <button onClick={handleCreate} disabled={isPending}>생성</button>;
 }
 ```
 
+---
+
+## User Terms (사용자 약관)
+
+PH-CMS는 글로벌 약관과 채널별 약관을 지원하며, 사용자의 동의 여부와 최신 버전 준수 여부를 트래킹합니다.
+
+### Channel Context Setup
+
+특정 채널의 서비스라면 `PHCMSProvider`에 `channelUid`를 전달하여, 해당 채널의 약관 준수 상태를 자동으로 가져올 수 있습니다.
+
+```tsx
+<PHCMSProvider client={client} channelUid="my-channel-slug">
+  <App />
+</PHCMSProvider>
+```
+
+이렇게 설정하면 `useAuth()`나 `usePHCMSContext()`를 통해 가져오는 `user` 객체의 `channel_agreements` 필드에 해당 채널의 약관 요약 정보가 포함됩니다.
+
+### Checking Compliance
+
+사용자가 필수 약관에 모두 동의했는지, 혹은 약관이 개정되어 재동의가 필요한지 확인합니다.
+
+```tsx
+function TermsGuard({ children }) {
+  const { user } = useAuth();
+  
+  // 현재 채널에 대한 동의 요약 찾기
+  const compliance = user?.channel_agreements?.[0]; 
+
+  if (compliance && !compliance.is_fully_compliant) {
+    return <TermsAgreementModal summary={compliance} />;
+  }
+
+  return children;
+}
+```
+
+### Hooks for Terms
+
+#### 1. `useChannelTerms(channelUid)`
+특정 채널에 할당된 약관 목록을 조회합니다.
+
+```tsx
+const { data: terms } = useChannelTerms('my-channel-slug');
+```
+
+#### 2. `useAgreeTerms()`
+약관 동의를 제출합니다.
+
+```tsx
+const { mutateAsync: agree } = useAgreeTerms();
+
+const handleAgree = async (termCodes: string[]) => {
+  await agree({
+    termCodes,
+    channelUid: 'my-channel-slug' // 선택 사항 (Provider에 설정되어 있어도 명시 가능)
+  });
+};
+```
+
+---
+
 #### 스탬프 투어 수정 (인증 필수)
 
 기존 스탬프 투어의 정보나 마커 목록을 수정합니다. (참여자가 있는 경우 마커 목록 수정은 제한될 수 있습니다.)

package/dist/context.d.ts

@@ -8,8 +8,9 @@ export interface PHCMSContextType {
     user: UserDto | null;
     isAuthenticated: boolean;
     isLoading: boolean;
-    /** Whether the user profile fetch failed. */
     isError: boolean;
+    /** The current channel context for terms compliance. */
+    channelUid?: string;
     /**
      * Fine-grained authentication status.
      * - `'loading'`: Token exists, `/auth/me` is being fetched.
@@ -25,10 +26,10 @@ export interface PHCMSContextType {
 export interface PHCMSProviderProps {
     client: PHCMSClient;
     queryClient?: QueryClient;
+    channelUid?: string;
     children: ReactNode;
 }
 /**
- * Root Provider for PH-CMS
  * Automatically includes QueryClientProvider
  */
 export declare const PHCMSProvider: React.FC<PHCMSProviderProps>;

package/dist/context.js

@@ -41,15 +41,15 @@ const AUTH_ME_QUERY_KEY = ['auth', 'me'];
 /**
  * Internal component to handle auth state and provide to context
  */
-const PHCMSInternalProvider = ({ client, children }) => {
+const PHCMSInternalProvider = ({ client, channelUid, children }) => {
     const queryClient = (0, react_query_1.useQueryClient)();
     // 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);
     // The 'me' query is only enabled if we have a token.
     const { data: user, isLoading, isError, refetch } = (0, react_query_1.useQuery)({
-        queryKey: [...AUTH_ME_QUERY_KEY],
-        queryFn: () => client.auth.me(),
+        queryKey: [...AUTH_ME_QUERY_KEY, channelUid],
+        queryFn: () => client.auth.me({ channelUid }),
         enabled: hasToken,
         retry: false,
         staleTime: 1000 * 60 * 5,
@@ -92,16 +92,16 @@ const PHCMSInternalProvider = ({ client, children }) => {
             isError,
             authStatus,
             hasToken,
+            channelUid,
             refreshUser,
         };
-    }, [client, user, isError, isLoading, hasToken, refreshUser]);
+    }, [client, user, isError, isLoading, hasToken, channelUid, refreshUser]);
     return react_1.default.createElement(PHCMSContext.Provider, { value: value }, children);
 };
 /**
- * Root Provider for PH-CMS
  * Automatically includes QueryClientProvider
  */
-const PHCMSProvider = ({ client, queryClient, children }) => {
+const PHCMSProvider = ({ client, queryClient, channelUid, children }) => {
     const internalQueryClient = (0, react_1.useMemo)(() => queryClient ??
         new react_query_1.QueryClient({
             defaultOptions: {
@@ -112,7 +112,7 @@ const PHCMSProvider = ({ client, queryClient, children }) => {
             },
         }), [queryClient]);
     return (react_1.default.createElement(react_query_1.QueryClientProvider, { client: internalQueryClient },
-        react_1.default.createElement(PHCMSInternalProvider, { client: client }, children)));
+        react_1.default.createElement(PHCMSInternalProvider, { client: client, channelUid: channelUid }, children)));
 };
 exports.PHCMSProvider = PHCMSProvider;
 /**

package/dist/hooks/useAuth.d.ts

@@ -4,6 +4,7 @@
  */
 export declare const useAuth: () => {
     user: {
+        status: string;
         uid: string;
         email: string;
         username: string | null;
@@ -14,18 +15,32 @@ export declare const useAuth: () => {
         phone_verified_at: string | null;
         locale: string;
         timezone: string;
-        status: 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;
     isAuthenticated: boolean;
     isLoading: boolean;
     login: import("@tanstack/react-query").UseMutateAsyncFunction<{
         refreshToken: string;
         user: {
+            status: string;
             uid: string;
             email: string;
             username: string | null;
@@ -36,12 +51,25 @@ export declare const useAuth: () => {
             phone_verified_at: string | null;
             locale: string;
             timezone: string;
-            status: 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, {
@@ -51,6 +79,7 @@ export declare const useAuth: () => {
     loginWithFirebase: import("@tanstack/react-query").UseMutateAsyncFunction<{
         refreshToken: string;
         user: {
+            status: string;
             uid: string;
             email: string;
             username: string | null;
@@ -61,12 +90,25 @@ export declare const useAuth: () => {
             phone_verified_at: string | null;
             locale: string;
             timezone: string;
-            status: 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, {
@@ -75,6 +117,7 @@ export declare const useAuth: () => {
     register: import("@tanstack/react-query").UseMutateAsyncFunction<{
         refreshToken: string;
         user: {
+            status: string;
             uid: string;
             email: string;
             username: string | null;
@@ -85,12 +128,25 @@ export declare const useAuth: () => {
             phone_verified_at: string | null;
             locale: string;
             timezone: string;
-            status: 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, {
@@ -101,11 +157,13 @@ export declare const useAuth: () => {
         provider?: string | undefined;
         provider_subject?: string | undefined;
         termCodes?: string[] | undefined;
+        channelUid?: string | undefined;
     }, unknown>;
     logout: import("@tanstack/react-query").UseMutateAsyncFunction<void, Error, void, unknown>;
     loginStatus: import("@tanstack/react-query").UseMutationResult<{
         refreshToken: string;
         user: {
+            status: string;
             uid: string;
             email: string;
             username: string | null;
@@ -116,12 +174,25 @@ export declare const useAuth: () => {
             phone_verified_at: string | null;
             locale: string;
             timezone: string;
-            status: 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, {
@@ -131,6 +202,7 @@ export declare const useAuth: () => {
     loginWithFirebaseStatus: import("@tanstack/react-query").UseMutationResult<{
         refreshToken: string;
         user: {
+            status: string;
             uid: string;
             email: string;
             username: string | null;
@@ -141,12 +213,25 @@ export declare const useAuth: () => {
             phone_verified_at: string | null;
             locale: string;
             timezone: string;
-            status: 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, {
@@ -155,6 +240,7 @@ export declare const useAuth: () => {
     registerStatus: import("@tanstack/react-query").UseMutationResult<{
         refreshToken: string;
         user: {
+            status: string;
             uid: string;
             email: string;
             username: string | null;
@@ -165,12 +251,25 @@ export declare const useAuth: () => {
             phone_verified_at: string | null;
             locale: string;
             timezone: string;
-            status: 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, {
@@ -181,11 +280,13 @@ export declare const useAuth: () => {
         provider?: string | undefined;
         provider_subject?: string | undefined;
         termCodes?: string[] | undefined;
+        channelUid?: string | undefined;
     }, unknown>;
     logoutStatus: import("@tanstack/react-query").UseMutationResult<void, Error, void, unknown>;
 };
 export declare const useUser: () => {
     data: {
+        status: string;
         uid: string;
         email: string;
         username: string | null;
@@ -196,12 +297,25 @@ export declare const useUser: () => {
         phone_verified_at: string | null;
         locale: string;
         timezone: string;
-        status: 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;
@@ -210,6 +324,7 @@ export declare const useUser: () => {
 export declare const useLogin: () => import("@tanstack/react-query").UseMutationResult<{
     refreshToken: string;
     user: {
+        status: string;
         uid: string;
         email: string;
         username: string | null;
@@ -220,12 +335,25 @@ export declare const useLogin: () => import("@tanstack/react-query").UseMutation
         phone_verified_at: string | null;
         locale: string;
         timezone: string;
-        status: 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, {

package/dist/hooks/useChannel.d.ts

@@ -11,8 +11,8 @@ export declare const channelKeys: {
 };
 export declare const useChannelList: (params: ListChannelQuery) => import("@tanstack/react-query").UseQueryResult<{
     items: {
-        uid: string;
         status: string;
+        uid: string;
         created_at: string;
         updated_at: string;
         name: string;
@@ -37,8 +37,8 @@ export declare const useChannelList: (params: ListChannelQuery) => import("@tans
     totalPages: number;
 }, Error>;
 export declare const useCreateChannel: () => import("@tanstack/react-query").UseMutationResult<{
-    uid: string;
     status: string;
+    uid: string;
     created_at: string;
     updated_at: string;
     name: string;

package/dist/hooks/useContent.d.ts

@@ -7,15 +7,15 @@ export declare const contentKeys: {
         limit: number;
         status?: string | undefined;
         type?: string | undefined;
-        tags?: string[] | undefined;
         channelUid?: string | undefined;
+        tags?: string[] | undefined;
         channelSlug?: string | undefined;
         parentUid?: string | undefined;
         authorUid?: string | undefined;
         uids?: string[] | undefined;
         rootUid?: string | undefined;
         keyword?: string | undefined;
-        orderBy?: "created_at" | "updated_at" | "published_at" | "title" | "view_count" | "like_count" | undefined;
+        orderBy?: "title" | "created_at" | "updated_at" | "published_at" | "view_count" | "like_count" | undefined;
         orderDir?: "asc" | "desc" | undefined;
         withDetail?: boolean | undefined;
         includeDeleted?: boolean | undefined;
@@ -35,8 +35,8 @@ export declare const contentKeys: {
 export declare const useContentList: (params: ListContentQuery, enabled?: boolean) => import("@tanstack/react-query").UseQueryResult<{
     number: number;
     totalPages: number;
-    size: number;
     content: ContentDto[];
+    size: number;
     totalElements: number;
     first: boolean;
     last: boolean;
@@ -44,10 +44,15 @@ export declare const useContentList: (params: ListContentQuery, enabled?: boolea
 }, 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;
+    uid: string;
+}>;
 export declare const useCreateContent: () => import("@tanstack/react-query").UseMutationResult<ContentDto, Error, {
     type: string;
     title: string;
     status?: string | undefined;
+    channelUid?: string | undefined;
     geometry?: {
         type: "Point" | "LineString" | "Polygon" | "MultiPoint" | "MultiLineString" | "MultiPolygon" | "GeometryCollection" | "Feature" | "FeatureCollection";
         coordinates?: any[] | undefined;
@@ -62,7 +67,6 @@ export declare const useCreateContent: () => import("@tanstack/react-query").Use
     summary?: string | null | undefined;
     slug?: string | null | undefined;
     tags?: string[] | undefined;
-    channelUid?: string | undefined;
     channelSlug?: string | undefined;
     parentUid?: string | undefined;
     sortOrder?: number | undefined;

package/dist/hooks/useContent.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useDeleteContent = exports.useUpdateContent = exports.useToggleLike = exports.useLikeStatus = exports.useCreateContent = 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.useContentGeoList = exports.useContentList = exports.contentKeys = void 0;
 const react_query_1 = require("@tanstack/react-query");
 const context_1 = require("../context");
 exports.contentKeys = {
@@ -42,6 +42,37 @@ const useContentDetail = (uid) => {
     });
 };
 exports.useContentDetail = useContentDetail;
+const useIncrementView = () => {
+    const client = (0, context_1.usePHCMS)();
+    const queryClient = (0, react_query_1.useQueryClient)();
+    return (0, react_query_1.useMutation)({
+        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) });
+            // Snapshot the previous detail
+            const previousDetail = queryClient.getQueryData(exports.contentKeys.detail(uid));
+            // Optimistically update the view count in the detail cache
+            if (previousDetail) {
+                queryClient.setQueryData(exports.contentKeys.detail(uid), {
+                    ...previousDetail,
+                    stat: {
+                        ...previousDetail.stat,
+                        view_count: previousDetail.stat.view_count + 1,
+                    },
+                });
+            }
+            return { previousDetail, uid };
+        },
+        onError: (err, uid, context) => {
+            // Roll back to the previous detail if the mutation fails
+            if (context?.previousDetail) {
+                queryClient.setQueryData(exports.contentKeys.detail(uid), context.previousDetail);
+            }
+        },
+    });
+};
+exports.useIncrementView = useIncrementView;
 const useCreateContent = () => {
     const client = (0, context_1.usePHCMS)();
     const queryClient = (0, react_query_1.useQueryClient)();

package/dist/hooks/useMedia.d.ts

@@ -19,8 +19,8 @@ export declare const useUploadToS3: () => import("@tanstack/react-query").UseMut
     file: File | Blob;
 }, unknown>;
 export declare const useMediaDetail: (uid: string) => import("@tanstack/react-query").UseQueryResult<{
-    uid: string;
     type: "image" | "video" | "audio" | "document" | "file";
+    uid: string;
     url: string;
     name: string;
     mimeType: string;

package/dist/hooks/useStampTour.d.ts

@@ -6,10 +6,11 @@ export declare const stampTourKeys: {
 };
 export declare const useCreateStampTour: () => import("@tanstack/react-query").UseMutationResult<ContentDto, Error, {
     title: string;
+    isActive: boolean;
     parentUid: string;
     markerUids: string[];
-    isActive: boolean;
     status?: string | undefined;
+    channelUid?: string | undefined;
     geometry?: {
         type: "Point" | "LineString" | "Polygon" | "MultiPoint" | "MultiLineString" | "MultiPolygon" | "GeometryCollection" | "Feature" | "FeatureCollection";
         coordinates?: any[] | undefined;
@@ -21,7 +22,6 @@ export declare const useCreateStampTour: () => import("@tanstack/react-query").U
     image?: string | null | undefined;
     summary?: string | null | undefined;
     tags?: string[] | undefined;
-    channelUid?: string | undefined;
     channelSlug?: string | undefined;
     startsAt?: string | null | undefined;
     endsAt?: string | null | undefined;

package/dist/hooks/useTerms.d.ts

@@ -12,15 +12,30 @@ export declare const termsKeys: {
 export declare const useTermsList: (params?: ListTermsQuery) => import("@tanstack/react-query").UseQueryResult<{
     items: {
         code: string;
+        id: number;
+        version: string;
         title: string;
         content: string;
         isActive: boolean;
-        id: number;
-        version: string;
         createdAt: string;
+        isRequired?: boolean | undefined;
     }[];
     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;
+    isRequired?: boolean | undefined;
+}[], Error>;
+export declare const useAgreeTerms: () => import("@tanstack/react-query").UseMutationResult<void, Error, {
+    termCodes: string[];
+    channelUid?: string;
+}, unknown>;

package/dist/hooks/useTerms.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useTermsList = exports.termsKeys = void 0;
+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 = {
@@ -17,3 +17,19 @@ const useTermsList = (params) => {
     });
 };
 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;

package/dist/hooks/useUser.d.ts

@@ -4,6 +4,7 @@ import { UpdateUserProfileRequest } from '@ph-cms/api-contract';
  * Typically used by a user to update their own profile.
  */
 export declare const useUpdateProfile: () => import("@tanstack/react-query").UseMutationResult<{
+    status: string;
     uid: string;
     email: string;
     username: string | null;
@@ -14,12 +15,25 @@ export declare const useUpdateProfile: () => import("@tanstack/react-query").Use
     phone_verified_at: string | null;
     locale: string;
     timezone: string;
-    status: 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, {
     uid: string;
     data: UpdateUserProfileRequest | Record<string, any>;

package/dist/modules/auth.d.ts

@@ -14,7 +14,9 @@ export declare class AuthModule {
      */
     loginWithFirebase(data: FirebaseExchangeRequest): Promise<AuthResponse>;
     register(data: RegisterRequest): Promise<AuthResponse>;
-    me(): Promise<UserDto>;
+    me(params?: {
+        channelUid?: string;
+    }): Promise<UserDto>;
     refresh(refreshToken: string): Promise<{
         accessToken: string;
         refreshToken: string;

package/dist/modules/auth.js

@@ -47,8 +47,8 @@ class AuthModule {
         }
         return response;
     }
-    async me() {
-        return this.client.get('/api/auth/me');
+    async me(params) {
+        return this.client.get('/api/auth/me', { params });
     }
     async refresh(refreshToken) {
         return this.client.post('/api/auth/refresh', { refreshToken });

package/dist/modules/content.d.ts

@@ -6,6 +6,7 @@ export declare class ContentModule {
     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>;
     update(uid: string, data: UpdateContentRequest): Promise<ContentDto>;
     delete(uid: string): Promise<void>;

package/dist/modules/content.js

@@ -26,6 +26,11 @@ class ContentModule {
             throw new errors_1.ValidationError("UID is required", []);
         return this.client.get(`/api/contents/${uid}`);
     }
+    async incrementView(uid) {
+        if (!uid)
+            throw new errors_1.ValidationError("UID is required", []);
+        await this.client.post(`/api/contents/${uid}/view`);
+    }
     async create(data) {
         const validation = api_contract_1.CreateContentSchema.safeParse(data);
         if (!validation.success) {

package/dist/modules/terms.d.ts

@@ -5,4 +5,9 @@ export declare class TermsModule {
     constructor(client: AxiosInstance);
     list(params?: ListTermsQuery): Promise<PagedTermListResponse>;
     get(id: number): Promise<TermDto>;
+    agree(data: {
+        termCodes: string[];
+        channelUid?: string;
+    }): Promise<void>;
+    listByChannel(channelUid: string): Promise<TermDto[]>;
 }

package/dist/modules/terms.js

@@ -11,5 +11,11 @@ class TermsModule {
     async get(id) {
         return this.client.get(`/api/terms/${id}`);
     }
+    async agree(data) {
+        await this.client.post('/api/terms/agree', data);
+    }
+    async listByChannel(channelUid) {
+        return this.client.get(`/api/terms/channels/${channelUid}`);
+    }
 }
 exports.TermsModule = TermsModule;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ph-cms/client-sdk",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "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.5",
     "@tanstack/react-query": "^5.0.0",
     "axios": "^1.6.0",
     "zod": "^3.22.4"