@roottale/cms-mcp 0.53.1 → 0.56.0

package/examples/nextjs/app/preview/post/[id]/page.tsx

@@ -0,0 +1,70 @@
+// 글 미리보기 — ROOT-ADMIN 편집기의 '미리보기'·'공유 링크'가 여는 주소.
+// 관리자 발급 토큰(1시간, 글 1건 전용)으로 편집 중인 내용을 받아 발행 글과
+// **같은 템플릿**(RootTaleBlogPost)으로 그린다 → 미리보기 = 발행 결과.
+// 라우트를 배포한 뒤 관리자 설정 › 외부 연결 › "글 미리보기 여는 곳"에서
+// "홈페이지에서 열기"를 켜면 편집기가 이 주소를 연다.
+import type { Metadata } from "next";
+import { notFound } from "next/navigation";
+import {
+  fetchPostPreview,
+  isPreviewExpiredError,
+} from "@roottale/cms-client/server";
+import {
+  RootTaleBlogPost,
+  RootTalePreviewNotice,
+} from "@roottale/cms-renderer-next/server";
+import { buildPreviewMetadata } from "@roottale/cms-renderer-next/routes";
+
+// 초안이 ISR·CDN 에 남으면 안 된다 — 항상 동적 렌더.
+export const dynamic = "force-dynamic";
+export const revalidate = 0;
+
+type Props = {
+  params: Promise<{ id: string }>;
+  searchParams: Promise<{ token?: string }>;
+};
+
+function loadPreview(token: string) {
+  return fetchPostPreview({
+    apiKey: process.env.ROOTTALE_API_KEY!,
+    baseUrl: process.env.ROOTTALE_API_BASE,
+    token,
+  });
+}
+
+export async function generateMetadata({ searchParams }: Props): Promise<Metadata> {
+  const { token } = await searchParams;
+  const post = token ? await loadPreview(token).catch(() => null) : null;
+  // 항상 noindex/nofollow — 초안이 색인되거나 발행 주소와 중복되면 안 된다.
+  return buildPreviewMetadata({ title: post?.title });
+}
+
+export default async function PostPreviewPage({ params, searchParams }: Props) {
+  const { id } = await params;
+  const { token } = await searchParams;
+  if (!token) notFound(); // 주소만으로는 아무것도 보이지 않는다.
+
+  let expiresAt: string | undefined;
+  try {
+    const post = await loadPreview(token);
+    if (!post || post.id !== id) notFound(); // 토큰은 글 1건 전용
+    expiresAt = post.preview.expiresAt;
+  } catch (error) {
+    if (!isPreviewExpiredError(error)) throw error; // 만료는 컴포넌트가 안내
+  }
+
+  return (
+    <main className="container">
+      <RootTalePreviewNotice expiresAt={expiresAt} />
+      {/* 발행 글 상세(app/blog/[slug]/page.tsx)와 같은 props 를 쓰되
+          slugOrId 대신 previewToken 만 넘긴다. */}
+      <RootTaleBlogPost
+        apiKey={process.env.ROOTTALE_API_KEY!}
+        baseUrl={process.env.ROOTTALE_API_BASE}
+        previewToken={token}
+        relatedPostsCount={3}
+        breadcrumb={{ siteUrl: process.env.NEXT_PUBLIC_SITE_URL }}
+      />
+    </main>
+  );
+}

package/examples/nextjs/lib/blog.ts

@@ -3,6 +3,7 @@
 import {
   BLOG_SETTINGS_CACHE_TAG,
   fetchBlogSettings,
+  fetchCategoryCounts,
   fetchPost,
   type CmsPostContent,
 } from "@roottale/cms-client/server";
@@ -10,6 +11,7 @@ import {
   type ArchivePromotion,
   fetchBlogArchivePosts,
   resolveCategoryPromotion,
+  storedPostPath,
 } from "@roottale/cms-renderer-next/routes";
 
 function getApiKey(): string {
@@ -23,6 +25,11 @@ const baseUrl = process.env.ROOTTALE_API_BASE;
 export interface BlogPostMeta {
   id: string;
   slug: string;
+  /**
+   * 플랫폼이 저장한 정규 공개 경로(ADR-0105, 예 `/blog/my-post`). 링크·canonical·
+   * JSON-LD 는 이 값을 읽고, 없을 때(구 서버·주소 규칙 없는 유형)만 `/blog/{slug}` 로 폴백.
+   */
+  path: string | null;
   title: string;
   description: string;
   date: string; // publishedAt ISO
@@ -31,6 +38,7 @@ export interface BlogPostMeta {
   categorySlug: string; // "" = 카테고리 미지정 — /blog/categories/{slug} 허브 필터링용
   tags: { name: string; slug: string }[];
   image: string | null;
+  authorProfileId?: string | null;
   authorName?: string;
   authorSlug?: string | null; // /blog/author/{slug} — 미발급 작가는 null
   seo?: {
@@ -49,6 +57,7 @@ function toMeta(post: CmsPostContent): BlogPostMeta {
   return {
     id: post.id,
     slug: post.slug,
+    path: storedPostPath(post),
     title: post.title,
     description: post.excerpt ?? "",
     date: post.publishedAt ?? "",
@@ -60,6 +69,7 @@ function toMeta(post: CmsPostContent): BlogPostMeta {
         ?.filter((t) => t.taxonomy === "tag")
         .map((t) => ({ name: t.name, slug: t.slug })) ?? [],
     image: post.featuredImageUrl ?? null,
+    authorProfileId: post.authorProfileId,
     authorName: post.authorName ?? undefined,
     authorSlug: post.authorSlug,
     seo: meta.seo as BlogPostMeta["seo"],
@@ -96,6 +106,25 @@ export async function getPostsByCategory(
   return posts.filter((p) => p.categorySlug === categorySlug);
 }
 
+// 카테고리 허브의 소개문·검색 문구·공유 이미지는 카테고리 집계 응답에 함께 옵니다.
+// 구버전 API와 이미지 미설정을 고려해 nullable 값으로 다룹니다.
+export async function getCategoryArchiveMeta(categorySlug: string) {
+  const { categories } = await fetchCategoryCounts({
+    apiKey: getApiKey(),
+    baseUrl,
+    excludeCollections: true,
+  });
+  const category = categories.find((item) => item.slug === categorySlug);
+  if (!category) return null;
+  return {
+    title: category.seoTitle ?? `${category.name} 글 모음`,
+    description: category.seoDescription ?? category.description,
+    image: category.imageUrl
+      ? { url: category.imageUrl, alt: category.imageAlt ?? category.name }
+      : null,
+  };
+}
+
 // 색인 위생 — 어드민 "내 사이트 > 카테고리 > 검색에 이 분류 페이지 노출" 을 켠
 // 분류인지. 켜지 않은 분류의 모음 페이지는 noindex + 사이트맵 제외가 됩니다
 // (seo.md "색인 위생" 절).

package/examples/nextjs/lib/content-models.ts

@@ -0,0 +1,12 @@
+import { fetchContentModels, fetchPosts } from "@roottale/cms-client/server";
+
+const apiKey = process.env.ROOTTALE_API_KEY!;
+
+export async function getTeamMembers() {
+  const models = await fetchContentModels({ apiKey });
+  const model = models.models.find((candidate) => candidate.key === "team-member");
+  if (!model || model.preset !== "entity") return [];
+
+  const response = await fetchPosts({ apiKey, modelKey: model.key, limit: 100 });
+  return response.items;
+}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@roottale/cms-mcp",
-  "version": "0.53.1",
+  "version": "0.56.0",
   "type": "module",
-  "description": "RootTale CMS MCP server and CLI for post publishing, media uploads, integration docs, and public API access.",
+  "description": "RootTale CMS MCP server and CLI for models, entries, exposures, media, integration docs, and public API access.",
   "bin": {
     "roottale-cms-mcp": "dist/index.js"
   },