@spfn/cms 0.1.0-alpha.6 → 0.1.0-alpha.60

package/dist/server.d.ts

@@ -1,8 +1,18 @@
-import "server-only";
+/**
+ * CMS Server Module
+ *
+ * Next.js 서버 컴포넌트용 CMS 유틸리티
+ * - React cache를 사용한 데이터 중복 제거
+ * - SPFN API를 통한 contract-based 호출
+ * - 변수 치환 지원
+ * - 쿠키 기반 locale 자동 관리
+ *
+ * @note This module should only be imported in server-side code
+ */
 /**
  * Section Data Type
  */
-export type SectionData = {
+type SectionData = {
     section: string;
     locale: string;
     content: Record<string, any>;
@@ -16,7 +26,7 @@ type ServerTranslationFunction = (key: string, defaultValue?: any, replace?: Rec
 /**
  * Section API Return Type
  */
-export type SectionAPI = {
+type SectionAPI = {
     /**
      * 라벨 값 가져오기 (변수 치환 지원)
      *
@@ -63,7 +73,7 @@ export type SectionAPI = {
  * }
  * ```
  */
-export declare const getSection: (section: string, locale?: string) => Promise<SectionAPI>;
+declare const getSection: (section: string, locale?: string) => Promise<SectionAPI>;
 /**
  * 여러 섹션 한번에 로드 (React cache 적용)
  * 단일 API 호출로 여러 섹션을 효율적으로 가져옵니다
@@ -94,6 +104,6 @@ export declare const getSection: (section: string, locale?: string) => Promise<S
  * }
  * ```
  */
-export declare const getSections: (sections: string[], locale?: string) => Promise<Record<string, SectionAPI>>;
-export {};
-//# sourceMappingURL=server.d.ts.map
+declare const getSections: (sections: string[], locale?: string) => Promise<Record<string, SectionAPI>>;
+
+export { type SectionAPI, type SectionData, getSection, getSections };

package/dist/server.js

@@ -1,264 +1,275 @@
-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;
+// src/server.ts
+import { cache } from "react";
+import { client } from "@spfn/core/client";
+
+// src/contracts/published-cache.ts
+import { Type } from "@sinclair/typebox";
+var SectionData = Type.Object({
+  section: Type.String(),
+  locale: Type.String(),
+  content: Type.Record(Type.String(), Type.Any()),
+  version: Type.Number(),
+  publishedAt: Type.Union([Type.String(), Type.Null()])
+});
+var getPublishedCacheContract = {
+  method: "GET",
+  path: "/cms/published-cache",
+  query: Type.Object({
+    sections: Type.Union([
+      Type.String({ description: "\uB2E8\uC77C \uC139\uC158 \uC774\uB984 (\uC608: home)" }),
+      Type.Array(Type.String(), { description: '\uC5EC\uB7EC \uC139\uC158 \uC774\uB984 (\uC608: ["home", "footer"])' })
+    ]),
+    locale: Type.Optional(Type.String({ default: "ko", description: "\uC5B8\uC5B4 \uCF54\uB4DC" }))
+  }),
+  response: Type.Union([
+    // 성공: 항상 배열로 반환
+    Type.Array(SectionData),
+    // 에러
+    Type.Object({
+      error: Type.String()
+    })
+  ])
+};
+
+// src/helpers/locale.actions.ts
+import { cookies, headers } from "next/headers.js";
+
+// src/cms.config.ts
+function getEnvVar(key, defaultValue) {
+  return process.env[key] || defaultValue;
+}
+function getEnvBoolean(key, defaultValue) {
+  const value = process.env[key];
+  if (value === void 0) return defaultValue;
+  return value === "true" || value === "1";
+}
+function loadConfigFromEnv() {
+  const defaultLocale = getEnvVar("SPFN_CMS_DEFAULT_LOCALE", "en");
+  const supportedLocalesStr = getEnvVar("SPFN_CMS_SUPPORTED_LOCALES", "en,ko");
+  const detectBrowserLanguage2 = getEnvBoolean("SPFN_CMS_DETECT_BROWSER_LANGUAGE", true);
+  const supportedLocales = supportedLocalesStr.split(",").map((locale) => locale.trim()).filter((locale) => locale.length > 0);
+  if (!supportedLocales.includes(defaultLocale)) {
+    supportedLocales.unshift(defaultLocale);
+  }
+  return {
+    defaultLocale,
+    supportedLocales,
+    detectBrowserLanguage: detectBrowserLanguage2
+  };
+}
+var currentConfig = loadConfigFromEnv();
+function getCmsConfig() {
+  return currentConfig;
+}
+
+// src/helpers/locale.constants.ts
+var LOCALE_COOKIE_KEY = "spfn-locale";
+
+// src/helpers/locale.actions.ts
+async function detectBrowserLanguage() {
+  try {
+    const headersList = await headers();
+    const acceptLanguage = headersList.get("accept-language");
+    if (!acceptLanguage) {
+      return null;
+    }
+    const languages = acceptLanguage.split(",").map((lang) => {
+      const [code] = lang.split(";");
+      return code.split("-")[0].trim();
     });
+    const config = getCmsConfig();
+    for (const lang of languages) {
+      if (config.supportedLocales.includes(lang)) {
+        return lang;
+      }
+    }
+    return null;
+  } catch (error) {
+    return null;
+  }
 }
-/**
- * 섹션 데이터 로드 (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 === null) {
-                value = defaultValue ?? '';
-            }
-            // 문자열이 아니면 빈 문자열 반환
-            if (typeof value !== 'string') {
-                return '';
-            }
-            // 문자열이고 치환 맵이 있으면 변수 치환
-            if (replace) {
-                value = replaceVariables(value, replace);
-            }
-            return value;
-        };
-        return {
-            t,
-            data: sectionData,
-        };
+async function getLocale() {
+  const config = getCmsConfig();
+  const cookieStore = await cookies();
+  const cookieLocale = cookieStore.get(LOCALE_COOKIE_KEY)?.value;
+  if (cookieLocale && config.supportedLocales.includes(cookieLocale)) {
+    return cookieLocale;
+  }
+  if (config.detectBrowserLanguage) {
+    const browserLang = await detectBrowserLanguage();
+    if (browserLang) {
+      return browserLang;
+    }
+  }
+  return config.defaultLocale;
+}
+
+// src/server.ts
+function replaceVariables(text, replace) {
+  return text.replace(/\{(\w+)}/g, (match, key) => {
+    const value = replace[key];
+    return value !== void 0 ? String(value) : match;
+  });
+}
+var getSection = cache(async (section, locale) => {
+  const actualLocale = locale ?? await getLocale();
+  try {
+    const response = await client.call(
+      getPublishedCacheContract,
+      {
+        query: { sections: section, locale: actualLocale }
+      }
+    );
+    if ("error" in response) {
+      console.warn(`[CMS] ${response.error}`);
+      const sectionData2 = {
+        section,
+        locale: actualLocale,
+        content: {},
+        version: 0,
+        publishedAt: null
+      };
+      const t2 = (_key, defaultValue) => defaultValue ?? "";
+      return { t: t2, data: sectionData2 };
+    }
+    const found = response[0];
+    if (!found) {
+      const sectionData2 = {
+        section,
+        locale: actualLocale,
+        content: {},
+        version: 0,
+        publishedAt: null
+      };
+      const t2 = (_key, defaultValue) => defaultValue ?? "";
+      return { t: t2, data: sectionData2 };
     }
-    catch (error) {
-        console.error(`[CMS] Failed to fetch section "${section}":`, error);
-        // Return empty section data on error
-        const sectionData = {
+    const sectionData = {
+      section: found.section,
+      locale: found.locale,
+      content: found.content || {},
+      version: found.version,
+      publishedAt: found.publishedAt
+    };
+    const t = (key, defaultValue, replace) => {
+      const fullKey = `${section}.${key}`;
+      let value = sectionData.content[fullKey];
+      if (value === void 0 || value === null) {
+        value = defaultValue ?? "";
+      }
+      if (typeof value !== "string") {
+        return "";
+      }
+      if (replace) {
+        value = replaceVariables(value, replace);
+      }
+      return value;
+    };
+    return {
+      t,
+      data: sectionData
+    };
+  } catch (error) {
+    console.error(`[CMS] Failed to fetch section "${section}":`, error);
+    const sectionData = {
+      section,
+      locale: actualLocale,
+      content: {},
+      version: 0,
+      publishedAt: null
+    };
+    const t = (_key, defaultValue) => defaultValue ?? "";
+    return { t, data: sectionData };
+  }
+});
+var getSections = cache(async (sections, locale) => {
+  const actualLocale = locale ?? await getLocale();
+  try {
+    const response = await client.call(
+      getPublishedCacheContract,
+      {
+        query: { sections, locale: actualLocale }
+      }
+    );
+    if ("error" in response) {
+      console.warn(`[CMS] ${response.error}`);
+      const sectionsMap2 = {};
+      sections.forEach((section) => {
+        sectionsMap2[section] = {
+          t: (_key, defaultValue) => defaultValue ?? "",
+          data: {
             section,
             locale: actualLocale,
             content: {},
             version: 0,
-            publishedAt: null,
+            publishedAt: null
+          }
         };
-        const t = (_key, defaultValue) => defaultValue ?? '';
-        return { t, data: sectionData };
+      });
+      return sectionsMap2;
     }
-});
-/**
- * 여러 섹션 한번에 로드 (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;
+    const sectionsMap = {};
+    sections.forEach((section) => {
+      sectionsMap[section] = {
+        t: (_key, defaultValue) => defaultValue ?? "",
+        data: {
+          section,
+          locale: actualLocale,
+          content: {},
+          version: 0,
+          publishedAt: null
         }
-        // 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 === null) {
-                        value = defaultValue ?? '';
-                    }
-                    // 문자열이 아니면 빈 문자열 반환
-                    if (typeof value !== 'string') {
-                        return '';
-                    }
-                    // 문자열이고 치환 맵이 있으면 변수 치환
-                    if (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;
-    }
+      };
+    });
+    response.forEach((sectionData) => {
+      const createTranslationFn = (section, content) => {
+        return (key, defaultValue, replace) => {
+          const fullKey = `${section}.${key}`;
+          let value = content[fullKey];
+          if (value === void 0 || value === null) {
+            value = defaultValue ?? "";
+          }
+          if (typeof value !== "string") {
+            return "";
+          }
+          if (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);
+    const sectionsMap = {};
+    sections.forEach((section) => {
+      sectionsMap[section] = {
+        t: (_key, defaultValue) => defaultValue ?? "",
+        data: {
+          section,
+          locale: actualLocale,
+          content: {},
+          version: 0,
+          publishedAt: null
+        }
+      };
+    });
+    return sectionsMap;
+  }
 });
+export {
+  getSection,
+  getSections
+};
 //# sourceMappingURL=server.js.map