@spfn/cms 0.1.0-alpha.64 → 0.1.0-alpha.65

package/dist/client.js

@@ -1,11 +1,20 @@
-// src/client.ts
+// src/client/hooks/useSection.ts
+import React from "react";
+
+// src/client/store/cms.store.ts
+import { create } from "zustand";
+
+// src/api/index.ts
+import { client as client5 } from "@spfn/core/client";
+
+// src/api/CmsLabels.ts
 import { client } from "@spfn/core/client";
 
-// src/contracts/labels.ts
+// src/lib/contracts/labels.ts
 import { Type } from "@sinclair/typebox";
 var getLabelsContract = {
   method: "GET",
-  path: "/cms/labels",
+  path: "/labels",
   query: Type.Object({
     section: Type.Optional(Type.String({ description: "\uC139\uC158\uC73C\uB85C \uD544\uD130\uB9C1 (\uC608: home, why-futureplay)" })),
     limit: Type.Optional(Type.Number({ minimum: 1, maximum: 100, default: 20, description: "\uD398\uC774\uC9C0\uB2F9 \uD56D\uBAA9 \uC218" })),
@@ -29,7 +38,7 @@ var getLabelsContract = {
 };
 var createLabelContract = {
   method: "POST",
-  path: "/cms/labels",
+  path: "/labels",
   body: Type.Object({
     key: Type.String({
       description: "\uACE0\uC720 \uD0A4 (\uC608: home.hero.title)",
@@ -67,7 +76,7 @@ var createLabelContract = {
 };
 var getLabelContract = {
   method: "GET",
-  path: "/cms/labels/:id",
+  path: "/labels/:id",
   params: Type.Object({
     id: Type.String({ description: "\uB77C\uBCA8 ID" })
   }),
@@ -89,7 +98,7 @@ var getLabelContract = {
 };
 var updateLabelContract = {
   method: "PATCH",
-  path: "/cms/labels/:id",
+  path: "/labels/:id",
   params: Type.Object({
     id: Type.String({ description: "\uB77C\uBCA8 ID" })
   }),
@@ -121,7 +130,7 @@ var updateLabelContract = {
 };
 var deleteLabelContract = {
   method: "DELETE",
-  path: "/cms/labels/:id",
+  path: "/labels/:id",
   params: Type.Object({
     id: Type.String({ description: "\uB77C\uBCA8 ID" })
   }),
@@ -137,7 +146,7 @@ var deleteLabelContract = {
 };
 var getLabelByKeyContract = {
   method: "GET",
-  path: "/cms/labels/by-key/:key",
+  path: "/labels/by-key/:key",
   params: Type.Object({
     key: Type.String({ description: "\uB77C\uBCA8 Key (\uC608: home.hero.title)" })
   }),
@@ -159,7 +168,43 @@ var getLabelByKeyContract = {
   ])
 };
 
-// src/contracts/published-cache.ts
+// src/api/CmsLabels.ts
+var CmsLabels = {
+  /**
+   * GET /_cms/labels
+   */
+  get: (options) => client.call(getLabelsContract, options),
+  /**
+   * POST /_cms/labels
+   */
+  post: (options) => client.call(createLabelContract, options),
+  /**
+   * GET /_cms/labels/:id
+   */
+  getById: (options) => client.call(getLabelContract, options),
+  /**
+   * PATCH /_cms/labels/:id
+   */
+  update: (options) => client.call(updateLabelContract, options),
+  /**
+   * DELETE /_cms/labels/:id
+   */
+  delete: (options) => client.call(deleteLabelContract, options)
+};
+
+// src/api/CmsLabelsByKey.ts
+import { client as client2 } from "@spfn/core/client";
+var CmsLabelsByKey = {
+  /**
+   * GET /_cms/labels/by-key/:key
+   */
+  getById: (options) => client2.call(getLabelByKeyContract, options)
+};
+
+// src/api/CmsPublishedCache.ts
+import { client as client3 } from "@spfn/core/client";
+
+// src/lib/contracts/published-cache.ts
 import { Type as Type2 } from "@sinclair/typebox";
 var SectionData = Type2.Object({
   section: Type2.String(),
@@ -170,7 +215,7 @@ var SectionData = Type2.Object({
 });
 var getPublishedCacheContract = {
   method: "GET",
-  path: "/cms/published-cache",
+  path: "/published-cache",
   query: Type2.Object({
     sections: Type2.Union([
       Type2.String({ description: "\uB2E8\uC77C \uC139\uC158 \uC774\uB984 (\uC608: home)" }),
@@ -188,15 +233,134 @@ var getPublishedCacheContract = {
   ])
 };
 
-// src/store.ts
-import React from "react";
-import { create } from "zustand";
-function replaceVariables(text, replace) {
-  return text.replace(/\{(\w+)}/g, (match, key) => {
-    const value = replace[key];
-    return value !== void 0 ? String(value) : match;
-  });
-}
+// src/api/CmsPublishedCache.ts
+var CmsPublishedCache = {
+  /**
+   * GET /_cms/published-cache
+   */
+  get: (options) => client3.call(getPublishedCacheContract, options)
+};
+
+// src/api/CmsValues.ts
+import { client as client4 } from "@spfn/core/client";
+
+// src/lib/contracts/values.ts
+import { Type as Type3 } from "@sinclair/typebox";
+var LabelValueSchema = Type3.Object({
+  type: Type3.Union([
+    Type3.Literal("text"),
+    Type3.Literal("image"),
+    Type3.Literal("video"),
+    Type3.Literal("file"),
+    Type3.Literal("object")
+  ]),
+  content: Type3.Optional(Type3.String()),
+  // text type
+  url: Type3.Optional(Type3.String()),
+  // image, video, file types
+  alt: Type3.Optional(Type3.String()),
+  // image type
+  width: Type3.Optional(Type3.Number()),
+  // image type
+  height: Type3.Optional(Type3.Number()),
+  // image type
+  thumbnail: Type3.Optional(Type3.String()),
+  // video type
+  duration: Type3.Optional(Type3.Number()),
+  // video type
+  filename: Type3.Optional(Type3.String()),
+  // file type
+  size: Type3.Optional(Type3.Number()),
+  // file type
+  fields: Type3.Optional(Type3.Any())
+  // object type - recursive structure
+});
+var saveValuesContract = {
+  method: "POST",
+  path: "/values/:labelId",
+  params: Type3.Object({
+    labelId: Type3.String({ description: "\uB77C\uBCA8 ID" })
+  }),
+  body: Type3.Object({
+    version: Type3.Number({ description: "\uBC84\uC804 \uBC88\uD638", minimum: 1 }),
+    values: Type3.Array(
+      Type3.Object({
+        locale: Type3.String({ description: "\uC5B8\uC5B4 \uCF54\uB4DC (ko, en, ja)", default: "ko" }),
+        breakpoint: Type3.Optional(Type3.Union([
+          Type3.Literal("sm"),
+          Type3.Literal("md"),
+          Type3.Literal("lg"),
+          Type3.Literal("xl"),
+          Type3.Literal("2xl"),
+          Type3.Null()
+        ], { description: "\uBC18\uC751\uD615 \uBE0C\uB808\uC774\uD06C\uD3EC\uC778\uD2B8" })),
+        value: LabelValueSchema
+      })
+    )
+  }),
+  response: Type3.Union([
+    Type3.Object({
+      success: Type3.Boolean(),
+      saved: Type3.Number(),
+      version: Type3.Number()
+    }),
+    Type3.Object({
+      error: Type3.String()
+    })
+  ])
+};
+var getValuesContract = {
+  method: "GET",
+  path: "/values/:labelId/:version",
+  params: Type3.Object({
+    labelId: Type3.String({ description: "\uB77C\uBCA8 ID" }),
+    version: Type3.String({ description: "\uBC84\uC804 \uBC88\uD638" })
+  }),
+  query: Type3.Object({
+    locale: Type3.Optional(Type3.String({ description: "\uC5B8\uC5B4 \uCF54\uB4DC (ko, en, ja)" })),
+    breakpoint: Type3.Optional(Type3.String({ description: "\uBC18\uC751\uD615 \uBE0C\uB808\uC774\uD06C\uD3EC\uC778\uD2B8" }))
+  }),
+  response: Type3.Union([
+    Type3.Object({
+      labelId: Type3.Number(),
+      version: Type3.Number(),
+      values: Type3.Array(
+        Type3.Object({
+          id: Type3.Number(),
+          locale: Type3.String(),
+          breakpoint: Type3.Union([Type3.String(), Type3.Null()]),
+          value: Type3.Any(),
+          createdAt: Type3.String()
+        })
+      )
+    }),
+    Type3.Object({
+      error: Type3.String()
+    })
+  ])
+};
+
+// src/api/CmsValues.ts
+var CmsValues = {
+  /**
+   * POST /_cms/values/:labelId
+   */
+  post: (options) => client4.call(saveValuesContract, options),
+  /**
+   * GET /_cms/values/:labelId/:version
+   */
+  getById: (options) => client4.call(getValuesContract, options)
+};
+
+// src/api/index.ts
+var cmsApi = {
+  cmsLabels: CmsLabels,
+  cmsLabelsByKey: CmsLabelsByKey,
+  cmsPublishedCache: CmsPublishedCache,
+  cmsValues: CmsValues
+};
+
+// src/client/store/cms.store.ts
 var useCmsStore = create((set, get) => ({
   sections: {},
   loading: {},
@@ -228,7 +392,7 @@ var useCmsStore = create((set, get) => ({
       loading: { ...state2.loading, [section]: true }
     }));
     try {
-      const response = await cmsApi.publishedCache.get({
+      const response = await cmsApi.cmsPublishedCache.get({
         query: { sections: section, locale }
       });
       if ("error" in response) {
@@ -282,6 +446,14 @@ var useCmsStore = create((set, get) => ({
     });
   }
 }));
+
+// src/client/hooks/useSection.ts
+function replaceVariables(text, replace) {
+  return text.replace(/\{(\w+)}/g, (match, key) => {
+    const value = replace[key];
+    return value !== void 0 ? String(value) : match;
+  });
+}
 function useSection(section, options = {}) {
   const { autoLoad = false, locale = "ko" } = options;
   const sectionData = useCmsStore((state) => state.sections[section]);
@@ -315,6 +487,14 @@ function useSection(section, options = {}) {
     loading
   };
 }
+
+// src/client/hooks/useSections.ts
+function replaceVariables2(text, replace) {
+  return text.replace(/\{(\w+)}/g, (match, key) => {
+    const value = replace[key];
+    return value !== void 0 ? String(value) : match;
+  });
+}
 function useSections(sectionNames) {
   const allSections = useCmsStore((state) => state.sections);
   const allLoading = useCmsStore((state) => state.loading);
@@ -332,7 +512,7 @@ function useSections(sectionNames) {
         value = defaultValue;
       }
       if (typeof value === "string" && replace) {
-        value = replaceVariables(value, replace);
+        value = replaceVariables2(value, replace);
       }
       return value;
     };
@@ -345,7 +525,7 @@ function useSections(sectionNames) {
   return result;
 }
 
-// src/init.tsx
+// src/client/components/InitCms.tsx
 import { useEffect } from "react";
 function InitCms({ sections }) {
   const setSections = useCmsStore((state) => state.setSections);
@@ -359,52 +539,669 @@ function InitCms({ sections }) {
   return null;
 }
 
-// src/client.ts
-var cmsApi = {
-  /**
-   * Labels API
-   */
-  labels: {
-    /**
-     * GET /cms/labels
-     * 라벨 목록 조회 (섹션 필터, 페이지네이션)
-     */
-    list: (options) => client.call(getLabelsContract, options),
-    /**
-     * GET /cms/labels/:id
-     * 특정 라벨 조회
-     */
-    getById: (options) => client.call(getLabelContract, options),
-    /**
-     * POST /cms/labels
-     * 새 라벨 생성
-     */
-    create: (options) => client.call(createLabelContract, options),
-    /**
-     * PATCH /cms/labels/:id
-     * 라벨 업데이트
-     */
-    update: (options) => client.call(updateLabelContract, options),
-    /**
-     * DELETE /cms/labels/:id
-     * 라벨 삭제
-     */
-    delete: (options) => client.call(deleteLabelContract, options)
+// src/server/helpers/locale.actions.ts
+import { cookies, headers } from "next/headers";
+
+// src/server/config/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/lib/constants/locale.constants.ts
+var LOCALE_COOKIE_KEY = "spfn-locale";
+var LOCALE_INFO_MAP = {
+  // 한국어
+  ko: {
+    locale: "ko",
+    countryCode: "KR",
+    flag: "🇰🇷",
+    dialCode: "+82",
+    nativeName: "\uD55C\uAD6D\uC5B4",
+    englishName: "Korean",
+    currencyCode: "KRW",
+    dateFormat: "YYYY.MM.DD"
   },
-  /**
-   * Published Cache API
-   */
-  publishedCache: {
-    /**
-     * GET /cms/published-cache
-     * 발행된 콘텐츠 캐시 조회
-     */
-    get: (options) => client.call(getPublishedCacheContract, options)
+  // 영어 (미국)
+  en: {
+    locale: "en",
+    countryCode: "US",
+    flag: "🇺🇸",
+    dialCode: "+1",
+    nativeName: "English",
+    englishName: "English",
+    currencyCode: "USD",
+    dateFormat: "MM/DD/YYYY"
+  },
+  // 일본어
+  ja: {
+    locale: "ja",
+    countryCode: "JP",
+    flag: "🇯🇵",
+    dialCode: "+81",
+    nativeName: "\u65E5\u672C\u8A9E",
+    englishName: "Japanese",
+    currencyCode: "JPY",
+    dateFormat: "YYYY/MM/DD"
+  },
+  // 중국어 (간체)
+  zh: {
+    locale: "zh",
+    countryCode: "CN",
+    flag: "🇨🇳",
+    dialCode: "+86",
+    nativeName: "\u7B80\u4F53\u4E2D\u6587",
+    englishName: "Chinese (Simplified)",
+    currencyCode: "CNY",
+    dateFormat: "YYYY-MM-DD"
+  },
+  // 중국어 (번체, 대만)
+  "zh-TW": {
+    locale: "zh-TW",
+    countryCode: "TW",
+    flag: "🇹🇼",
+    dialCode: "+886",
+    nativeName: "\u7E41\u9AD4\u4E2D\u6587",
+    englishName: "Chinese (Traditional)",
+    currencyCode: "TWD",
+    dateFormat: "YYYY/MM/DD"
+  },
+  // 스페인어
+  es: {
+    locale: "es",
+    countryCode: "ES",
+    flag: "🇪🇸",
+    dialCode: "+34",
+    nativeName: "Espa\xF1ol",
+    englishName: "Spanish",
+    currencyCode: "EUR",
+    dateFormat: "DD/MM/YYYY"
+  },
+  // 프랑스어
+  fr: {
+    locale: "fr",
+    countryCode: "FR",
+    flag: "🇫🇷",
+    dialCode: "+33",
+    nativeName: "Fran\xE7ais",
+    englishName: "French",
+    currencyCode: "EUR",
+    dateFormat: "DD/MM/YYYY"
+  },
+  // 독일어
+  de: {
+    locale: "de",
+    countryCode: "DE",
+    flag: "🇩🇪",
+    dialCode: "+49",
+    nativeName: "Deutsch",
+    englishName: "German",
+    currencyCode: "EUR",
+    dateFormat: "DD.MM.YYYY"
+  },
+  // 이탈리아어
+  it: {
+    locale: "it",
+    countryCode: "IT",
+    flag: "🇮🇹",
+    dialCode: "+39",
+    nativeName: "Italiano",
+    englishName: "Italian",
+    currencyCode: "EUR",
+    dateFormat: "DD/MM/YYYY"
+  },
+  // 포르투갈어 (브라질)
+  pt: {
+    locale: "pt",
+    countryCode: "BR",
+    flag: "🇧🇷",
+    dialCode: "+55",
+    nativeName: "Portugu\xEAs",
+    englishName: "Portuguese",
+    currencyCode: "BRL",
+    dateFormat: "DD/MM/YYYY"
+  },
+  // 러시아어
+  ru: {
+    locale: "ru",
+    countryCode: "RU",
+    flag: "🇷🇺",
+    dialCode: "+7",
+    nativeName: "\u0420\u0443\u0441\u0441\u043A\u0438\u0439",
+    englishName: "Russian",
+    currencyCode: "RUB",
+    dateFormat: "DD.MM.YYYY"
+  },
+  // 아랍어
+  ar: {
+    locale: "ar",
+    countryCode: "SA",
+    flag: "🇸🇦",
+    dialCode: "+966",
+    nativeName: "\u0627\u0644\u0639\u0631\u0628\u064A\u0629",
+    englishName: "Arabic",
+    rtl: true,
+    currencyCode: "SAR",
+    dateFormat: "DD/MM/YYYY"
+  },
+  // 힌디어
+  hi: {
+    locale: "hi",
+    countryCode: "IN",
+    flag: "🇮🇳",
+    dialCode: "+91",
+    nativeName: "\u0939\u093F\u0928\u094D\u0926\u0940",
+    englishName: "Hindi",
+    currencyCode: "INR",
+    dateFormat: "DD/MM/YYYY"
+  },
+  // 태국어
+  th: {
+    locale: "th",
+    countryCode: "TH",
+    flag: "🇹🇭",
+    dialCode: "+66",
+    nativeName: "\u0E44\u0E17\u0E22",
+    englishName: "Thai",
+    currencyCode: "THB",
+    dateFormat: "DD/MM/YYYY"
+  },
+  // 베트남어
+  vi: {
+    locale: "vi",
+    countryCode: "VN",
+    flag: "🇻🇳",
+    dialCode: "+84",
+    nativeName: "Ti\u1EBFng Vi\u1EC7t",
+    englishName: "Vietnamese",
+    currencyCode: "VND",
+    dateFormat: "DD/MM/YYYY"
+  },
+  // 인도네시아어
+  id: {
+    locale: "id",
+    countryCode: "ID",
+    flag: "🇮🇩",
+    dialCode: "+62",
+    nativeName: "Bahasa Indonesia",
+    englishName: "Indonesian",
+    currencyCode: "IDR",
+    dateFormat: "DD/MM/YYYY"
+  },
+  // 터키어
+  tr: {
+    locale: "tr",
+    countryCode: "TR",
+    flag: "🇹🇷",
+    dialCode: "+90",
+    nativeName: "T\xFCrk\xE7e",
+    englishName: "Turkish",
+    currencyCode: "TRY",
+    dateFormat: "DD.MM.YYYY"
+  },
+  // 폴란드어
+  pl: {
+    locale: "pl",
+    countryCode: "PL",
+    flag: "🇵🇱",
+    dialCode: "+48",
+    nativeName: "Polski",
+    englishName: "Polish",
+    currencyCode: "PLN",
+    dateFormat: "DD.MM.YYYY"
+  },
+  // 네덜란드어
+  nl: {
+    locale: "nl",
+    countryCode: "NL",
+    flag: "🇳🇱",
+    dialCode: "+31",
+    nativeName: "Nederlands",
+    englishName: "Dutch",
+    currencyCode: "EUR",
+    dateFormat: "DD-MM-YYYY"
+  },
+  // 중국어 (홍콩)
+  "zh-HK": {
+    locale: "zh-HK",
+    countryCode: "HK",
+    flag: "🇭🇰",
+    dialCode: "+852",
+    nativeName: "\u7E41\u9AD4\u4E2D\u6587 (\u9999\u6E2F)",
+    englishName: "Chinese (Hong Kong)",
+    currencyCode: "HKD",
+    dateFormat: "YYYY/MM/DD"
+  },
+  // 말레이어
+  ms: {
+    locale: "ms",
+    countryCode: "MY",
+    flag: "🇲🇾",
+    dialCode: "+60",
+    nativeName: "Bahasa Melayu",
+    englishName: "Malay",
+    currencyCode: "MYR",
+    dateFormat: "DD/MM/YYYY"
+  },
+  // 영어 (영국)
+  "en-GB": {
+    locale: "en-GB",
+    countryCode: "GB",
+    flag: "🇬🇧",
+    dialCode: "+44",
+    nativeName: "English (UK)",
+    englishName: "English (United Kingdom)",
+    currencyCode: "GBP",
+    dateFormat: "DD/MM/YYYY"
+  },
+  // 영어 (캐나다)
+  "en-CA": {
+    locale: "en-CA",
+    countryCode: "CA",
+    flag: "🇨🇦",
+    dialCode: "+1",
+    nativeName: "English (Canada)",
+    englishName: "English (Canada)",
+    currencyCode: "CAD",
+    dateFormat: "YYYY-MM-DD"
+  },
+  // 영어 (호주)
+  "en-AU": {
+    locale: "en-AU",
+    countryCode: "AU",
+    flag: "🇦🇺",
+    dialCode: "+61",
+    nativeName: "English (Australia)",
+    englishName: "English (Australia)",
+    currencyCode: "AUD",
+    dateFormat: "DD/MM/YYYY"
+  },
+  // 영어 (뉴질랜드)
+  "en-NZ": {
+    locale: "en-NZ",
+    countryCode: "NZ",
+    flag: "🇳🇿",
+    dialCode: "+64",
+    nativeName: "English (New Zealand)",
+    englishName: "English (New Zealand)",
+    currencyCode: "NZD",
+    dateFormat: "DD/MM/YYYY"
+  },
+  // 스페인어 (멕시코)
+  "es-MX": {
+    locale: "es-MX",
+    countryCode: "MX",
+    flag: "🇲🇽",
+    dialCode: "+52",
+    nativeName: "Espa\xF1ol (M\xE9xico)",
+    englishName: "Spanish (Mexico)",
+    currencyCode: "MXN",
+    dateFormat: "DD/MM/YYYY"
+  },
+  // 스페인어 (아르헨티나)
+  "es-AR": {
+    locale: "es-AR",
+    countryCode: "AR",
+    flag: "🇦🇷",
+    dialCode: "+54",
+    nativeName: "Espa\xF1ol (Argentina)",
+    englishName: "Spanish (Argentina)",
+    currencyCode: "ARS",
+    dateFormat: "DD/MM/YYYY"
+  },
+  // 스페인어 (콜롬비아)
+  "es-CO": {
+    locale: "es-CO",
+    countryCode: "CO",
+    flag: "🇨🇴",
+    dialCode: "+57",
+    nativeName: "Espa\xF1ol (Colombia)",
+    englishName: "Spanish (Colombia)",
+    currencyCode: "COP",
+    dateFormat: "DD/MM/YYYY"
+  },
+  // 스웨덴어
+  sv: {
+    locale: "sv",
+    countryCode: "SE",
+    flag: "🇸🇪",
+    dialCode: "+46",
+    nativeName: "Svenska",
+    englishName: "Swedish",
+    currencyCode: "SEK",
+    dateFormat: "YYYY-MM-DD"
+  },
+  // 노르웨이어
+  no: {
+    locale: "no",
+    countryCode: "NO",
+    flag: "🇳🇴",
+    dialCode: "+47",
+    nativeName: "Norsk",
+    englishName: "Norwegian",
+    currencyCode: "NOK",
+    dateFormat: "DD.MM.YYYY"
+  },
+  // 덴마크어
+  da: {
+    locale: "da",
+    countryCode: "DK",
+    flag: "🇩🇰",
+    dialCode: "+45",
+    nativeName: "Dansk",
+    englishName: "Danish",
+    currencyCode: "DKK",
+    dateFormat: "DD-MM-YYYY"
+  },
+  // 핀란드어
+  fi: {
+    locale: "fi",
+    countryCode: "FI",
+    flag: "🇫🇮",
+    dialCode: "+358",
+    nativeName: "Suomi",
+    englishName: "Finnish",
+    currencyCode: "EUR",
+    dateFormat: "DD.MM.YYYY"
+  },
+  // 우크라이나어
+  uk: {
+    locale: "uk",
+    countryCode: "UA",
+    flag: "🇺🇦",
+    dialCode: "+380",
+    nativeName: "\u0423\u043A\u0440\u0430\u0457\u043D\u0441\u044C\u043A\u0430",
+    englishName: "Ukrainian",
+    currencyCode: "UAH",
+    dateFormat: "DD.MM.YYYY"
+  },
+  // 체코어
+  cs: {
+    locale: "cs",
+    countryCode: "CZ",
+    flag: "🇨🇿",
+    dialCode: "+420",
+    nativeName: "\u010Ce\u0161tina",
+    englishName: "Czech",
+    currencyCode: "CZK",
+    dateFormat: "DD.MM.YYYY"
+  },
+  // 헝가리어
+  hu: {
+    locale: "hu",
+    countryCode: "HU",
+    flag: "🇭🇺",
+    dialCode: "+36",
+    nativeName: "Magyar",
+    englishName: "Hungarian",
+    currencyCode: "HUF",
+    dateFormat: "YYYY.MM.DD."
+  },
+  // 루마니아어
+  ro: {
+    locale: "ro",
+    countryCode: "RO",
+    flag: "🇷🇴",
+    dialCode: "+40",
+    nativeName: "Rom\xE2n\u0103",
+    englishName: "Romanian",
+    currencyCode: "RON",
+    dateFormat: "DD.MM.YYYY"
+  },
+  // 불가리아어
+  bg: {
+    locale: "bg",
+    countryCode: "BG",
+    flag: "🇧🇬",
+    dialCode: "+359",
+    nativeName: "\u0411\u044A\u043B\u0433\u0430\u0440\u0441\u043A\u0438",
+    englishName: "Bulgarian",
+    currencyCode: "BGN",
+    dateFormat: "DD.MM.YYYY"
+  },
+  // 크로아티아어
+  hr: {
+    locale: "hr",
+    countryCode: "HR",
+    flag: "🇭🇷",
+    dialCode: "+385",
+    nativeName: "Hrvatski",
+    englishName: "Croatian",
+    currencyCode: "HRK",
+    dateFormat: "DD.MM.YYYY."
+  },
+  // 세르비아어
+  sr: {
+    locale: "sr",
+    countryCode: "RS",
+    flag: "🇷🇸",
+    dialCode: "+381",
+    nativeName: "\u0421\u0440\u043F\u0441\u043A\u0438",
+    englishName: "Serbian",
+    currencyCode: "RSD",
+    dateFormat: "DD.MM.YYYY."
+  },
+  // 슬로바키아어
+  sk: {
+    locale: "sk",
+    countryCode: "SK",
+    flag: "🇸🇰",
+    dialCode: "+421",
+    nativeName: "Sloven\u010Dina",
+    englishName: "Slovak",
+    currencyCode: "EUR",
+    dateFormat: "DD.MM.YYYY"
+  },
+  // 슬로베니아어
+  sl: {
+    locale: "sl",
+    countryCode: "SI",
+    flag: "🇸🇮",
+    dialCode: "+386",
+    nativeName: "Sloven\u0161\u010Dina",
+    englishName: "Slovenian",
+    currencyCode: "EUR",
+    dateFormat: "DD.MM.YYYY"
+  },
+  // 리투아니아어
+  lt: {
+    locale: "lt",
+    countryCode: "LT",
+    flag: "🇱🇹",
+    dialCode: "+370",
+    nativeName: "Lietuvi\u0173",
+    englishName: "Lithuanian",
+    currencyCode: "EUR",
+    dateFormat: "YYYY-MM-DD"
+  },
+  // 라트비아어
+  lv: {
+    locale: "lv",
+    countryCode: "LV",
+    flag: "🇱🇻",
+    dialCode: "+371",
+    nativeName: "Latvie\u0161u",
+    englishName: "Latvian",
+    currencyCode: "EUR",
+    dateFormat: "DD.MM.YYYY."
+  },
+  // 에스토니아어
+  et: {
+    locale: "et",
+    countryCode: "EE",
+    flag: "🇪🇪",
+    dialCode: "+372",
+    nativeName: "Eesti",
+    englishName: "Estonian",
+    currencyCode: "EUR",
+    dateFormat: "DD.MM.YYYY"
+  },
+  // 그리스어
+  el: {
+    locale: "el",
+    countryCode: "GR",
+    flag: "🇬🇷",
+    dialCode: "+30",
+    nativeName: "\u0395\u03BB\u03BB\u03B7\u03BD\u03B9\u03BA\u03AC",
+    englishName: "Greek",
+    currencyCode: "EUR",
+    dateFormat: "DD/MM/YYYY"
+  },
+  // 페르시아어
+  fa: {
+    locale: "fa",
+    countryCode: "IR",
+    flag: "🇮🇷",
+    dialCode: "+98",
+    nativeName: "\u0641\u0627\u0631\u0633\u06CC",
+    englishName: "Persian",
+    rtl: true,
+    currencyCode: "IRR",
+    dateFormat: "YYYY/MM/DD"
+  },
+  // 히브리어
+  he: {
+    locale: "he",
+    countryCode: "IL",
+    flag: "🇮🇱",
+    dialCode: "+972",
+    nativeName: "\u05E2\u05D1\u05E8\u05D9\u05EA",
+    englishName: "Hebrew",
+    rtl: true,
+    currencyCode: "ILS",
+    dateFormat: "DD/MM/YYYY"
+  },
+  // 스와힐리어
+  sw: {
+    locale: "sw",
+    countryCode: "KE",
+    flag: "🇰🇪",
+    dialCode: "+254",
+    nativeName: "Kiswahili",
+    englishName: "Swahili",
+    currencyCode: "KES",
+    dateFormat: "DD/MM/YYYY"
   }
 };
+function getLocaleInfo(locale) {
+  return LOCALE_INFO_MAP[locale];
+}
+function getSupportedLocales() {
+  return Object.keys(LOCALE_INFO_MAP);
+}
+function getFlag(locale) {
+  return LOCALE_INFO_MAP[locale]?.flag ?? "";
+}
+function getDialCode(locale) {
+  return LOCALE_INFO_MAP[locale]?.dialCode ?? "";
+}
+function isRTL(locale) {
+  return LOCALE_INFO_MAP[locale]?.rtl ?? false;
+}
+
+// src/server/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;
+  }
+}
+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;
+}
+async function setLocale(locale) {
+  const config = getCmsConfig();
+  if (!config.supportedLocales.includes(locale)) {
+    throw new Error(
+      `Unsupported locale: ${locale}. Supported locales: ${config.supportedLocales.join(", ")}`
+    );
+  }
+  const cookieStore = await cookies();
+  cookieStore.set(LOCALE_COOKIE_KEY, locale, {
+    path: "/",
+    maxAge: 60 * 60 * 24 * 365,
+    // 1년
+    sameSite: "lax"
+  });
+}
+async function getLocales() {
+  const config = getCmsConfig();
+  return config.supportedLocales;
+}
+async function getLocaleWithInfo() {
+  const locale = await getLocale();
+  const info = getLocaleInfo(locale);
+  return { locale, info };
+}
+async function getLocalesWithInfo() {
+  const config = getCmsConfig();
+  const supportedLocales = config.supportedLocales;
+  return supportedLocales.map((locale) => getLocaleInfo(locale)).filter((info) => info !== void 0);
+}
 export {
   InitCms,
-  cmsApi,
+  LOCALE_COOKIE_KEY,
+  LOCALE_INFO_MAP,
+  getDialCode,
+  getFlag,
+  getLocale,
+  getLocaleInfo,
+  getLocaleWithInfo,
+  getLocales,
+  getLocalesWithInfo,
+  getSupportedLocales,
+  isRTL,
+  setLocale,
   useCmsStore,
   useSection,
   useSections