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

package/dist/store.d.ts

@@ -1,12 +1,6 @@
-/**
- * CMS Zustand Store
- *
- * 클라이언트 컴포넌트에서 CMS 사용을 위한 상태 관리
- * - 서버에서 초기화된 데이터를 클라이언트로 전달
- * - 클라이언트에서 비동기로 로드 가능
- * - 서버 API와 동일한 패턴 ({ t } 사용)
- */
-import type { SectionData } from './server';
+import * as zustand from 'zustand';
+import { SectionData } from './server.js';
+
 interface CmsState {
     /**
      * 섹션별 데이터
@@ -38,7 +32,7 @@ interface CmsState {
      */
     reset: () => void;
 }
-export declare const useCmsStore: import("zustand").UseBoundStore<import("zustand").StoreApi<CmsState>>;
+declare const useCmsStore: zustand.UseBoundStore<zustand.StoreApi<CmsState>>;
 /**
  * 섹션 Hook (서버 API와 동일한 패턴)
  *
@@ -58,7 +52,7 @@ export declare const useCmsStore: import("zustand").UseBoundStore<import("zustan
  * }
  * ```
  */
-export declare function useSection(section: string, options?: {
+declare function useSection(section: string, options?: {
     autoLoad?: boolean;
     locale?: string;
 }): {
@@ -78,10 +72,10 @@ export declare function useSection(section: string, options?: {
  * sections.home.t('hero.title');
  * ```
  */
-export declare function useSections(sectionNames: string[]): Record<string, {
+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
+
+export { useCmsStore, useSection, useSections };

package/dist/store.js

@@ -1,205 +1,403 @@
-/**
- * CMS Zustand Store
- *
- * 클라이언트 컴포넌트에서 CMS 사용을 위한 상태 관리
- * - 서버에서 초기화된 데이터를 클라이언트로 전달
- * - 클라이언트에서 비동기로 로드 가능
- * - 서버 API와 동일한 패턴 ({ t } 사용)
- */
-'use client';
-import React from 'react';
-import { create } from 'zustand';
-import { cmsApi } from './client';
-/**
- * 변수 치환 헬퍼 (서버와 동일)
- */
+"use client";
+
+// src/store.ts
+import React from "react";
+import { create } from "zustand";
+
+// src/client.ts
+import { client } from "@spfn/core/client";
+
+// src/contracts/labels.ts
+import { Type } from "@sinclair/typebox";
+var getLabelsContract = {
+  method: "GET",
+  path: "/cms/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" })),
+    offset: Type.Optional(Type.Number({ minimum: 0, default: 0, description: "\uC2DC\uC791 \uC624\uD504\uC14B" }))
+  }),
+  response: Type.Object({
+    labels: Type.Array(Type.Object({
+      id: Type.Number(),
+      key: Type.String(),
+      section: Type.String(),
+      type: Type.String(),
+      publishedVersion: Type.Union([Type.Number(), Type.Null()]),
+      createdBy: Type.Union([Type.String(), Type.Null()]),
+      createdAt: Type.String(),
+      updatedAt: Type.String()
+    })),
+    total: Type.Number(),
+    limit: Type.Number(),
+    offset: Type.Number()
+  })
+};
+var createLabelContract = {
+  method: "POST",
+  path: "/cms/labels",
+  body: Type.Object({
+    key: Type.String({
+      description: "\uACE0\uC720 \uD0A4 (\uC608: home.hero.title)",
+      pattern: "^[a-z0-9-]+\\.[a-z0-9-]+\\.[a-z0-9-]+$"
+    }),
+    section: Type.String({
+      description: "\uC139\uC158 \uC774\uB984 (\uC608: home, why-futureplay)",
+      pattern: "^[a-z0-9-]+$"
+    }),
+    type: Type.Union([
+      Type.Literal("text"),
+      Type.Literal("image"),
+      Type.Literal("video"),
+      Type.Literal("file"),
+      Type.Literal("object")
+    ], { description: "\uAC12 \uD0C0\uC785" }),
+    createdBy: Type.Optional(Type.String({ description: "\uC0DD\uC131\uC790 ID" }))
+  }),
+  response: Type.Union([
+    Type.Object({
+      id: Type.Number(),
+      key: Type.String(),
+      section: Type.String(),
+      type: Type.String(),
+      publishedVersion: Type.Union([Type.Number(), Type.Null()]),
+      createdBy: Type.Union([Type.String(), Type.Null()]),
+      createdAt: Type.String(),
+      updatedAt: Type.String()
+    }),
+    Type.Object({
+      error: Type.String(),
+      key: Type.Optional(Type.String())
+    })
+  ])
+};
+var getLabelContract = {
+  method: "GET",
+  path: "/cms/labels/:id",
+  params: Type.Object({
+    id: Type.String({ description: "\uB77C\uBCA8 ID" })
+  }),
+  response: Type.Union([
+    Type.Object({
+      id: Type.Number(),
+      key: Type.String(),
+      section: Type.String(),
+      type: Type.String(),
+      publishedVersion: Type.Union([Type.Number(), Type.Null()]),
+      createdBy: Type.Union([Type.String(), Type.Null()]),
+      createdAt: Type.String(),
+      updatedAt: Type.String()
+    }),
+    Type.Object({
+      error: Type.String()
+    })
+  ])
+};
+var updateLabelContract = {
+  method: "PATCH",
+  path: "/cms/labels/:id",
+  params: Type.Object({
+    id: Type.String({ description: "\uB77C\uBCA8 ID" })
+  }),
+  body: Type.Object({
+    section: Type.Optional(Type.String({ description: "\uC139\uC158 \uBCC0\uACBD" })),
+    type: Type.Optional(Type.Union([
+      Type.Literal("text"),
+      Type.Literal("image"),
+      Type.Literal("video"),
+      Type.Literal("file"),
+      Type.Literal("object")
+    ]))
+  }),
+  response: Type.Union([
+    Type.Object({
+      id: Type.Number(),
+      key: Type.String(),
+      section: Type.String(),
+      type: Type.String(),
+      publishedVersion: Type.Union([Type.Number(), Type.Null()]),
+      createdBy: Type.Union([Type.String(), Type.Null()]),
+      createdAt: Type.String(),
+      updatedAt: Type.String()
+    }),
+    Type.Object({
+      error: Type.String()
+    })
+  ])
+};
+var deleteLabelContract = {
+  method: "DELETE",
+  path: "/cms/labels/:id",
+  params: Type.Object({
+    id: Type.String({ description: "\uB77C\uBCA8 ID" })
+  }),
+  response: Type.Union([
+    Type.Object({
+      success: Type.Boolean(),
+      id: Type.Number()
+    }),
+    Type.Object({
+      error: Type.String()
+    })
+  ])
+};
+var getLabelByKeyContract = {
+  method: "GET",
+  path: "/cms/labels/by-key/:key",
+  params: Type.Object({
+    key: Type.String({ description: "\uB77C\uBCA8 Key (\uC608: home.hero.title)" })
+  }),
+  response: Type.Union([
+    Type.Object({
+      id: Type.Number(),
+      key: Type.String(),
+      section: Type.String(),
+      type: Type.String(),
+      publishedVersion: Type.Union([Type.Number(), Type.Null()]),
+      createdBy: Type.Union([Type.String(), Type.Null()]),
+      createdAt: Type.String(),
+      updatedAt: Type.String()
+    }),
+    Type.Object({
+      error: Type.String(),
+      key: Type.Optional(Type.String())
+    })
+  ])
+};
+
+// src/contracts/published-cache.ts
+import { Type as Type2 } from "@sinclair/typebox";
+var SectionData = Type2.Object({
+  section: Type2.String(),
+  locale: Type2.String(),
+  content: Type2.Record(Type2.String(), Type2.Any()),
+  version: Type2.Number(),
+  publishedAt: Type2.Union([Type2.String(), Type2.Null()])
+});
+var getPublishedCacheContract = {
+  method: "GET",
+  path: "/cms/published-cache",
+  query: Type2.Object({
+    sections: Type2.Union([
+      Type2.String({ description: "\uB2E8\uC77C \uC139\uC158 \uC774\uB984 (\uC608: home)" }),
+      Type2.Array(Type2.String(), { description: '\uC5EC\uB7EC \uC139\uC158 \uC774\uB984 (\uC608: ["home", "footer"])' })
+    ]),
+    locale: Type2.Optional(Type2.String({ default: "ko", description: "\uC5B8\uC5B4 \uCF54\uB4DC" }))
+  }),
+  response: Type2.Union([
+    // 성공: 항상 배열로 반환
+    Type2.Array(SectionData),
+    // 에러
+    Type2.Object({
+      error: Type2.String()
+    })
+  ])
+};
+
+// src/init.tsx
+import { useEffect } from "react";
+
+// 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)
+  },
+  /**
+   * Published Cache API
+   */
+  publishedCache: {
+    /**
+     * GET /cms/published-cache
+     * 발행된 콘텐츠 캐시 조회
+     */
+    get: (options) => client.call(getPublishedCacheContract, options)
+  }
+};
+
+// src/store.ts
 function replaceVariables(text, replace) {
-    return text.replace(/\{(\w+)}/g, (match, key) => {
-        const value = replace[key];
-        return value !== undefined ? String(value) : match;
-    });
+  return text.replace(/\{(\w+)}/g, (match, key) => {
+    const value = replace[key];
+    return value !== void 0 ? 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 },
-            }));
+var 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((state2) => ({
+      loading: { ...state2.loading, [section]: true }
+    }));
+    try {
+      const response = await cmsApi.publishedCache.get({
+        query: { sections: section, locale }
+      });
+      if ("error" in response) {
+        console.error(`Failed to load section ${section}:`, response.error);
+        return;
+      }
+      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((state2) => ({
+        sections: {
+          ...state2.sections,
+          [section]: sectionData
+        },
+        loading: { ...state2.loading, [section]: false }
+      }));
+    } catch (error) {
+      console.error(`Error loading CMS section ${section}:`, error);
+      set((state2) => ({
+        loading: { ...state2.loading, [section]: false }
+      }));
+    }
+  },
+  updateLabel: (section, key, value) => {
+    set((state) => ({
+      sections: {
+        ...state.sections,
+        [section]: {
+          ...state.sections[section],
+          content: {
+            ...state.sections[section]?.content,
+            [`${section}.${key}`]: value
+          }
         }
-        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: {},
-        });
-    },
+      }
+    }));
+  },
+  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,
-    };
+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]);
+  const t = React.useCallback(
+    (key, defaultValue, replace) => {
+      if (!sectionData) {
+        return defaultValue;
+      }
+      const fullKey = `${section}.${key}`;
+      let value = sectionData.content[fullKey];
+      if (value === void 0) {
+        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;
+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 === void 0) {
+        value = defaultValue;
+      }
+      if (typeof value === "string" && replace) {
+        value = replaceVariables(value, replace);
+      }
+      return value;
+    };
+    result[section] = {
+      t,
+      data: sectionData,
+      loading
+    };
+  });
+  return result;
 }
+export {
+  useCmsStore,
+  useSection,
+  useSections
+};
 //# sourceMappingURL=store.js.map