@spfn/cms 0.1.0-alpha.88 → 0.2.0-beta.1

package/dist/index.d.ts

@@ -1,116 +1,138 @@
-export { L as LOCALE_COOKIE_KEY, e as LOCALE_INFO_MAP, f as LocaleInfo, S as SupportedLocale, a as getAllLocales, d as getDialCode, c as getFlag, g as getLocaleInfo, b as getSupportedLocales, i as isRTL } from './locale.constants-BNkSdNP1.js';
-export { SectionAPI, SectionData } from './server.js';
-export { F as FlatLabel, a as LabelDefinition, L as LabelType, N as NestedLabels, S as SectionDefinition, b as SyncOptions, c as SyncResult } from './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';
+import * as _spfn_core_nextjs from '@spfn/core/nextjs';
+import * as _spfn_core_route from '@spfn/core/route';
+import * as _sinclair_typebox from '@sinclair/typebox';
 
 /**
- * CMS Configuration Module
+ * Bind locale to labels, returning locale-specific values
  *
- * 환경변수 기반 CMS 설정 관리
- * - SPFN_CMS_DEFAULT_LOCALE: 기본 언어 (기본값: 'ko')
- * - SPFN_CMS_SUPPORTED_LOCALES: 지원 언어 목록, 쉼표로 구분 (기본값: 'ko,en')
- * - SPFN_CMS_DETECT_BROWSER_LANGUAGE: 브라우저 언어 자동 감지 (기본값: 'false')
+ * @example
+ * ```ts
+ * const labelsDefinition = defineLabels({
+ *     home: {
+ *         title: { en: "Home", ko: "홈" }
+ *     }
+ * });
+ *
+ * const labels = bindLocale(labelsDefinition, 'ko');
+ * labels.home.title // "홈"
+ * ```
  */
 /**
- * CMS 설정 타입
+ * Type that converts locale records to strings
  */
-interface CmsConfig {
-    /**
-     * 기본 언어 코드
-     * @example 'ko', 'en', 'ja'
-     */
-    defaultLocale: string;
-    /**
-     * 프로젝트에서 사용할 언어 목록
-     * @example ['ko', 'en', 'ja']
-     */
-    locales: string[];
-    /**
-     * @deprecated Use 'locales' instead
-     * @internal For backward compatibility
-     */
-    supportedLocales: string[];
-    /**
-     * 브라우저 언어 자동 감지 여부
-     * @default true
-     */
-    detectBrowserLanguage: boolean;
-}
+type BoundLabels<T> = {
+    [K in keyof T]: T[K] extends Record<string, any> ? IsLocaleRecord<T[K]> extends true ? string : BoundLabels<T[K]> : T[K];
+};
 /**
- * CMS 설정 조회
- *
- * @returns 현재 CMS 설정
- *
- * @example
- * ```tsx
- * import { getCmsConfig } from '@spfn/cms';
- *
- * const config = getCmsConfig();
- * console.log(config.defaultLocale); // 'en'
- * console.log(config.locales); // ['en', 'ko']
- * ```
+ * Extract section keys from label definition
  */
-declare function getCmsConfig(): Readonly<CmsConfig>;
+type SectionKeys<T> = Extract<keyof T, string>;
 /**
- * CMS 설정 변경 (런타임 오버라이드)
- *
- * 환경변수 설정을 런타임에 오버라이드합니다.
- * 주로 테스트나 특수한 경우에 사용됩니다.
- *
- * @param config - 변경할 설정 (부분 업데이트 가능)
+ * Get content of a single section (without section name wrapper)
+ */
+type BoundLabelSection<T, K extends SectionKeys<T>> = BoundLabels<T>[K];
+/**
+ * Pick specific sections from bound labels (for multiple sections)
+ */
+type BoundLabelsSections<T, K extends SectionKeys<T>> = Pick<BoundLabels<T>, K>;
+/**
+ * Check if object is a locale record (has string values only)
+ */
+type IsLocaleRecord<T> = T extends Record<string, string> ? true : false;
+
+/**
+ * Defines a type-safe label configuration.
  *
  * @example
- * ```tsx
- * import { configureCms } from '@spfn/cms';
- *
- * // 앱 초기화 시 (선택적)
- * configureCms({
+ * ```ts
+ * export const labelConfig = defineLabelConfig({
+ *     locales: ['en', 'ar'] as const,
  *     defaultLocale: 'en',
- *     locales: ['en', 'ko', 'ja'],
- *     detectBrowserLanguage: true,
+ *     fallbackLocale: 'en', // Optional
  * });
+ *
+ * export type LabelConfig = typeof labelConfig;
+ * export type AppLocale = typeof labelConfig.locales[number]; // 'en' | 'ar'
  * ```
  */
-declare function configureCms(config: Partial<CmsConfig>): void;
+declare function defineLabelConfig<const TLocales extends readonly string[]>(config: {
+    locales: TLocales;
+    defaultLocale: TLocales[number];
+    fallbackLocale?: TLocales[number];
+    useBrowserLanguage?: boolean;
+}): {
+    locales: TLocales;
+    defaultLocale: TLocales[number];
+    fallbackLocale?: TLocales[number];
+    useBrowserLanguage?: boolean;
+};
 /**
- * 설정 초기화 (환경변수에서 재로드)
+ * Define nested label structure (tRPC-style)
  *
  * @example
- * ```tsx
- * import { resetCmsConfig } from '@spfn/cms';
+ * ```ts
+ * export const labels = defineLabels({
+ *     home: {
+ *         slogan: { en: "Welcome", ko: "환영합니다" },
+ *         hero: {
+ *             title: { en: "Hello", ko: "안녕하세요" }
+ *         }
+ *     },
+ *     about: {
+ *         title: { en: "About Us", ko: "회사 소개" }
+ *     }
+ * });
  *
- * // 환경변수 설정으로 되돌리기
- * resetCmsConfig();
+ * // Usage
+ * labels.home.slogan;
+ * labels.home.hero.title;
+ * labels.about.title;
  * ```
  */
-declare function resetCmsConfig(): void;
+declare function defineLabels<const T>(labels: T): T;
+declare function format(template: string, vars: Record<string, string | number>): string;
 
 /**
- * CMS Constants
- *
- * CMS 패키지에서 사용하는 전역 상수
- */
-/**
- * 기본 라벨 디렉토리 경로
+ * Create CMS client with API, label getters, and format utility
  *
- * JSON 라벨 파일이 저장되는 기본 디렉토리입니다.
- * 프로젝트 루트 기준 상대 경로입니다.
+ * @param labelsDefinition - Labels defined using defineLabels()
+ * @param config - Label config from defineLabelConfig()
+ * @returns API client, getLabel (single), getLabels (multiple), and format utility
  *
  * @example
  * ```typescript
- * import { DEFAULT_LABELS_DIR } from '@spfn/cms';
+ * // labels.ts - Setup once
+ * export const { api, getLabel, getLabels, format } = createCmsClient(labelsDefinition, labelConfig);
  *
- * console.log(DEFAULT_LABELS_DIR); // 'src/lib/labels'
+ * // Single section - direct access
+ * const label = await getLabel('home');
+ * label.hero.title // "Hello" (no section name!)
+ *
+ * // Multiple sections - with section names
+ * const labels = await getLabels(['home', 'about']);
+ * labels.home.hero.title // "Hello"
+ * labels.about.title // "About Us"
+ *
+ * // With template variables
+ * const greeting = label.hero.greeting; // "Hello {name}"
+ * format(greeting, { name: "John" }); // "Hello John"
  * ```
  */
-declare const DEFAULT_LABELS_DIR = "src/lib/labels";
+declare function createCmsClient<T>(labelsDefinition: T, config: {
+    defaultLocale: string;
+    fallbackLocale?: string;
+}): {
+    api: _spfn_core_nextjs.Client<_spfn_core_route.Router<{
+        getLabelCache: _spfn_core_route.RouteDef<{
+            query: _sinclair_typebox.TObject<{
+                sections: _sinclair_typebox.TArray<_sinclair_typebox.TString>;
+                locale: _sinclair_typebox.TOptional<_sinclair_typebox.TString>;
+            }>;
+        }, {}, Record<string, any>>;
+    }>>;
+    getLabel: <K extends SectionKeys<T>>(section: K) => Promise<BoundLabelSection<T, K>>;
+    getLabels: <K extends SectionKeys<T>>(sections: readonly K[]) => Promise<BoundLabelsSections<T, K>>;
+    format: typeof format;
+};
 
-export { type CmsConfig, DEFAULT_LABELS_DIR, configureCms, getCmsConfig, resetCmsConfig };
+export { type BoundLabelSection, type BoundLabels, type BoundLabelsSections, type SectionKeys, createCmsClient, defineLabelConfig, defineLabels, format };