@spfn/cms 0.1.0-alpha.9 → 0.2.0-beta.2

package/dist/actions.d.ts

@@ -1,9 +1,15 @@
 /**
- * @spfn/cms/actions
+ * Set user's preferred locale in cookie
  *
- * Server Actions
- * 서버/클라이언트 컴포넌트 양쪽에서 사용 가능한 Server Actions
+ * @param locale - Language code (e.g., 'ko', 'en', 'ja')
  */
-export { getLocale, setLocale, getLocales, } from './helpers/locale.actions.js';
-export { LOCALE_COOKIE_KEY } from './helpers/locale.constants.js';
-//# sourceMappingURL=actions.d.ts.map
+declare function setLocale(locale: string): Promise<void>;
+/**
+ * Get user's preferred locale from cookie
+ *
+ * @param defaultLocale - Default locale from labelConfig.defaultLocale
+ * @returns Language code (from cookie, or defaultLocale, or 'en')
+ */
+declare function getLocale(defaultLocale?: string): Promise<string>;
+
+export { getLocale, setLocale };

package/dist/actions.js

@@ -1,11 +1,26 @@
-/**
- * @spfn/cms/actions
- *
- * Server Actions
- * 서버/클라이언트 컴포넌트 양쪽에서 사용 가능한 Server Actions
- */
-// Locale Server Actions
-export { getLocale, setLocale, getLocales, } from './helpers/locale.actions.js';
-// Locale Constants
-export { LOCALE_COOKIE_KEY } from './helpers/locale.constants.js';
+"use server";
+
+// src/actions.ts
+import { cookies } from "next/headers";
+var LOCALE_COOKIE_NAME = "cms-locale";
+var LOCALE_MAX_AGE = 365 * 24 * 60 * 60;
+async function setLocale(locale) {
+  const cookieStore = await cookies();
+  cookieStore.set(LOCALE_COOKIE_NAME, locale, {
+    httpOnly: true,
+    secure: process.env.NODE_ENV === "production",
+    sameSite: "lax",
+    maxAge: LOCALE_MAX_AGE,
+    path: "/"
+  });
+}
+async function getLocale(defaultLocale) {
+  const cookieStore = await cookies();
+  const localeCookie = cookieStore.get(LOCALE_COOKIE_NAME);
+  return localeCookie?.value ?? defaultLocale ?? "en";
+}
+export {
+  getLocale,
+  setLocale
+};
 //# sourceMappingURL=actions.js.map

package/dist/actions.js.map

@@ -1 +1 @@
-{"version":3,"file":"actions.js","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,wBAAwB;AACxB,OAAO,EACH,SAAS,EACT,SAAS,EACT,UAAU,GACb,MAAM,6BAA6B,CAAC;AAErC,mBAAmB;AACnB,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC"}
+{"version":3,"sources":["../src/actions.ts"],"sourcesContent":["\"use server\"\n\nimport { cookies } from 'next/headers';\n\nconst LOCALE_COOKIE_NAME = 'cms-locale';\nconst LOCALE_MAX_AGE = 365 * 24 * 60 * 60; // 1 year\n\n/**\n * Set user's preferred locale in cookie\n *\n * @param locale - Language code (e.g., 'ko', 'en', 'ja')\n */\nexport async function setLocale(locale: string): Promise<void>\n{\n    const cookieStore = await cookies();\n\n    cookieStore.set(LOCALE_COOKIE_NAME, locale, {\n        httpOnly: true,\n        secure: process.env.NODE_ENV === 'production',\n        sameSite: 'lax',\n        maxAge: LOCALE_MAX_AGE,\n        path: '/',\n    });\n}\n\n/**\n * Get user's preferred locale from cookie\n *\n * @param defaultLocale - Default locale from labelConfig.defaultLocale\n * @returns Language code (from cookie, or defaultLocale, or 'en')\n */\nexport async function getLocale(defaultLocale?: string): Promise<string>\n{\n    const cookieStore = await cookies();\n    const localeCookie = cookieStore.get(LOCALE_COOKIE_NAME);\n\n    return localeCookie?.value ?? defaultLocale ?? 'en';\n}"],"mappings":";;;AAEA,SAAS,eAAe;AAExB,IAAM,qBAAqB;AAC3B,IAAM,iBAAiB,MAAM,KAAK,KAAK;AAOvC,eAAsB,UAAU,QAChC;AACI,QAAM,cAAc,MAAM,QAAQ;AAElC,cAAY,IAAI,oBAAoB,QAAQ;AAAA,IACxC,UAAU;AAAA,IACV,QAAQ,QAAQ,IAAI,aAAa;AAAA,IACjC,UAAU;AAAA,IACV,QAAQ;AAAA,IACR,MAAM;AAAA,EACV,CAAC;AACL;AAQA,eAAsB,UAAU,eAChC;AACI,QAAM,cAAc,MAAM,QAAQ;AAClC,QAAM,eAAe,YAAY,IAAI,kBAAkB;AAEvD,SAAO,cAAc,SAAS,iBAAiB;AACnD;","names":[]}

package/dist/config.d.ts

@@ -0,0 +1,39 @@
+import * as _spfn_core_env from '@spfn/core/env';
+
+/**
+ * Core Package Configuration
+ *
+ * @example
+ * ```typescript
+ * import { registry } from '@spfn/core/config';
+ *
+ * const env = registry.validate();
+ * console.log(env.DB_POOL_MAX);
+ * ```
+ *
+ * @module config
+ */
+declare const env: _spfn_core_env.InferEnvType<{
+    SPFN_CMS_DEFAULT_LOCALE: {
+        description: string;
+        default: string;
+        required: boolean;
+        category: string;
+        examples: string[];
+        type: "string";
+    } & {
+        key: "SPFN_CMS_DEFAULT_LOCALE";
+    };
+    SPFN_CMS_DETECT_BROWSER_LANGUAGE: {
+        description: string;
+        default: boolean;
+        required: boolean;
+        category: string;
+        type: "boolean";
+        validator: (value: string) => boolean;
+    } & {
+        key: "SPFN_CMS_DETECT_BROWSER_LANGUAGE";
+    };
+}>;
+
+export { env };

package/dist/config.js

@@ -0,0 +1,39 @@
+// src/config/index.ts
+import { createEnvRegistry } from "@spfn/core/env";
+
+// src/config/schema.ts
+import {
+  defineEnvSchema,
+  envString,
+  envBoolean
+} from "@spfn/core/env";
+var cmsEnvSchema = defineEnvSchema({
+  // ============================================================================
+  // Locale Configuration
+  // ============================================================================
+  SPFN_CMS_DEFAULT_LOCALE: {
+    ...envString({
+      description: "[DEPRECATED] Use labelConfig.defaultLocale instead. Default language for CMS content (ISO 639-1 language code)",
+      default: "en",
+      required: false,
+      category: "cms",
+      examples: ["en", "ko", "ja", "zh", "es", "fr", "de"]
+    })
+  },
+  SPFN_CMS_DETECT_BROWSER_LANGUAGE: {
+    ...envBoolean({
+      description: "Automatically detect and use browser language for content localization",
+      default: true,
+      required: false,
+      category: "cms"
+    })
+  }
+});
+
+// src/config/index.ts
+var registry = createEnvRegistry(cmsEnvSchema);
+var env = registry.validate();
+export {
+  env
+};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config/index.ts","../src/config/schema.ts"],"sourcesContent":["/**\n * Core Package Configuration\n *\n * @example\n * ```typescript\n * import { registry } from '@spfn/core/config';\n *\n * const env = registry.validate();\n * console.log(env.DB_POOL_MAX);\n * ```\n *\n * @module config\n */\n\nimport { createEnvRegistry } from '@spfn/core/env';\nimport { cmsEnvSchema } from './schema';\n\n/**\n * Environment registry\n */\nconst registry = createEnvRegistry(cmsEnvSchema);\nexport const env = registry.validate();","/**\n * CMS Environment Variable Schema\n *\n * Centralized schema definition for all environment variables used in @spfn/cms.\n * This provides type safety, validation, and documentation for CMS configuration.\n *\n * @module config/schema\n */\n\nimport {\n    defineEnvSchema,\n    envString,\n    envBoolean,\n} from '@spfn/core/env';\n\n/**\n * CMS environment variable schema\n *\n * Defines all CMS environment variables with:\n * - Type information\n * - Default values\n * - Validation rules\n * - Documentation\n *\n * @example\n * ```typescript\n * import { cmsEnvSchema } from '@spfn/cms/config';\n *\n * // Access schema information\n * console.log(cmsEnvSchema.SPFN_CMS_DEFAULT_LOCALE.description);\n * console.log(cmsEnvSchema.SPFN_CMS_DEFAULT_LOCALE.default);\n * ```\n */\nexport const cmsEnvSchema = defineEnvSchema({\n    // ============================================================================\n    // Locale Configuration\n    // ============================================================================\n    SPFN_CMS_DEFAULT_LOCALE: {\n        ...envString({\n            description: '[DEPRECATED] Use labelConfig.defaultLocale instead. Default language for CMS content (ISO 639-1 language code)',\n            default: 'en',\n            required: false,\n            category: 'cms',\n            examples: ['en', 'ko', 'ja', 'zh', 'es', 'fr', 'de'],\n        }),\n    },\n\n    SPFN_CMS_DETECT_BROWSER_LANGUAGE: {\n        ...envBoolean({\n            description: 'Automatically detect and use browser language for content localization',\n            default: true,\n            required: false,\n            category: 'cms',\n        }),\n    },\n});"],"mappings":";AAcA,SAAS,yBAAyB;;;ACLlC;AAAA,EACI;AAAA,EACA;AAAA,EACA;AAAA,OACG;AAoBA,IAAM,eAAe,gBAAgB;AAAA;AAAA;AAAA;AAAA,EAIxC,yBAAyB;AAAA,IACrB,GAAG,UAAU;AAAA,MACT,aAAa;AAAA,MACb,SAAS;AAAA,MACT,UAAU;AAAA,MACV,UAAU;AAAA,MACV,UAAU,CAAC,MAAM,MAAM,MAAM,MAAM,MAAM,MAAM,IAAI;AAAA,IACvD,CAAC;AAAA,EACL;AAAA,EAEA,kCAAkC;AAAA,IAC9B,GAAG,WAAW;AAAA,MACV,aAAa;AAAA,MACb,SAAS;AAAA,MACT,UAAU;AAAA,MACV,UAAU;AAAA,IACd,CAAC;AAAA,EACL;AACJ,CAAC;;;ADnCD,IAAM,WAAW,kBAAkB,YAAY;AACxC,IAAM,MAAM,SAAS,SAAS;","names":[]}

package/dist/errors.d.ts

@@ -0,0 +1,149 @@
+import { NotFoundError, ConflictError, ValidationError, InternalServerError, ForbiddenError } from '@spfn/core/errors';
+
+/**
+ * CMS Error Classes
+ *
+ * Custom error classes for CMS-specific scenarios
+ */
+
+/**
+ * Label Not Found Error (404)
+ *
+ * Thrown when a CMS label does not exist
+ */
+declare class LabelNotFoundError extends NotFoundError {
+    constructor(data?: {
+        labelKey?: string;
+        labelId?: number;
+        message?: string;
+        details?: Record<string, any>;
+    });
+}
+/**
+ * Label Value Not Found Error (404)
+ *
+ * Thrown when a CMS label value does not exist
+ */
+declare class LabelValueNotFoundError extends NotFoundError {
+    constructor(data?: {
+        labelKey?: string;
+        locale?: string;
+        valueId?: number;
+        message?: string;
+        details?: Record<string, any>;
+    });
+}
+/**
+ * Locale Not Found Error (404)
+ *
+ * Thrown when requested locale does not exist in the system
+ */
+declare class LocaleNotFoundError extends NotFoundError {
+    constructor(data?: {
+        locale?: string;
+        message?: string;
+        details?: Record<string, any>;
+    });
+}
+/**
+ * Published Cache Not Found Error (404)
+ *
+ * Thrown when published cache does not exist
+ */
+declare class PublishedCacheNotFoundError extends NotFoundError {
+    constructor(data?: {
+        locale?: string;
+        message?: string;
+        details?: Record<string, any>;
+    });
+}
+/**
+ * Duplicate Label Error (409)
+ *
+ * Thrown when trying to create a label with existing key
+ */
+declare class DuplicateLabelError extends ConflictError {
+    constructor(data?: {
+        labelKey?: string;
+        message?: string;
+        details?: Record<string, any>;
+    });
+}
+/**
+ * Duplicate Label Value Error (409)
+ *
+ * Thrown when trying to create a label value that already exists
+ */
+declare class DuplicateLabelValueError extends ConflictError {
+    constructor(data?: {
+        labelKey?: string;
+        locale?: string;
+        message?: string;
+        details?: Record<string, any>;
+    });
+}
+/**
+ * Invalid Locale Error (400)
+ *
+ * Thrown when locale format is invalid or not supported
+ */
+declare class InvalidLocaleError extends ValidationError {
+    constructor(data?: {
+        locale?: string;
+        message?: string;
+        details?: Record<string, any>;
+    });
+}
+/**
+ * Invalid Label Key Error (400)
+ *
+ * Thrown when label key format is invalid
+ */
+declare class InvalidLabelKeyError extends ValidationError {
+    constructor(data?: {
+        labelKey?: string;
+        message?: string;
+        details?: Record<string, any>;
+    });
+}
+/**
+ * Invalid Published Cache Error (400)
+ *
+ * Thrown when published cache data is malformed or corrupted
+ */
+declare class InvalidPublishedCacheError extends ValidationError {
+    constructor(data?: {
+        locale?: string;
+        reason?: string;
+        message?: string;
+        details?: Record<string, any>;
+    });
+}
+/**
+ * CMS Operation Failed Error (500)
+ *
+ * Thrown when CMS operation fails unexpectedly
+ */
+declare class CMSOperationFailedError extends InternalServerError {
+    constructor(data?: {
+        operation?: string;
+        resource?: string;
+        message?: string;
+        details?: Record<string, any>;
+    });
+}
+/**
+ * Insufficient CMS Permissions Error (403)
+ *
+ * Thrown when user lacks required CMS permissions
+ */
+declare class InsufficientCMSPermissionsError extends ForbiddenError {
+    constructor(data?: {
+        requiredPermissions?: string[];
+        resource?: string;
+        message?: string;
+        details?: Record<string, any>;
+    });
+}
+
+export { CMSOperationFailedError, DuplicateLabelError, DuplicateLabelValueError, InsufficientCMSPermissionsError, InvalidLabelKeyError, InvalidLocaleError, InvalidPublishedCacheError, LabelNotFoundError, LabelValueNotFoundError, LocaleNotFoundError, PublishedCacheNotFoundError };

package/dist/errors.js

@@ -0,0 +1,164 @@
+// src/errors/cms-errors.ts
+import {
+  ValidationError,
+  NotFoundError,
+  ConflictError,
+  ForbiddenError,
+  InternalServerError
+} from "@spfn/core/errors";
+var LabelNotFoundError = class extends NotFoundError {
+  constructor(data = {}) {
+    super({
+      message: data.message || "Label not found",
+      details: {
+        labelKey: data.labelKey,
+        labelId: data.labelId,
+        ...data.details
+      }
+    });
+    this.name = "LabelNotFoundError";
+  }
+};
+var LabelValueNotFoundError = class extends NotFoundError {
+  constructor(data = {}) {
+    super({
+      message: data.message || "Label value not found",
+      details: {
+        labelKey: data.labelKey,
+        locale: data.locale,
+        valueId: data.valueId,
+        ...data.details
+      }
+    });
+    this.name = "LabelValueNotFoundError";
+  }
+};
+var LocaleNotFoundError = class extends NotFoundError {
+  constructor(data = {}) {
+    super({
+      message: data.message || "Locale not found",
+      details: {
+        locale: data.locale,
+        ...data.details
+      }
+    });
+    this.name = "LocaleNotFoundError";
+  }
+};
+var PublishedCacheNotFoundError = class extends NotFoundError {
+  constructor(data = {}) {
+    super({
+      message: data.message || "Published cache not found",
+      details: {
+        locale: data.locale,
+        ...data.details
+      }
+    });
+    this.name = "PublishedCacheNotFoundError";
+  }
+};
+var DuplicateLabelError = class extends ConflictError {
+  constructor(data = {}) {
+    super({
+      message: data.message || "Label already exists",
+      details: {
+        labelKey: data.labelKey,
+        ...data.details
+      }
+    });
+    this.name = "DuplicateLabelError";
+  }
+};
+var DuplicateLabelValueError = class extends ConflictError {
+  constructor(data = {}) {
+    super({
+      message: data.message || "Label value already exists for this locale",
+      details: {
+        labelKey: data.labelKey,
+        locale: data.locale,
+        ...data.details
+      }
+    });
+    this.name = "DuplicateLabelValueError";
+  }
+};
+var InvalidLocaleError = class extends ValidationError {
+  constructor(data = {}) {
+    super({
+      message: data.message || "Invalid locale",
+      details: {
+        locale: data.locale,
+        ...data.details
+      }
+    });
+    this.name = "InvalidLocaleError";
+  }
+};
+var InvalidLabelKeyError = class extends ValidationError {
+  constructor(data = {}) {
+    super({
+      message: data.message || "Invalid label key format",
+      details: {
+        labelKey: data.labelKey,
+        ...data.details
+      }
+    });
+    this.name = "InvalidLabelKeyError";
+  }
+};
+var InvalidPublishedCacheError = class extends ValidationError {
+  constructor(data = {}) {
+    super({
+      message: data.message || "Invalid published cache data",
+      details: {
+        locale: data.locale,
+        reason: data.reason,
+        ...data.details
+      }
+    });
+    this.name = "InvalidPublishedCacheError";
+  }
+};
+var CMSOperationFailedError = class extends InternalServerError {
+  constructor(data = {}) {
+    const operation = data.operation || "operation";
+    const resource = data.resource || "resource";
+    super({
+      message: data.message || `Failed to ${operation} ${resource}`,
+      details: {
+        operation,
+        resource,
+        ...data.details
+      }
+    });
+    this.name = "CMSOperationFailedError";
+  }
+};
+var InsufficientCMSPermissionsError = class extends ForbiddenError {
+  constructor(data = {}) {
+    const requiredPermissions = data.requiredPermissions || [];
+    super({
+      message: data.message || `Missing required CMS permissions: ${requiredPermissions.join(", ")}`,
+      details: {
+        requiredPermissions,
+        resource: data.resource,
+        ...data.details
+      }
+    });
+    this.name = "InsufficientCMSPermissionsError";
+  }
+};
+export {
+  CMSOperationFailedError,
+  DuplicateLabelError,
+  DuplicateLabelValueError,
+  InsufficientCMSPermissionsError,
+  InvalidLabelKeyError,
+  InvalidLocaleError,
+  InvalidPublishedCacheError,
+  LabelNotFoundError,
+  LabelValueNotFoundError,
+  LocaleNotFoundError,
+  PublishedCacheNotFoundError
+};
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors/cms-errors.ts"],"sourcesContent":["/**\n * CMS Error Classes\n *\n * Custom error classes for CMS-specific scenarios\n */\n\nimport {\n    ValidationError,\n    NotFoundError,\n    ConflictError,\n    ForbiddenError,\n    InternalServerError\n} from '@spfn/core/errors';\n\n/**\n * Label Not Found Error (404)\n *\n * Thrown when a CMS label does not exist\n */\nexport class LabelNotFoundError extends NotFoundError\n{\n    constructor(data: { labelKey?: string; labelId?: number; message?: string; details?: Record<string, any> } = {})\n    {\n        super({\n            message: data.message || 'Label not found',\n            details: {\n                labelKey: data.labelKey,\n                labelId: data.labelId,\n                ...data.details\n            }\n        });\n        this.name = 'LabelNotFoundError';\n    }\n}\n\n/**\n * Label Value Not Found Error (404)\n *\n * Thrown when a CMS label value does not exist\n */\nexport class LabelValueNotFoundError extends NotFoundError\n{\n    constructor(data: { labelKey?: string; locale?: string; valueId?: number; message?: string; details?: Record<string, any> } = {})\n    {\n        super({\n            message: data.message || 'Label value not found',\n            details: {\n                labelKey: data.labelKey,\n                locale: data.locale,\n                valueId: data.valueId,\n                ...data.details\n            }\n        });\n        this.name = 'LabelValueNotFoundError';\n    }\n}\n\n/**\n * Locale Not Found Error (404)\n *\n * Thrown when requested locale does not exist in the system\n */\nexport class LocaleNotFoundError extends NotFoundError\n{\n    constructor(data: { locale?: string; message?: string; details?: Record<string, any> } = {})\n    {\n        super({\n            message: data.message || 'Locale not found',\n            details: {\n                locale: data.locale,\n                ...data.details\n            }\n        });\n        this.name = 'LocaleNotFoundError';\n    }\n}\n\n/**\n * Published Cache Not Found Error (404)\n *\n * Thrown when published cache does not exist\n */\nexport class PublishedCacheNotFoundError extends NotFoundError\n{\n    constructor(data: { locale?: string; message?: string; details?: Record<string, any> } = {})\n    {\n        super({\n            message: data.message || 'Published cache not found',\n            details: {\n                locale: data.locale,\n                ...data.details\n            }\n        });\n        this.name = 'PublishedCacheNotFoundError';\n    }\n}\n\n/**\n * Duplicate Label Error (409)\n *\n * Thrown when trying to create a label with existing key\n */\nexport class DuplicateLabelError extends ConflictError\n{\n    constructor(data: { labelKey?: string; message?: string; details?: Record<string, any> } = {})\n    {\n        super({\n            message: data.message || 'Label already exists',\n            details: {\n                labelKey: data.labelKey,\n                ...data.details\n            }\n        });\n        this.name = 'DuplicateLabelError';\n    }\n}\n\n/**\n * Duplicate Label Value Error (409)\n *\n * Thrown when trying to create a label value that already exists\n */\nexport class DuplicateLabelValueError extends ConflictError\n{\n    constructor(data: { labelKey?: string; locale?: string; message?: string; details?: Record<string, any> } = {})\n    {\n        super({\n            message: data.message || 'Label value already exists for this locale',\n            details: {\n                labelKey: data.labelKey,\n                locale: data.locale,\n                ...data.details\n            }\n        });\n        this.name = 'DuplicateLabelValueError';\n    }\n}\n\n/**\n * Invalid Locale Error (400)\n *\n * Thrown when locale format is invalid or not supported\n */\nexport class InvalidLocaleError extends ValidationError\n{\n    constructor(data: { locale?: string; message?: string; details?: Record<string, any> } = {})\n    {\n        super({\n            message: data.message || 'Invalid locale',\n            details: {\n                locale: data.locale,\n                ...data.details\n            }\n        });\n        this.name = 'InvalidLocaleError';\n    }\n}\n\n/**\n * Invalid Label Key Error (400)\n *\n * Thrown when label key format is invalid\n */\nexport class InvalidLabelKeyError extends ValidationError\n{\n    constructor(data: { labelKey?: string; message?: string; details?: Record<string, any> } = {})\n    {\n        super({\n            message: data.message || 'Invalid label key format',\n            details: {\n                labelKey: data.labelKey,\n                ...data.details\n            }\n        });\n        this.name = 'InvalidLabelKeyError';\n    }\n}\n\n/**\n * Invalid Published Cache Error (400)\n *\n * Thrown when published cache data is malformed or corrupted\n */\nexport class InvalidPublishedCacheError extends ValidationError\n{\n    constructor(data: { locale?: string; reason?: string; message?: string; details?: Record<string, any> } = {})\n    {\n        super({\n            message: data.message || 'Invalid published cache data',\n            details: {\n                locale: data.locale,\n                reason: data.reason,\n                ...data.details\n            }\n        });\n        this.name = 'InvalidPublishedCacheError';\n    }\n}\n\n/**\n * CMS Operation Failed Error (500)\n *\n * Thrown when CMS operation fails unexpectedly\n */\nexport class CMSOperationFailedError extends InternalServerError\n{\n    constructor(data: { operation?: string; resource?: string; message?: string; details?: Record<string, any> } = {})\n    {\n        const operation = data.operation || 'operation';\n        const resource = data.resource || 'resource';\n        super({\n            message: data.message || `Failed to ${operation} ${resource}`,\n            details: {\n                operation,\n                resource,\n                ...data.details\n            }\n        });\n        this.name = 'CMSOperationFailedError';\n    }\n}\n\n/**\n * Insufficient CMS Permissions Error (403)\n *\n * Thrown when user lacks required CMS permissions\n */\nexport class InsufficientCMSPermissionsError extends ForbiddenError\n{\n    constructor(data: { requiredPermissions?: string[]; resource?: string; message?: string; details?: Record<string, any> } = {})\n    {\n        const requiredPermissions = data.requiredPermissions || [];\n        super({\n            message: data.message || `Missing required CMS permissions: ${requiredPermissions.join(', ')}`,\n            details: {\n                requiredPermissions,\n                resource: data.resource,\n                ...data.details\n            }\n        });\n        this.name = 'InsufficientCMSPermissionsError';\n    }\n}"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -1,20 +1,138 @@
-import "server-only";
-/**
- * @spfn/cms
- *
- * Backend + Server Components
- * 백엔드 및 서버 컴포넌트 전용 (서버에서만 실행)
- *
- * For client components, use: import { ... } from '@spfn/cms/client'
- */
-export { getCmsConfig, configureCms, resetCmsConfig } from './cms.config.js';
-export type { CmsConfig } from './cms.config.js';
-export * from './server.js';
-export type { SectionData, SectionAPI } from './server.js';
-export * from './repositories/index.js';
-export * from './entities/index.js';
-export { syncSection, syncAll, initLabelSync, loadLabelsFromJson } from './helpers/sync.js';
-export * from './labels/index.js';
-export { createLabelSyncGenerator, LabelSyncGenerator } from './generators/label-sync-generator.js';
-export type * from './types.js';
-//# sourceMappingURL=index.d.ts.map
+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';
+
+/**
+ * Bind locale to labels, returning locale-specific values
+ *
+ * @example
+ * ```ts
+ * const labelsDefinition = defineLabels({
+ *     home: {
+ *         title: { en: "Home", ko: "홈" }
+ *     }
+ * });
+ *
+ * const labels = bindLocale(labelsDefinition, 'ko');
+ * labels.home.title // "홈"
+ * ```
+ */
+/**
+ * Type that converts locale records to strings
+ */
+type BoundLabels<T> = {
+    [K in keyof T]: T[K] extends Record<string, any> ? IsLocaleRecord<T[K]> extends true ? string : BoundLabels<T[K]> : T[K];
+};
+/**
+ * Extract section keys from label definition
+ */
+type SectionKeys<T> = Extract<keyof T, string>;
+/**
+ * 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
+ * ```ts
+ * export const labelConfig = defineLabelConfig({
+ *     locales: ['en', 'ar'] as const,
+ *     defaultLocale: 'en',
+ *     fallbackLocale: 'en', // Optional
+ * });
+ *
+ * export type LabelConfig = typeof labelConfig;
+ * export type AppLocale = typeof labelConfig.locales[number]; // 'en' | 'ar'
+ * ```
+ */
+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
+ * ```ts
+ * export const labels = defineLabels({
+ *     home: {
+ *         slogan: { en: "Welcome", ko: "환영합니다" },
+ *         hero: {
+ *             title: { en: "Hello", ko: "안녕하세요" }
+ *         }
+ *     },
+ *     about: {
+ *         title: { en: "About Us", ko: "회사 소개" }
+ *     }
+ * });
+ *
+ * // Usage
+ * labels.home.slogan;
+ * labels.home.hero.title;
+ * labels.about.title;
+ * ```
+ */
+declare function defineLabels<const T>(labels: T): T;
+declare function format(template: string, vars: Record<string, string | number>): string;
+
+/**
+ * Create CMS client with API, label getters, and format utility
+ *
+ * @param labelsDefinition - Labels defined using defineLabels()
+ * @param config - Label config from defineLabelConfig()
+ * @returns API client, getLabel (single), getLabels (multiple), and format utility
+ *
+ * @example
+ * ```typescript
+ * // labels.ts - Setup once
+ * export const { api, getLabel, getLabels, format } = createCmsClient(labelsDefinition, labelConfig);
+ *
+ * // 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 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 BoundLabelSection, type BoundLabels, type BoundLabelsSections, type SectionKeys, createCmsClient, defineLabelConfig, defineLabels, format };