@spfn/cms 0.1.0-alpha.0

package/dist/server.js

@@ -0,0 +1,256 @@
+import "server-only";
+/**
+ * CMS Server Module
+ *
+ * Next.js 서버 컴포넌트용 CMS 유틸리티
+ * - React cache를 사용한 데이터 중복 제거
+ * - SPFN API를 통한 contract-based 호출
+ * - 변수 치환 지원
+ * - 쿠키 기반 locale 자동 관리
+ */
+import { cache } from 'react';
+import { client } from '@spfn/core/client';
+import { getPublishedCacheContract } from './routes/published-cache/contract.js';
+import { getLocale } from './helpers/locale.actions.js';
+/**
+ * 변수 치환 헬퍼
+ *
+ * @param text - 치환할 텍스트 (예: 'Hello {name}!')
+ * @param replace - 치환 맵 (예: { name: 'World' })
+ * @returns 치환된 텍스트 (예: 'Hello World!')
+ */
+function replaceVariables(text, replace) {
+    return text.replace(/\{(\w+)}/g, (match, key) => {
+        const value = replace[key];
+        return value !== undefined ? String(value) : match;
+    });
+}
+/**
+ * 섹션 데이터 로드 (React cache 적용)
+ *
+ * 동일한 요청 내에서 같은 섹션을 여러 번 요청해도 한 번만 API 호출
+ *
+ * @param section - 섹션 이름 (예: 'home', 'why-futureplay')
+ * @param locale - 언어 코드 (선택, 미지정시 쿠키에서 자동 조회)
+ * @returns Section API ({ t, data })
+ *
+ * @example
+ * ```tsx
+ * // Server Component
+ * import { getSection } from '@spfn/cms/server';
+ *
+ * export default async function HomePage()
+ * {
+ *     // locale을 지정하지 않으면 쿠키에서 자동으로 가져옴
+ *     const { t } = await getSection('home');
+ *
+ *     // 또는 명시적으로 locale 지정
+ *     const { t: tEn } = await getSection('home', 'en');
+ *
+ *     return (
+ *         <div>
+ *             <h1>{t('hero.title')}</h1>
+ *             <p>{t('hero.subtitle', 'Default Subtitle')}</p>
+ *             <p>{t('hero.greeting', 'Hello {name}!', { name: 'World' })}</p>
+ *         </div>
+ *     );
+ * }
+ * ```
+ */
+export const getSection = cache(async (section, locale) => {
+    // locale이 지정되지 않으면 쿠키에서 가져옴
+    const actualLocale = locale ?? await getLocale();
+    try {
+        // Call SPFN API via contract (uses singleton client)
+        const response = await client.call('/cms/published-cache', getPublishedCacheContract, {
+            query: { sections: section, locale: actualLocale },
+        });
+        // Check if response has error
+        if ('error' in response) {
+            console.warn(`[CMS] ${response.error}`);
+            // Return empty section data
+            const sectionData = {
+                section,
+                locale: actualLocale,
+                content: {},
+                version: 0,
+                publishedAt: null,
+            };
+            const t = (_key, defaultValue) => defaultValue;
+            return { t, data: sectionData };
+        }
+        // Response is an array, get first element
+        const found = response[0];
+        if (!found) {
+            // Section not found, return empty
+            const sectionData = {
+                section,
+                locale: actualLocale,
+                content: {},
+                version: 0,
+                publishedAt: null,
+            };
+            const t = (_key, defaultValue) => defaultValue;
+            return { t, data: sectionData };
+        }
+        // Success response
+        const sectionData = {
+            section: found.section,
+            locale: found.locale,
+            content: found.content || {},
+            version: found.version,
+            publishedAt: found.publishedAt,
+        };
+        // Translation function
+        const t = (key, defaultValue, replace) => {
+            const fullKey = `${section}.${key}`;
+            let value = sectionData.content[fullKey];
+            if (value === undefined) {
+                value = defaultValue;
+            }
+            // 문자열이고 치환 맵이 있으면 변수 치환
+            if (typeof value === 'string' && replace) {
+                value = replaceVariables(value, replace);
+            }
+            return value;
+        };
+        return {
+            t,
+            data: sectionData,
+        };
+    }
+    catch (error) {
+        console.error(`[CMS] Failed to fetch section "${section}":`, error);
+        // Return empty section data on error
+        const sectionData = {
+            section,
+            locale: actualLocale,
+            content: {},
+            version: 0,
+            publishedAt: null,
+        };
+        const t = (key, defaultValue) => defaultValue;
+        return { t, data: sectionData };
+    }
+});
+/**
+ * 여러 섹션 한번에 로드 (React cache 적용)
+ * 단일 API 호출로 여러 섹션을 효율적으로 가져옵니다
+ *
+ * @param sections - 섹션 이름 배열
+ * @param locale - 언어 코드 (선택, 미지정시 쿠키에서 자동 조회)
+ * @returns Section API 맵 ({ home: { t, data }, ... })
+ *
+ * @example
+ * ```tsx
+ * // Server Component
+ * import { getSections } from '@spfn/cms/server';
+ *
+ * export default async function Page()
+ * {
+ *     // locale을 지정하지 않으면 쿠키에서 자동으로 가져옴
+ *     const sections = await getSections(['home', 'why-futureplay']);
+ *
+ *     // 또는 명시적으로 locale 지정
+ *     const sectionsEn = await getSections(['home', 'why-futureplay'], 'en');
+ *
+ *     return (
+ *         <div>
+ *             <h1>{sections.home.t('hero.title')}</h1>
+ *             <p>{sections['why-futureplay'].t('intro.text')}</p>
+ *         </div>
+ *     );
+ * }
+ * ```
+ */
+export const getSections = cache(async (sections, locale) => {
+    // locale이 지정되지 않으면 쿠키에서 가져옴
+    const actualLocale = locale ?? await getLocale();
+    try {
+        // Call SPFN API with array of sections (single HTTP request)
+        const response = await client.call('/cms/published-cache', getPublishedCacheContract, {
+            query: { sections, locale: actualLocale },
+        });
+        // Check if response has error
+        if ('error' in response) {
+            console.warn(`[CMS] ${response.error}`);
+            // Return empty sections
+            const sectionsMap = {};
+            sections.forEach(section => {
+                sectionsMap[section] = {
+                    t: (_key, defaultValue) => defaultValue,
+                    data: {
+                        section,
+                        locale: actualLocale,
+                        content: {},
+                        version: 0,
+                        publishedAt: null,
+                    }
+                };
+            });
+            return sectionsMap;
+        }
+        // Build sections map from response
+        const sectionsMap = {};
+        // First, create empty entries for all requested sections
+        sections.forEach(section => {
+            sectionsMap[section] = {
+                t: (_key, defaultValue) => defaultValue,
+                data: {
+                    section,
+                    locale: actualLocale,
+                    content: {},
+                    version: 0,
+                    publishedAt: null,
+                }
+            };
+        });
+        // Then, fill in data for found sections
+        response.forEach(sectionData => {
+            const createTranslationFn = (section, content) => {
+                return (key, defaultValue, replace) => {
+                    const fullKey = `${section}.${key}`;
+                    let value = content[fullKey];
+                    if (value === undefined) {
+                        value = defaultValue;
+                    }
+                    // 문자열이고 치환 맵이 있으면 변수 치환
+                    if (typeof value === 'string' && replace) {
+                        value = replaceVariables(value, replace);
+                    }
+                    return value;
+                };
+            };
+            sectionsMap[sectionData.section] = {
+                t: createTranslationFn(sectionData.section, sectionData.content),
+                data: {
+                    section: sectionData.section,
+                    locale: sectionData.locale,
+                    content: sectionData.content,
+                    version: sectionData.version,
+                    publishedAt: sectionData.publishedAt,
+                }
+            };
+        });
+        return sectionsMap;
+    }
+    catch (error) {
+        console.error(`[CMS] Failed to fetch sections:`, error);
+        // Return empty sections on error
+        const sectionsMap = {};
+        sections.forEach(section => {
+            sectionsMap[section] = {
+                t: (_key, defaultValue) => defaultValue,
+                data: {
+                    section,
+                    locale: actualLocale,
+                    content: {},
+                    version: 0,
+                    publishedAt: null,
+                }
+            };
+        });
+        return sectionsMap;
+    }
+});
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/store.d.ts

@@ -0,0 +1,87 @@
+/**
+ * CMS Zustand Store
+ *
+ * 클라이언트 컴포넌트에서 CMS 사용을 위한 상태 관리
+ * - 서버에서 초기화된 데이터를 클라이언트로 전달
+ * - 클라이언트에서 비동기로 로드 가능
+ * - 서버 API와 동일한 패턴 ({ t } 사용)
+ */
+import type { SectionData } from './server';
+interface CmsState {
+    /**
+     * 섹션별 데이터
+     * { 'home': { section: 'home', content: {...}, version: 1, ... }, ... }
+     */
+    sections: Record<string, SectionData>;
+    /**
+     * 로딩 상태
+     */
+    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;
+}
+export declare const useCmsStore: import("zustand").UseBoundStore<import("zustand").StoreApi<CmsState>>;
+/**
+ * 섹션 Hook (서버 API와 동일한 패턴)
+ *
+ * @param section - 섹션 이름
+ * @param options - 옵션 (autoLoad: 자동 로드 여부)
+ * @returns { t, data, loading }
+ *
+ * @example
+ * ```tsx
+ * 'use client';
+ * import { useSection } from '@/lib/cms';
+ *
+ * export function ClientComponent()
+ * {
+ *     const { t } = useSection('home');
+ *     return <h1>{t('hero.title')}</h1>;
+ * }
+ * ```
+ */
+export 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;
+};
+/**
+ * 여러 섹션 Hook
+ *
+ * @param sectionNames - 섹션 이름 배열
+ * @returns { [section]: { t, data, loading }, ... }
+ *
+ * @example
+ * ```tsx
+ * const sections = useSections(['home', 'why-futureplay']);
+ * sections.home.t('hero.title');
+ * ```
+ */
+export declare function useSections(sectionNames: string[]): Record<string, {
+    t: (key: string, defaultValue?: any, replace?: Record<string, string | number>) => any;
+    data: SectionData;
+    loading: boolean;
+}>;
+export {};
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAc5C,UAAU,QAAQ;IAEd;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAEtC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEjC;;OAEG;IACH,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,KAAK,IAAI,CAAC;IAEzD;;OAEG;IACH,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,KAAK,IAAI,CAAC;IAE7D;;OAEG;IACH,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjE;;OAEG;IACH,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;IAEhE;;OAEG;IACH,KAAK,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,eAAO,MAAM,WAAW,uEAkHrB,CAAC;AAEJ;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,UAAU,CACtB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO;aAoB3C,MAAM,iBAAiB,GAAG,YAAY,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;;;EA+BlF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE;aA7CpC,MAAM,iBAAiB,GAAG,YAAY,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;;;GAwFlF"}

package/dist/store.js

@@ -0,0 +1,205 @@
+/**
+ * CMS Zustand Store
+ *
+ * 클라이언트 컴포넌트에서 CMS 사용을 위한 상태 관리
+ * - 서버에서 초기화된 데이터를 클라이언트로 전달
+ * - 클라이언트에서 비동기로 로드 가능
+ * - 서버 API와 동일한 패턴 ({ t } 사용)
+ */
+'use client';
+import React from 'react';
+import { create } from 'zustand';
+import { cmsApi } from './client';
+/**
+ * 변수 치환 헬퍼 (서버와 동일)
+ */
+function replaceVariables(text, replace) {
+    return text.replace(/\{(\w+)}/g, (match, key) => {
+        const value = replace[key];
+        return value !== undefined ? String(value) : match;
+    });
+}
+export const useCmsStore = create((set, get) => ({
+    sections: {},
+    loading: {},
+    setSection: (section, data) => {
+        set((state) => ({
+            sections: {
+                ...state.sections,
+                [section]: data,
+            },
+        }));
+    },
+    setSections: (sections) => {
+        set((state) => ({
+            sections: {
+                ...state.sections,
+                ...sections,
+            },
+        }));
+    },
+    loadSection: async (section, locale = 'ko') => {
+        const state = get();
+        // 이미 로드 중이면 스킵
+        if (state.loading[section]) {
+            return;
+        }
+        // 이미 로드되어 있으면 스킵
+        if (state.sections[section]) {
+            return;
+        }
+        set((state) => ({
+            loading: { ...state.loading, [section]: true },
+        }));
+        try {
+            const response = await cmsApi.publishedCache.get({
+                query: { sections: section, locale },
+            });
+            // Check for error response
+            if ('error' in response) {
+                console.error(`Failed to load section ${section}:`, response.error);
+                return;
+            }
+            // Response is array, get first element
+            const data = response[0];
+            if (!data) {
+                console.warn(`Section ${section} not found`);
+                return;
+            }
+            const sectionData = {
+                section: data.section,
+                locale: data.locale,
+                content: data.content || {},
+                version: data.version || 0,
+                publishedAt: data.publishedAt || null,
+            };
+            set((state) => ({
+                sections: {
+                    ...state.sections,
+                    [section]: sectionData,
+                },
+                loading: { ...state.loading, [section]: false },
+            }));
+        }
+        catch (error) {
+            console.error(`Error loading CMS section ${section}:`, error);
+            set((state) => ({
+                loading: { ...state.loading, [section]: false },
+            }));
+        }
+    },
+    updateLabel: (section, key, value) => {
+        set((state) => ({
+            sections: {
+                ...state.sections,
+                [section]: {
+                    ...state.sections[section],
+                    content: {
+                        ...state.sections[section]?.content,
+                        [`${section}.${key}`]: value,
+                    },
+                },
+            },
+        }));
+    },
+    reset: () => {
+        set({
+            sections: {},
+            loading: {},
+        });
+    },
+}));
+/**
+ * 섹션 Hook (서버 API와 동일한 패턴)
+ *
+ * @param section - 섹션 이름
+ * @param options - 옵션 (autoLoad: 자동 로드 여부)
+ * @returns { t, data, loading }
+ *
+ * @example
+ * ```tsx
+ * 'use client';
+ * import { useSection } from '@/lib/cms';
+ *
+ * export function ClientComponent()
+ * {
+ *     const { t } = useSection('home');
+ *     return <h1>{t('hero.title')}</h1>;
+ * }
+ * ```
+ */
+export function useSection(section, options = {}) {
+    const { autoLoad = false, locale = 'ko' } = options;
+    const sectionData = useCmsStore((state) => state.sections[section]);
+    const loading = useCmsStore((state) => state.loading[section] ?? false);
+    const loadSection = useCmsStore((state) => state.loadSection);
+    // 자동 로드 옵션이 켜져있고 데이터가 없으면 로드
+    React.useEffect(() => {
+        if (autoLoad && !sectionData && !loading) {
+            loadSection(section, locale);
+        }
+    }, [autoLoad, section, locale, sectionData, loading, loadSection]);
+    // Translation function (서버와 동일)
+    const t = React.useCallback((key, defaultValue, replace) => {
+        if (!sectionData) {
+            return defaultValue;
+        }
+        const fullKey = `${section}.${key}`;
+        let value = sectionData.content[fullKey];
+        if (value === undefined) {
+            value = defaultValue;
+        }
+        // 문자열이고 치환 맵이 있으면 변수 치환
+        if (typeof value === 'string' && replace) {
+            value = replaceVariables(value, replace);
+        }
+        return value;
+    }, [section, sectionData]);
+    return {
+        t,
+        data: sectionData,
+        loading,
+    };
+}
+/**
+ * 여러 섹션 Hook
+ *
+ * @param sectionNames - 섹션 이름 배열
+ * @returns { [section]: { t, data, loading }, ... }
+ *
+ * @example
+ * ```tsx
+ * const sections = useSections(['home', 'why-futureplay']);
+ * sections.home.t('hero.title');
+ * ```
+ */
+export function useSections(sectionNames) {
+    const allSections = useCmsStore((state) => state.sections);
+    const allLoading = useCmsStore((state) => state.loading);
+    const result = {};
+    sectionNames.forEach((section) => {
+        const sectionData = allSections[section];
+        const loading = allLoading[section] ?? false;
+        const t = (key, defaultValue, replace) => {
+            if (!sectionData) {
+                return defaultValue;
+            }
+            const fullKey = `${section}.${key}`;
+            let value = sectionData.content[fullKey];
+            if (value === undefined) {
+                value = defaultValue;
+            }
+            if (typeof value === 'string' && replace) {
+                value = replaceVariables(value, replace);
+            }
+            return value;
+        };
+        result[section] = {
+            t,
+            data: sectionData,
+            loading,
+        };
+    });
+    return result;
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"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"}

package/dist/sync.d.ts

@@ -0,0 +1,11 @@
+/**
+ * CMS Sync Utilities
+ *
+ * 라벨 동기화를 위한 헬퍼 함수들
+ */
+import type { SectionDefinition, SyncOptions, SyncResult } from './types';
+/**
+ * 섹션 라벨 동기화
+ */
+export declare function syncSection(definition: SectionDefinition, options?: SyncOptions): Promise<SyncResult>;
+//# sourceMappingURL=sync.d.ts.map

package/dist/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../src/sync.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAG1E;;GAEG;AACH,wBAAsB,WAAW,CAC7B,UAAU,EAAE,iBAAiB,EAC7B,OAAO,GAAE,WAAgB,GAC1B,OAAO,CAAC,UAAU,CAAC,CAoKrB"}