@spfn/cms 0.1.0-alpha.8 → 0.1.0-alpha.80

package/dist/{routes/labels/[id] → server/routes/labels/_id_}/index.d.ts

@@ -1,3 +1,5 @@
+import * as _spfn_core_route from '@spfn/core/route';
+
 /**
  * CMS Label Detail Routes
  *
@@ -5,6 +7,6 @@
  * - PATCH /cms/labels/:id - 라벨 메타데이터 수정
  * - DELETE /cms/labels/:id - 라벨 삭제
  */
-declare const app: import("@spfn/core/route").SPFNApp;
-export default app;
-//# sourceMappingURL=index.d.ts.map
+declare const app: _spfn_core_route.SPFNApp;
+
+export { app as default };

package/dist/server/routes/labels/_id_/publish/index.d.ts

@@ -0,0 +1,11 @@
+import * as _spfn_core_route from '@spfn/core/route';
+
+/**
+ * CMS Label Publish Route
+ *
+ * 라벨 발행 API (Draft → Published)
+ * - POST /labels/:id/publish - Draft를 Published로 발행 (final: /_cms/labels/:id/publish)
+ */
+declare const app: _spfn_core_route.SPFNApp;
+
+export { app as default };

package/dist/server/routes/labels/_id_/versions/index.d.ts

@@ -0,0 +1,11 @@
+import * as _spfn_core_route from '@spfn/core/route';
+
+/**
+ * CMS Label Versions Route
+ *
+ * 라벨 버전 히스토리 조회 API
+ * - GET /labels/:id/versions - 모든 버전 히스토리 조회 (final: /_cms/labels/:id/versions)
+ */
+declare const app: _spfn_core_route.SPFNApp;
+
+export { app as default };

package/dist/server/routes/labels/by-key/[key]/index.js

@@ -0,0 +1,525 @@
+// src/server/routes/labels/by-key/[key]/index.ts
+import { createApp } from "@spfn/core/route";
+
+// src/server/repositories/cms-labels.repository.ts
+import { findOne, findMany as findManyHelper, create as createHelper, updateOne, deleteOne, count as countHelper } from "@spfn/core/db";
+import { asc } from "drizzle-orm";
+
+// src/server/entities/cms-labels.ts
+import { index, integer, serial, text, timestamp } from "drizzle-orm/pg-core";
+import { createFunctionSchema } from "@spfn/core/db";
+var schema = createFunctionSchema("@spfn/cms");
+var cmsLabels = schema.table("labels", {
+  // Primary Key
+  id: serial("id").primaryKey(),
+  // 라벨 식별자
+  key: text("key").notNull().unique(),
+  // 예: "home.hero.title", "why-futureplay.hero.subtitle"
+  // 구조: {section}.{component}.{property}
+  // 섹션 분류 (페이지 단위)
+  section: text("section").notNull(),
+  // 예: "home", "why-futureplay", "team"
+  // 값 타입
+  type: text("type").notNull(),
+  // "text" | "image" | "video" | "file" | "object"
+  // 기본값
+  defaultValue: text("default_value"),
+  // 라벨의 기본값 (sync 시 설정)
+  // 설명
+  description: text("description"),
+  // 라벨에 대한 설명 (optional)
+  // 현재 발행된 버전 번호
+  publishedVersion: integer("published_version"),
+  // null = 미발행 상태
+  // 1, 2, 3... = 발행된 버전 번호
+  // 생성자 추적
+  createdBy: text("created_by"),
+  // 타임스탬프
+  createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
+  updatedAt: timestamp("updated_at", { withTimezone: true }).notNull().defaultNow()
+}, (table) => [
+  // 인덱스: 섹션별 조회 최적화
+  index("cms_labels_section_idx").on(table.section),
+  // 인덱스: key로 조회 최적화 (unique 제약으로 자동 생성되지만 명시)
+  index("cms_labels_key_idx").on(table.key)
+]);
+
+// src/server/entities/cms-label-values.ts
+import { serial as serial2, integer as integer2, text as text2, jsonb, timestamp as timestamp2, index as index2, unique } from "drizzle-orm/pg-core";
+import { createFunctionSchema as createFunctionSchema2 } from "@spfn/core/db";
+var schema2 = createFunctionSchema2("@spfn/cms");
+var cmsLabelValues = schema2.table("label_values", {
+  // Primary Key
+  id: serial2("id").primaryKey(),
+  // Foreign Key: cms_labels
+  labelId: integer2("label_id").notNull().references(() => cmsLabels.id, { onDelete: "cascade" }),
+  // 버전 번호 (null = draft, number = published version)
+  version: integer2("version"),
+  // 언어 코드
+  locale: text2("locale").notNull().default("ko"),
+  // "ko" | "en" | "ja"
+  // 반응형 브레이크포인트
+  breakpoint: text2("breakpoint"),
+  // null = 기본값 (모든 화면 크기)
+  // "sm" | "md" | "lg" | "xl" | "2xl"
+  // 실제 값 (JSONB)
+  value: jsonb("value").notNull(),
+  // LabelValue 타입:
+  // - TextValue: { type: "text", content: string }
+  // - ImageValue: { type: "image", url: string, alt?: string, width?: number, height?: number }
+  // - VideoValue: { type: "video", url: string, thumbnail?: string, duration?: number }
+  // - FileValue: { type: "file", url: string, filename: string, size?: number }
+  // - ObjectValue: { type: "object", fields: Record<string, LabelValue> }
+  // 생성 시각
+  createdAt: timestamp2("created_at", { withTimezone: true }).notNull().defaultNow()
+}, (table) => [
+  // UNIQUE 제약: 같은 버전에서 locale + breakpoint 조합은 유일
+  unique("cms_label_values_locale_breakpoint_unique").on(table.labelId, table.version, table.locale, table.breakpoint),
+  // 인덱스: labelId + version 복합 조회 최적화
+  index2("cms_label_values_label_version_idx").on(table.labelId, table.version),
+  // 인덱스: locale 필터링 최적화
+  index2("cms_label_values_locale_idx").on(table.locale)
+]);
+
+// src/server/entities/cms-draft-cache.ts
+import { serial as serial3, text as text3, jsonb as jsonb2, timestamp as timestamp3, index as index3, unique as unique2 } from "drizzle-orm/pg-core";
+import { createFunctionSchema as createFunctionSchema3 } from "@spfn/core/db";
+var schema3 = createFunctionSchema3("@spfn/cms");
+var cmsDraftCache = schema3.table("draft_cache", {
+  // Primary Key
+  id: serial3("id").primaryKey(),
+  // 섹션 (페이지 단위)
+  section: text3("section").notNull(),
+  // "home" | "why-futureplay" | "team" | "our-companies" | "apply"
+  // 언어
+  locale: text3("locale").notNull(),
+  // "ko" | "en" | "ja"
+  // 사용자 ID (핵심 필드!)
+  userId: text3("user_id").notNull(),
+  // 각 관리자의 독립적인 작업 공간
+  // Draft 콘텐츠 (JSONB)
+  content: jsonb2("content").notNull(),
+  // Record<string, LabelValue>
+  // {
+  //   "home.hero.title": { type: "text", content: "수정 중..." },
+  //   "home.hero.subtitle": { type: "text", content: "새로운 문구" },
+  //   ...
+  // }
+  // 최종 수정 시각
+  updatedAt: timestamp3("updated_at", { withTimezone: true }).notNull().defaultNow()
+}, (table) => [
+  // UNIQUE 제약: section + locale + userId 조합은 유일
+  unique2("cms_draft_cache_unique").on(table.section, table.locale, table.userId),
+  // 인덱스: section으로 조회 최적화
+  index3("cms_draft_cache_section_idx").on(table.section),
+  // 인덱스: userId로 사용자의 모든 draft 조회 최적화
+  index3("cms_draft_cache_user_idx").on(table.userId)
+]);
+
+// src/server/entities/cms-published-cache.ts
+import { serial as serial4, text as text4, jsonb as jsonb3, integer as integer3, timestamp as timestamp4, index as index4, unique as unique3 } from "drizzle-orm/pg-core";
+import { createFunctionSchema as createFunctionSchema4 } from "@spfn/core/db";
+var schema4 = createFunctionSchema4("@spfn/cms");
+var cmsPublishedCache = schema4.table("published_cache", {
+  // Primary Key
+  id: serial4("id").primaryKey(),
+  // 섹션 (페이지 단위)
+  section: text4("section").notNull(),
+  // "home" | "why-futureplay" | "team" | "our-companies" | "apply"
+  // 언어
+  locale: text4("locale").notNull(),
+  // "ko" | "en" | "ja"
+  // 캐시된 콘텐츠 (JSONB)
+  content: jsonb3("content").notNull(),
+  // Record<string, LabelValue>
+  // {
+  //   "home.hero.title": { type: "text", content: "..." },
+  //   "home.hero.image": { type: "image", url: "...", alt: "..." },
+  //   ...
+  // }
+  // 발행 정보
+  publishedAt: timestamp4("published_at", { withTimezone: true }).notNull(),
+  publishedBy: text4("published_by"),
+  // 캐시 버전 (클라이언트 캐싱용)
+  version: integer3("version").notNull().default(1)
+}, (table) => [
+  // UNIQUE 제약: section + locale 조합은 유일
+  unique3("cms_published_cache_unique").on(table.section, table.locale),
+  // 인덱스: section으로 조회 최적화
+  index4("cms_published_cache_section_idx").on(table.section)
+]);
+
+// src/server/entities/cms-audit-logs.ts
+import { serial as serial5, integer as integer4, text as text5, jsonb as jsonb4, timestamp as timestamp5, index as index5 } from "drizzle-orm/pg-core";
+import { createFunctionSchema as createFunctionSchema5 } from "@spfn/core/db";
+var schema5 = createFunctionSchema5("@spfn/cms");
+var cmsAuditLogs = schema5.table("audit_logs", {
+  // Primary Key
+  id: serial5("id").primaryKey(),
+  // Foreign Key: cms_labels (nullable - 라벨 삭제 시 로그는 유지)
+  labelId: integer4("label_id").references(() => cmsLabels.id, { onDelete: "set null" }),
+  // 작업 유형
+  action: text5("action").notNull(),
+  // "create" | "update" | "publish" | "unpublish" | "archive" | "delete" | "rollback" | "duplicate"
+  // 사용자 정보
+  userId: text5("user_id").notNull(),
+  userName: text5("user_name"),
+  // 변경 내용 (before/after)
+  changes: jsonb4("changes"),
+  // { before: {...}, after: {...} }
+  // 추가 메타데이터
+  metadata: jsonb4("metadata"),
+  // { version: number, ip: string, userAgent: string, ... }
+  // 작업 시각
+  createdAt: timestamp5("created_at", { withTimezone: true }).notNull().defaultNow()
+}, (table) => [
+  // 인덱스: labelId로 이력 조회 최적화
+  index5("cms_audit_logs_label_id_idx").on(table.labelId),
+  // 인덱스: userId로 사용자 활동 조회 최적화
+  index5("cms_audit_logs_user_id_idx").on(table.userId),
+  // 인덱스: action 필터링 최적화
+  index5("cms_audit_logs_action_idx").on(table.action),
+  // 인덱스: 시간순 조회 최적화
+  index5("cms_audit_logs_created_at_idx").on(table.createdAt)
+]);
+
+// src/server/repositories/cms-labels.repository.ts
+async function findMany(options) {
+  const { section } = options || {};
+  return findManyHelper(cmsLabels, {
+    where: section ? { section } : void 0,
+    orderBy: asc(cmsLabels.key)
+    // key 오름차순 정렬 (JSON 파일의 순서 유지)
+  });
+}
+async function count(section) {
+  return countHelper(cmsLabels, section ? { section } : void 0);
+}
+async function findById(id) {
+  return findOne(cmsLabels, { id });
+}
+async function findByKey(key) {
+  return findOne(cmsLabels, { key });
+}
+async function findBySection(section) {
+  return findManyHelper(cmsLabels, {
+    where: { section },
+    orderBy: asc(cmsLabels.key)
+    // key 오름차순 정렬 (JSON 파일의 순서 유지)
+  });
+}
+async function create(data) {
+  return createHelper(cmsLabels, data);
+}
+async function updateById(id, data) {
+  return updateOne(cmsLabels, { id }, { ...data, updatedAt: /* @__PURE__ */ new Date() });
+}
+async function deleteById(id) {
+  return deleteOne(cmsLabels, { id });
+}
+var cmsLabelsRepository = {
+  findMany,
+  count,
+  findById,
+  findByKey,
+  findBySection,
+  create,
+  updateById,
+  deleteById
+};
+
+// src/server/repositories/cms-label-values.repository.ts
+import { findOne as findOne2, findMany as findMany2, create as create2, updateOne as updateOne2, deleteMany } from "@spfn/core/db";
+import { eq, and, isNull } from "drizzle-orm";
+
+// src/server/repositories/cms-draft-cache.repository.ts
+import { findOne as findOne3, findMany as findMany3, deleteOne as deleteOne2, deleteMany as deleteMany2, upsert as upsertHelper } from "@spfn/core/db";
+import { eq as eq2, and as and2, lt } from "drizzle-orm";
+
+// src/server/repositories/cms-published-cache.repository.ts
+import { findOne as findOne4, findMany as findMany4, deleteOne as deleteOne3, deleteMany as deleteMany3, upsert as upsertHelper2 } from "@spfn/core/db";
+import { eq as eq3, and as and3, sql } from "drizzle-orm";
+
+// src/lib/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)" })),
+    includeDefaultValues: Type.Optional(Type.Boolean({ description: "\uAE30\uBCF8\uAC12 \uD3EC\uD568 \uC5EC\uBD80" }))
+  }),
+  response: Type.Object({
+    labels: Type.Array(Type.Object({
+      id: Type.Number(),
+      key: Type.String(),
+      section: Type.String(),
+      type: Type.String(),
+      description: Type.Union([Type.String(), Type.Null()], { description: "\uB77C\uBCA8 \uC124\uBA85" }),
+      publishedVersion: Type.Union([Type.Number(), Type.Null()]),
+      createdBy: Type.Union([Type.String(), Type.Null()]),
+      createdAt: Type.String(),
+      updatedAt: Type.String(),
+      defaultValue: Type.Optional(Type.Any({ description: "\uB77C\uBCA8 \uC815\uC758 \uD30C\uC77C\uC758 \uAE30\uBCF8\uAC12" }))
+    })),
+    total: 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(),
+      description: Type.Union([Type.String(), Type.Null()]),
+      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(),
+      description: Type.Union([Type.String(), Type.Null()]),
+      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(),
+      description: Type.Union([Type.String(), Type.Null()]),
+      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 publishLabelContract = {
+  method: "POST",
+  path: "/_cms/labels/:id/publish",
+  params: Type.Object({
+    id: Type.String({ description: "\uB77C\uBCA8 ID" })
+  }),
+  body: Type.Object({
+    notes: Type.Optional(Type.String({ description: "\uBC1C\uD589 \uB178\uD2B8 (\uBC84\uC804 \uC124\uBA85)" })),
+    publishedBy: Type.Optional(Type.String({ description: "\uBC1C\uD589\uC790 ID" }))
+  }),
+  response: Type.Union([
+    Type.Object({
+      success: Type.Boolean(),
+      id: Type.Number(),
+      version: Type.Number(),
+      message: Type.String()
+    }),
+    Type.Object({
+      error: Type.String()
+    })
+  ])
+};
+var getAdminLabelContract = {
+  method: "GET",
+  path: "/_cms/labels/:id/admin",
+  params: Type.Object({
+    id: Type.String({ description: "\uB77C\uBCA8 ID" })
+  }),
+  response: Type.Union([
+    Type.Object({
+      label: Type.Object({
+        id: Type.Number(),
+        key: Type.String(),
+        section: Type.String(),
+        type: Type.String(),
+        description: Type.Union([Type.String(), Type.Null()]),
+        publishedVersion: Type.Union([Type.Number(), Type.Null()]),
+        createdBy: Type.Union([Type.String(), Type.Null()]),
+        createdAt: Type.String(),
+        updatedAt: Type.String()
+      }),
+      draft: Type.Array(Type.Object({
+        id: Type.Number(),
+        labelId: Type.Number(),
+        version: Type.Null(),
+        locale: Type.String(),
+        breakpoint: Type.Union([Type.String(), Type.Null()]),
+        value: Type.Any(),
+        createdAt: Type.String()
+      })),
+      published: Type.Array(Type.Object({
+        id: Type.Number(),
+        labelId: Type.Number(),
+        version: Type.Number(),
+        locale: Type.String(),
+        breakpoint: Type.Union([Type.String(), Type.Null()]),
+        value: Type.Any(),
+        createdAt: Type.String()
+      })),
+      status: Type.Union([
+        Type.Literal("default-only"),
+        Type.Literal("unpublished"),
+        Type.Literal("published"),
+        Type.Literal("modified")
+      ])
+    }),
+    Type.Object({
+      error: Type.String()
+    })
+  ])
+};
+var getLabelVersionsContract = {
+  method: "GET",
+  path: "/_cms/labels/:id/versions",
+  params: Type.Object({
+    id: Type.String({ description: "\uB77C\uBCA8 ID" })
+  }),
+  response: Type.Union([
+    Type.Object({
+      versions: Type.Array(Type.Object({
+        version: Type.Number({ description: "\uBC84\uC804 \uBC88\uD638" }),
+        publishedAt: Type.String({ description: "\uBC1C\uD589 \uC2DC\uAC01 (ISO 8601)" }),
+        publishedBy: Type.Union([Type.String(), Type.Null()], { description: "\uBC1C\uD589\uC790 ID" }),
+        notes: Type.Union([Type.String(), Type.Null()], { description: "\uBC1C\uD589 \uB178\uD2B8" }),
+        values: Type.Array(Type.Object({
+          id: Type.Number(),
+          locale: Type.String(),
+          breakpoint: Type.Union([Type.String(), Type.Null()]),
+          value: Type.Any(),
+          createdAt: Type.String()
+        }))
+      }))
+    }),
+    Type.Object({
+      error: Type.String()
+    })
+  ])
+};
+
+// src/server/routes/labels/by-key/[key]/index.ts
+var app = createApp();
+app.bind(getLabelByKeyContract, async (c) => {
+  const { key } = c.params;
+  const label = await cmsLabelsRepository.findByKey(key);
+  if (!label) {
+    return c.json({ error: "Label not found", key }, 404);
+  }
+  return c.json({
+    id: label.id,
+    key: label.key,
+    section: label.section,
+    type: label.type,
+    description: label.description,
+    publishedVersion: label.publishedVersion,
+    createdBy: label.createdBy,
+    createdAt: label.createdAt.toISOString(),
+    updatedAt: label.updatedAt.toISOString()
+  });
+});
+var key_default = app;
+export {
+  key_default as default
+};
+//# sourceMappingURL=index.js.map