@spfn/cms 0.1.0-alpha.8 → 0.1.0-alpha.81

package/dist/client.d.ts

@@ -1,138 +1,146 @@
+import { SectionData, SectionAPI } from './server.js';
+import * as zustand from 'zustand';
+export { g as getLocale, b as getLocaleWithInfo, a as getLocales, c as getLocalesWithInfo, s as setLocale } from './actions-BEFWwQsh.js';
+export { L as LOCALE_COOKIE_KEY, e as LOCALE_INFO_MAP, f as LocaleInfo, S as SupportedLocale, d as getDialCode, c as getFlag, g as getLocaleInfo, b as getSupportedLocales, i as isRTL } from './locale.constants-BNkSdNP1.js';
+import './index-Dh5FjWzR.js';
+import './server/repositories/index.js';
+import './server/entities/cms-labels.js';
+import 'drizzle-orm/pg-core';
+import './server/entities/cms-label-values.js';
+import './server/entities/cms-draft-cache.js';
+import './server/entities/cms-published-cache.js';
+import './server/entities/cms-audit-logs.js';
+import './label-sync-generator-B0EmvtWM.js';
+import '@spfn/core/codegen';
+
 /**
- * @spfn/cms/client
+ * useSection Hook
  *
- * Client Components Only
- * 클라이언트 컴포넌트 전용 (브라우저에서 실행)
+ * 클라이언트 컴포넌트에서 섹션 데이터 사용
  */
-import type { InferContract } from '@spfn/core';
-import { getLabelsContract, createLabelContract } from './routes/labels/contract';
-import { getLabelContract, updateLabelContract, deleteLabelContract } from './routes/labels/[id]/contract';
-import { getPublishedCacheContract } from './routes/published-cache/contract';
 /**
- * CMS API Client
+ * 섹션 Hook (서버 API와 동일한 패턴)
+ *
+ * @param section - 섹션 이름
+ * @param options - 옵션 (autoLoad: 자동 로드 여부)
+ * @returns { t, data, loading }
+ *
+ * @example
+ * ```tsx
+ * 'use client';
+ * import { useSection } from '@spfn/cms/client';
+ *
+ * export function ClientComponent()
+ * {
+ *     const { t } = useSection('home', { autoLoad: true });
+ *     return <h1>{t('hero.title')}</h1>;
+ * }
+ * ```
+ */
+declare function useSection(section: string, options?: {
+    autoLoad?: boolean;
+    locale?: string;
+}): {
+    t: (key: string, defaultValue?: any, replace?: Record<string, string | number>) => any;
+    data: SectionData;
+    loading: boolean;
+};
+
+/**
+ * useSections Hook
+ *
+ * 여러 섹션을 한번에 사용
+ */
+/**
+ * 여러 섹션 Hook
+ *
+ * @param sectionNames - 섹션 이름 배열
+ * @returns { [section]: { t, data, loading }, ... }
+ *
+ * @example
+ * ```tsx
+ * 'use client';
+ * import { useSections } from '@spfn/cms/client';
+ *
+ * export function Component()
+ * {
+ *     const sections = useSections(['home', 'layout']);
+ *     return (
+ *         <div>
+ *             <h1>{sections.home.t('hero.title')}</h1>
+ *             <p>{sections.layout.t('footer.copyright')}</p>
+ *         </div>
+ *     );
+ * }
+ * ```
  */
-export declare const cmsApi: {
+declare function useSections(sectionNames: string[]): Record<string, {
+    t: (key: string, defaultValue?: any, replace?: Record<string, string | number>) => any;
+    data: SectionData;
+    loading: boolean;
+}>;
+
+interface CmsState {
     /**
-     * Labels API
+     * 섹션별 데이터
+     * { 'home': { section: 'home', content: {...}, version: 1, ... }, ... }
      */
-    readonly labels: {
-        /**
-         * GET /cms/labels
-         * 라벨 목록 조회 (섹션 필터, 페이지네이션)
-         */
-        readonly list: (options?: {
-            query?: InferContract<typeof getLabelsContract>["query"];
-        }) => Promise<{
-            limit: number;
-            offset: number;
-            labels: {
-                section: string;
-                id: number;
-                key: string;
-                type: string;
-                publishedVersion: number | null;
-                createdBy: string | null;
-                createdAt: string;
-                updatedAt: string;
-            }[];
-            total: number;
-        }>;
-        /**
-         * GET /cms/labels/:id
-         * 특정 라벨 조회
-         */
-        readonly getById: (options: {
-            params: InferContract<typeof getLabelContract>["params"];
-        }) => Promise<{
-            section: string;
-            id: number;
-            key: string;
-            type: string;
-            publishedVersion: number | null;
-            createdBy: string | null;
-            createdAt: string;
-            updatedAt: string;
-        } | {
-            error: string;
-        }>;
-        /**
-         * POST /cms/labels
-         * 새 라벨 생성
-         */
-        readonly create: (options: {
-            body: InferContract<typeof createLabelContract>["body"];
-        }) => Promise<{
-            section: string;
-            id: number;
-            key: string;
-            type: string;
-            publishedVersion: number | null;
-            createdBy: string | null;
-            createdAt: string;
-            updatedAt: string;
-        } | {
-            key?: string | undefined;
-            error: string;
-        }>;
-        /**
-         * PATCH /cms/labels/:id
-         * 라벨 업데이트
-         */
-        readonly update: (options: {
-            params: InferContract<typeof updateLabelContract>["params"];
-            body: InferContract<typeof updateLabelContract>["body"];
-        }) => Promise<{
-            section: string;
-            id: number;
-            key: string;
-            type: string;
-            publishedVersion: number | null;
-            createdBy: string | null;
-            createdAt: string;
-            updatedAt: string;
-        } | {
-            error: string;
-        }>;
-        /**
-         * DELETE /cms/labels/:id
-         * 라벨 삭제
-         */
-        readonly delete: (options: {
-            params: InferContract<typeof deleteLabelContract>["params"];
-        }) => Promise<{
-            id: number;
-            success: boolean;
-        } | {
-            error: string;
-        }>;
-    };
+    sections: Record<string, SectionData>;
     /**
-     * Published Cache API
+     * 로딩 상태
      */
-    readonly publishedCache: {
-        /**
-         * GET /cms/published-cache
-         * 발행된 콘텐츠 캐시 조회
-         */
-        readonly get: (options: {
-            query: InferContract<typeof getPublishedCacheContract>["query"];
-        }) => Promise<{
-            section: string;
-            locale: string;
-            content: {
-                [x: string]: any;
-            };
-            version: number;
-            publishedAt: string | null;
-        }[] | {
-            error: string;
-        }>;
-    };
-};
+    loading: Record<string, boolean>;
+    /**
+     * 섹션 데이터 설정 (서버에서 초기화용)
+     */
+    setSection: (section: string, data: SectionData) => void;
+    /**
+     * 여러 섹션 한번에 설정
+     */
+    setSections: (sections: Record<string, SectionData>) => void;
+    /**
+     * 섹션 비동기 로드
+     */
+    loadSection: (section: string, locale?: string) => Promise<void>;
+    /**
+     * 라벨 업데이트 (Draft Mode용)
+     */
+    updateLabel: (section: string, key: string, value: any) => void;
+    /**
+     * 초기화
+     */
+    reset: () => void;
+}
+declare const useCmsStore: zustand.UseBoundStore<zustand.StoreApi<CmsState>>;
+
 /**
- * Type exports
+ * CMS Store Initializer
+ *
+ * 서버 컴포넌트에서 로드한 섹션 데이터를 클라이언트 store에 초기화
+ */
+
+interface InitCmsProps {
+    /**
+     * 서버에서 로드한 섹션 데이터
+     * { home: { t, data }, ... }
+     */
+    sections: Record<string, SectionAPI>;
+}
+/**
+ * CMS Store 초기화 컴포넌트
+ *
+ * 서버 컴포넌트에서 로드한 데이터를  클라이언트 store에 주입
+ * 이후 하위 클라이언트 컴포넌트에서 useSection() 사용 가능
+ *
+ * @param props - InitCmsProps
+ * @param props.sections - 서버에서 로드한 섹션 데이터
+ *
+ * @example
+ * // Server Component
+ * const home = await getSection('home');
+ * <InitCms sections={{ home }} />
+ * // 이후 하위 클라이언트 컴포넌트에서 useSection('home') 사용 가능
  */
-export type CmsApi = typeof cmsApi;
-export { useCmsStore, useSection, useSections } from './store';
-export { InitCms } from './init';
-//# sourceMappingURL=client.d.ts.map
+declare function InitCms({ sections }: InitCmsProps): null;
+
+export { InitCms, useCmsStore, useSection, useSections };