@roottale/cms-mcp 0.61.1 → 0.63.0

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # @roottale/cms-mcp
 
+## 0.63.0
+
+### Patch Changes
+
+- a858d8e: 목차 배치를 사이트 코드의 `RootTaleBlogPost.tocPosition`으로 관리할 수 있습니다.
+  명시한 값은 CMS 설정보다 우선하며, 생략한 기존 연동은 CMS 배치를 유지합니다.
+  현재 배치를 prop으로 명시하면 실제 화면을 바꾸지 않고 관리 주체를 코드로 옮깁니다.
+
+  공통 블록 디자인은 `RootTaleBlogPost.footerPatternPresentation`과
+  `RootTalePostPattern.presentation`으로 전체 대체할 수 있습니다. `null`은 원격
+  디자인 주입을 생략하고 사이트 CSS에 맡기며, 생략한 기존 연동은 원격값을 유지합니다.
+  고객 콘텐츠와 제작 디자인을 분리하는 문서·발행/미리보기 예제를 함께 갱신합니다.
+
+  공개 `RootTaleCssVars` 타입의 비공개 UI 패키지 참조도 제거해 독립 소비자의
+  strict 타입 검사를 지원합니다.
+
+  섹션 구성·디자인 변경 검사 함수를 공개 CMS core에서 공유해 편집기와 저장 단계가
+  같은 고객 편집 경계를 적용합니다.
+
+## 0.62.0
+
+### Minor Changes
+
+- 083fc47: 팝업·배너의 예약 시작과 종료를 사이트 재배포 없이 반영하는 공통 runtime과 Next.js 조회 경로를 제공합니다. 공개본과 수정안을 분리하고 일정 변경·일시 중지·예약 취소를 관리 API, MCP, CLI에서 지원합니다. 신규 고객 스타터와 기존 사이트에서 같은 표시 계약을 사용합니다. 메인 홈 전용 자동 캐러셀, 다음 슬라이드까지의 진행률, 모바일 스와이프·스크롤 반응과 쿠키 숨김을 지원합니다.
+
 ## 0.61.1
 
 ## 0.61.0

package/dist/index.js

@@ -483,6 +483,25 @@ var strings = (description) => ({
   items: { type: "string" },
   description
 });
+var exposureFields = {
+  siteId: string("\uC0AC\uC774\uD2B8 ID"),
+  name: string("\uAD00\uB9AC\uC6A9 \uC774\uB984"),
+  slotKey: string("\uB178\uCD9C \uC2AC\uB86F key"),
+  kind: enumValue(["banner", "popup"]),
+  content: object("camelCase \uCF58\uD150\uCE20; assetId/mobileAssetId, linkTarget self|blank"),
+  delivery: object("v2 \uD45C\uC2DC \uC870\uAC74; timeZone, includePaths, excludePaths, schedule"),
+  startsAt: nullableString("\uC2DC\uC791 ISO \uC2DC\uAC01"),
+  endsAt: nullableString("\uC885\uB8CC ISO \uC2DC\uAC01"),
+  targetPaths: strings("\uC774\uC804 runtime \uB300\uC0C1 \uACBD\uB85C"),
+  priority: number("\uC6B0\uC120\uC21C\uC704"),
+  repeat: enumValue(["always", "session", "day", "never"])
+};
+var exposureRequired = ["slotKey", "kind", "content", "startsAt", "endsAt", "targetPaths", "priority", "repeat"];
+var exposureVersionFields = {
+  exposureId: string("\uB178\uCD9C \uCEA0\uD398\uC778 ID"),
+  siteId: string("\uC0AC\uC774\uD2B8 ID"),
+  expectedVersion: number("\uC870\uD68C\uD55C \uD604\uC7AC version")
+};
 var MANAGEMENT_TOOL_DEFINITIONS = [
   tool2("listCmsContentModels", "\uD398\uC774\uC9C0\xB7\uAE00\xB7\uC815\uBCF4 \uCF58\uD150\uCE20 \uBAA8\uB378\uACFC \uC0AC\uC6A9\uB7C9\uC744 \uC870\uD68C\uD569\uB2C8\uB2E4.", {
     siteId: string("\uC0AC\uC774\uD2B8 ID"),
@@ -583,6 +602,8 @@ var MANAGEMENT_TOOL_DEFINITIONS = [
     siteId: string("\uC0AC\uC774\uD2B8 ID")
   }, ["exposureId"]),
   tool2("createCmsExposure", "FRONT \uC2AC\uB86F \uACC4\uC57D\uC5D0 \uB9DE\uB294 \uB178\uCD9C \uCEA0\uD398\uC778 \uCD08\uC548\uC744 \uB9CC\uB4ED\uB2C8\uB2E4.", {
+    name: exposureFields.name,
+    delivery: exposureFields.delivery,
     siteId: string("\uC0AC\uC774\uD2B8 ID"),
     slotKey: string("\uB178\uCD9C \uC2AC\uB86F key"),
     kind: enumValue(["banner", "popup"]),
@@ -594,6 +615,8 @@ var MANAGEMENT_TOOL_DEFINITIONS = [
     repeat: enumValue(["always", "session", "day", "never"])
   }, ["slotKey", "kind", "content", "startsAt", "endsAt", "targetPaths", "priority", "repeat"]),
   tool2("updateCmsExposure", "\uB178\uCD9C \uCEA0\uD398\uC778\uC744 \uB099\uAD00\uC801 \uC7A0\uAE08\uC73C\uB85C \uC218\uC815\uD569\uB2C8\uB2E4.", {
+    name: exposureFields.name,
+    delivery: exposureFields.delivery,
     exposureId: string("\uB178\uCD9C \uCEA0\uD398\uC778 ID"),
     expectedVersion: number("\uD604\uC7AC version"),
     siteId: string("\uC0AC\uC774\uD2B8 ID"),
@@ -607,13 +630,37 @@ var MANAGEMENT_TOOL_DEFINITIONS = [
     repeat: enumValue(["always", "session", "day", "never"])
   }, ["exposureId", "expectedVersion", "slotKey", "kind", "content", "startsAt", "endsAt", "targetPaths", "priority", "repeat"]),
   tool2("publishCmsExposure", "\uB178\uCD9C \uCEA0\uD398\uC778\uC744 \uBC1C\uD589\uD558\uACE0 \uACB9\uCE68 \uACBD\uACE0\uB97C \uBC18\uD658\uD569\uB2C8\uB2E4.", {
+    expectedVersion: exposureVersionFields.expectedVersion,
     exposureId: string("\uB178\uCD9C \uCEA0\uD398\uC778 ID"),
     siteId: string("\uC0AC\uC774\uD2B8 ID")
   }, ["exposureId"]),
   tool2("archiveCmsExposure", "\uB178\uCD9C \uCEA0\uD398\uC778\uC744 \uBCF4\uAD00\uD569\uB2C8\uB2E4.", {
+    expectedVersion: exposureVersionFields.expectedVersion,
     exposureId: string("\uB178\uCD9C \uCEA0\uD398\uC778 ID"),
     siteId: string("\uC0AC\uC774\uD2B8 ID")
-  }, ["exposureId"])
+  }, ["exposureId"]),
+  tool2("saveCmsExposureDraft", "\uACF5\uAC1C\uBCF8\uC744 \uC720\uC9C0\uD558\uBA70 \uC218\uC815\uC548\uC744 \uC800\uC7A5\uD569\uB2C8\uB2E4.", {
+    ...exposureFields,
+    ...exposureVersionFields
+  }, ["exposureId", "expectedVersion", ...exposureRequired]),
+  tool2("updateCmsExposureSchedule", "\uB0B4\uC6A9 \uC218\uC815\uC548\uC744 \uBC1C\uD589\uD558\uC9C0 \uC54A\uACE0 \uACF5\uAC1C\uBCF8\uC758 \uC77C\uC815\uB9CC \uBC14\uAFC9\uB2C8\uB2E4.", {
+    ...exposureVersionFields,
+    startsAt: nullableString("\uC2DC\uC791 ISO \uC2DC\uAC01"),
+    endsAt: nullableString("\uC885\uB8CC ISO \uC2DC\uAC01"),
+    schedule: object("camelCase \uAE30\uAC04 \uD3B8\uC9D1 \uC815\uBCF4")
+  }, ["exposureId", "expectedVersion", "startsAt", "endsAt"]),
+  tool2("pauseCmsExposure", "\uD604\uC7AC \uB178\uCD9C\uC744 \uC77C\uC2DC \uC911\uC9C0\uD569\uB2C8\uB2E4.", exposureVersionFields, ["exposureId", "expectedVersion"]),
+  tool2("resumeCmsExposure", "\uC720\uD6A8\uD55C \uAE30\uAC04\uC758 \uC77C\uC2DC \uC911\uC9C0 \uD56D\uBAA9\uC744 \uC7AC\uAC1C\uD569\uB2C8\uB2E4.", exposureVersionFields, ["exposureId", "expectedVersion"]),
+  tool2("cancelCmsExposureReservation", "\uC2DC\uC791 \uC804 \uC608\uC57D\uC744 \uCDE8\uC18C\uD558\uACE0 \uCD08\uC548\uC73C\uB85C \uB418\uB3CC\uB9BD\uB2C8\uB2E4.", exposureVersionFields, ["exposureId", "expectedVersion"]),
+  tool2("duplicateCmsExposure", "\uC0C8 ID\uC640 \uBE44\uC5B4 \uC788\uB294 \uC77C\uC815\uC73C\uB85C \uCD08\uC548\uC744 \uBCF5\uC81C\uD569\uB2C8\uB2E4.", exposureVersionFields, ["exposureId", "expectedVersion"]),
+  tool2("restoreCmsExposure", "\uBCF4\uAD00\uD55C \uD56D\uBAA9\uC744 \uCD08\uC548\uC73C\uB85C \uBCF5\uC6D0\uD569\uB2C8\uB2E4.", exposureVersionFields, ["exposureId", "expectedVersion"]),
+  tool2("previewCmsExposure", "\uC800\uC7A5\uD558\uC9C0 \uC54A\uACE0 \uACBD\uB85C\xB7\uAE30\uAE30\xB7\uC2DC\uAC01\uC5D0 \uB9DE\uB294 \uB178\uCD9C \uACB0\uACFC\uB97C \uD655\uC778\uD569\uB2C8\uB2E4.", {
+    exposureId: string("\uC218\uC815 \uC911\uC778 \uAE30\uC874 \uD56D\uBAA9 ID; \uC0DD\uB7B5\uD558\uBA74 \uC0C8 \uD56D\uBAA9\uC73C\uB85C \uD655\uC778"),
+    ...exposureFields,
+    path: string("\uBBF8\uB9AC \uBCFC \uC0AC\uC774\uD2B8 \uACBD\uB85C"),
+    device: enumValue(["desktop", "mobile"]),
+    evaluatedAt: string("\uD655\uC778\uD560 ISO \uC2DC\uAC01; \uC0DD\uB7B5 \uC2DC \uD604\uC7AC")
+  }, [...exposureRequired, "path", "device"])
 ];
 function isManagementToolName(name) {
   return MANAGEMENT_TOOL_DEFINITIONS.some((definition) => definition.name === name);
@@ -689,7 +736,42 @@ var ListExposuresInput = SiteInput.extend({
   status: z3.enum(["draft", "published", "archived"]).optional()
 }).strict();
 var ExposureRefInput = z3.object({ exposureId: Key, siteId: SiteId2 }).strict();
+var ExposureStateInput = ExposureRefInput.extend({
+  expectedVersion: z3.number().int().positive().optional()
+}).strict();
+var ExposureMutationInput = ExposureStateInput.required({ expectedVersion: true });
+var ScheduleInput = z3.object({
+  startMode: z3.enum(["now", "scheduled"]),
+  startDate: z3.string().optional(),
+  startTime: z3.string().optional(),
+  endMode: z3.enum(["none", "date"]),
+  endDate: z3.string().optional(),
+  endTime: z3.string().optional(),
+  endPreset: z3.union([z3.literal(1), z3.literal(7), z3.literal(30)]).optional()
+}).strict();
+var PathRuleInput = z3.object({ path: z3.string().startsWith("/"), match: z3.enum(["exact", "prefix"]) }).strict();
+var DeliveryInput = z3.object({
+  version: z3.literal(2),
+  timeZone: z3.string().optional(),
+  device: z3.enum(["all", "desktop", "mobile"]).optional(),
+  includePaths: z3.array(PathRuleInput).min(1).max(100),
+  excludePaths: z3.array(PathRuleInput).max(100).optional(),
+  delaySeconds: z3.number().min(0).max(30).optional(),
+  scrollPercent: z3.union([z3.literal(25), z3.literal(50), z3.literal(75)]).nullable().optional(),
+  dismissible: z3.boolean().optional(),
+  hideForToday: z3.boolean().optional(),
+  size: z3.enum(["small", "medium", "large"]).optional(),
+  dayBoundary: z3.enum(["calendar", "rolling"]).optional(),
+  schedule: ScheduleInput.optional()
+}).strict();
+var ExposureScheduleInput = ExposureMutationInput.extend({
+  startsAt: DateTime.nullable(),
+  endsAt: DateTime.nullable(),
+  schedule: ScheduleInput.optional()
+}).strict();
 var ExposureFields = {
+  name: z3.string().max(200).optional(),
+  delivery: DeliveryInput.optional(),
   slotKey: Key,
   kind: z3.enum(["banner", "popup"]),
   content: z3.object({
@@ -699,8 +781,13 @@ var ExposureFields = {
     description: z3.string().optional(),
     assetUrl: z3.string().url().optional(),
     assetAlt: z3.string().optional(),
+    assetId: Key.optional(),
+    mobileAssetId: Key.optional(),
+    mobileAssetUrl: z3.string().url().optional(),
+    mobileAssetAlt: z3.string().optional(),
     linkLabel: z3.string().optional(),
-    linkUrl: z3.string().optional()
+    linkUrl: z3.string().optional(),
+    linkTarget: z3.enum(["self", "blank"]).optional()
   }).strict(),
   startsAt: DateTime.nullable(),
   endsAt: DateTime.nullable(),
@@ -715,6 +802,12 @@ var UpdateExposureInput = z3.object({
   siteId: SiteId2,
   ...ExposureFields
 }).strict();
+var PreviewExposureInput = CreateExposureInput.extend({
+  exposureId: Key.optional(),
+  path: z3.string().startsWith("/"),
+  device: z3.enum(["desktop", "mobile"]),
+  evaluatedAt: DateTime.optional()
+}).strict();
 var VersionResponse = z3.object({ version: z3.number().int().positive() }).passthrough();
 var UpdatedAtResponse = z3.object({ updated_at: DateTime.nullable() }).passthrough();
 
@@ -888,11 +981,12 @@ async function callManagementTool(name, args) {
         body: exposureBody(input)
       });
     }
-    case "updateCmsExposure": {
+    case "updateCmsExposure":
+    case "saveCmsExposureDraft": {
       const input = UpdateExposureInput.parse(args);
       return requestRootTaleApi({
-        method: "PATCH",
-        pathname: exposurePath(input.exposureId),
+        method: name === "saveCmsExposureDraft" ? "POST" : "PATCH",
+        pathname: `${exposurePath(input.exposureId)}${name === "saveCmsExposureDraft" ? "/draft" : ""}`,
         body: {
           ...exposureBody(input),
           expected_version: input.expectedVersion
@@ -900,16 +994,51 @@ async function callManagementTool(name, args) {
       });
     }
     case "publishCmsExposure":
-    case "archiveCmsExposure": {
-      const input = ExposureRefInput.parse(args);
-      const current = VersionResponse.parse(
+    case "archiveCmsExposure":
+    case "pauseCmsExposure":
+    case "resumeCmsExposure":
+    case "cancelCmsExposureReservation":
+    case "duplicateCmsExposure":
+    case "restoreCmsExposure": {
+      const input = (name === "publishCmsExposure" || name === "archiveCmsExposure" ? ExposureStateInput : ExposureMutationInput).parse(args);
+      const expectedVersion = input.expectedVersion ?? VersionResponse.parse(
         await get(exposurePath(input.exposureId), { site_id: input.siteId })
-      );
-      const action = name === "publishCmsExposure" ? "publish" : "archive";
+      ).version;
+      const actions = {
+        publishCmsExposure: "publish",
+        archiveCmsExposure: "archive",
+        pauseCmsExposure: "pause",
+        resumeCmsExposure: "resume",
+        cancelCmsExposureReservation: "cancel",
+        duplicateCmsExposure: "duplicate",
+        restoreCmsExposure: "restore"
+      };
       return requestRootTaleApi({
         method: "POST",
-        pathname: `${exposurePath(input.exposureId)}/${action}`,
-        body: { site_id: input.siteId, expected_version: current.version }
+        pathname: `${exposurePath(input.exposureId)}/${actions[name]}`,
+        body: { site_id: input.siteId, expected_version: expectedVersion }
+      });
+    }
+    case "updateCmsExposureSchedule": {
+      const input = ExposureScheduleInput.parse(args);
+      return requestRootTaleApi({
+        method: "POST",
+        pathname: `${exposurePath(input.exposureId)}/schedule`,
+        body: {
+          site_id: input.siteId,
+          expected_version: input.expectedVersion,
+          starts_at: input.startsAt,
+          ends_at: input.endsAt,
+          schedule: scheduleBody(input.schedule)
+        }
+      });
+    }
+    case "previewCmsExposure": {
+      const input = PreviewExposureInput.parse(args);
+      return requestRootTaleApi({
+        method: "POST",
+        pathname: "/v1/cms/exposures/preview",
+        body: { ...exposureBody(input), exposure_id: input.exposureId, path: input.path, device: input.device, evaluated_at: input.evaluatedAt }
       });
     }
     default:
@@ -944,6 +1073,21 @@ function modelBody(input) {
 function exposureBody(input) {
   return {
     site_id: input.siteId,
+    name: input.name,
+    delivery: input.delivery ? {
+      version: input.delivery.version,
+      time_zone: input.delivery.timeZone,
+      device: input.delivery.device,
+      include_paths: input.delivery.includePaths,
+      exclude_paths: input.delivery.excludePaths,
+      delay_seconds: input.delivery.delaySeconds,
+      scroll_percent: input.delivery.scrollPercent,
+      dismissible: input.delivery.dismissible,
+      hide_for_today: input.delivery.hideForToday,
+      size: input.delivery.size,
+      day_boundary: input.delivery.dayBoundary,
+      schedule: scheduleBody(input.delivery.schedule)
+    } : void 0,
     slot_key: input.slotKey,
     kind: input.kind,
     content: {
@@ -953,8 +1097,13 @@ function exposureBody(input) {
       description: input.content.description,
       asset_url: input.content.assetUrl,
       asset_alt: input.content.assetAlt,
+      asset_id: input.content.assetId,
+      mobile_asset_id: input.content.mobileAssetId,
+      mobile_asset_url: input.content.mobileAssetUrl,
+      mobile_asset_alt: input.content.mobileAssetAlt,
       link_label: input.content.linkLabel,
-      link_url: input.content.linkUrl
+      link_url: input.content.linkUrl,
+      link_target: input.content.linkTarget
     },
     starts_at: input.startsAt,
     ends_at: input.endsAt,
@@ -963,6 +1112,17 @@ function exposureBody(input) {
     repeat: input.repeat
   };
 }
+function scheduleBody(schedule) {
+  return schedule ? {
+    start_mode: schedule.startMode,
+    start_date: schedule.startDate,
+    start_time: schedule.startTime,
+    end_mode: schedule.endMode,
+    end_date: schedule.endDate,
+    end_time: schedule.endTime,
+    end_preset: schedule.endPreset
+  } : void 0;
+}
 function optionalQuery2(values) {
   return Object.fromEntries(
     Object.entries(values).filter((entry) => entry[1] !== void 0)
@@ -1070,9 +1230,25 @@ function registerManagementCommands(cli) {
   inputCommand(exposures, "update <exposure-id>", "updateCmsExposure", "exposureId");
   refCommand(exposures, "publish <exposure-id>", "publishCmsExposure", "exposureId");
   refCommand(exposures, "archive <exposure-id>", "archiveCmsExposure", "exposureId");
+  inputCommand(exposures, "save-draft <exposure-id>", "saveCmsExposureDraft", "exposureId");
+  inputCommand(exposures, "schedule <exposure-id>", "updateCmsExposureSchedule", "exposureId");
+  inputCommand(exposures, "preview", "previewCmsExposure");
+  for (const [command, toolName] of [
+    ["pause", "pauseCmsExposure"],
+    ["resume", "resumeCmsExposure"],
+    ["cancel", "cancelCmsExposureReservation"],
+    ["duplicate", "duplicateCmsExposure"],
+    ["restore", "restoreCmsExposure"]
+  ]) {
+    exposures.command(`${command} <exposure-id>`).option("--site-id <id>").requiredOption("--expected-version <number>", "\uC870\uD68C\uD55C \uD604\uC7AC version", integer).action(async (exposureId, options) => runManagement(toolName, { exposureId, ...options }));
+  }
 }
 function refCommand(parent, syntax, toolName, key) {
-  parent.command(syntax).option("--site-id <id>").action(async (value, options) => runManagement(toolName, { [key]: value, ...options }));
+  const command = parent.command(syntax).option("--site-id <id>");
+  if (key === "exposureId" && (toolName === "publishCmsExposure" || toolName === "archiveCmsExposure")) {
+    command.option("--expected-version <number>", "\uC870\uD68C\uD55C \uD604\uC7AC version", integer);
+  }
+  command.action(async (value, options) => runManagement(toolName, { [key]: value, ...options }));
 }
 function twoRefCommand(parent, syntax, toolName) {
   parent.command(syntax).option("--site-id <id>").action(async (modelKey, groupKey, options) => runManagement(toolName, { modelKey, groupKey, ...options }));
@@ -1085,7 +1261,7 @@ function inputCommand(parent, syntax, toolName, firstKey, secondKey) {
     const refs = {};
     if (firstKey) refs[firstKey] = values[0];
     if (secondKey) refs[secondKey] = values[1];
-    await runManagement(toolName, { ...input, ...refs, siteId: options.siteId });
+    await runManagement(toolName, { ...input, ...refs, ...options.siteId ? { siteId: options.siteId } : {} });
   });
 }
 function registerMediaCommands(cli) {
@@ -1559,7 +1735,7 @@ function registerTools(server) {
 }
 
 // src/server.ts
-var VERSION = true ? "0.61.1" : "dev";
+var VERSION = true ? "0.63.0" : "dev";
 var SERVER_INSTRUCTIONS = `
 roottale-cms-mcp\uB294 RootTale CMS\uB97C \uC678\uBD80 \uC0AC\uC774\uD2B8(\uC8FC\uB85C Next.js)\uC5D0 \uC5F0\uB3D9\uD558\uACE0
 \uAE00\xB7\uC378\uB124\uC77C\xB7\uBCF8\uBB38 \uC774\uBBF8\uC9C0\uB97C \uC790\uB3D9\uD654\uD558\uAE30 \uC704\uD55C \uBB38\uC11C\xB7\uC608\uC2DC \uCF54\uB4DC\xB7API tool\uC744 \uC81C\uACF5\uD569\uB2C8\uB2E4.