@roottale/cms-mcp
Version:
RootTale CMS MCP server and CLI for models, entries, exposures, media, integration docs, and public API access.
155 lines (145 loc) • 5.85 kB
text/typescript
// RootTale CMS 블로그 데이터 레이어 — 서버 전용.
// 사이트 UI에 맞는 메타 형태로 변환하는 wrapper. API 키는 env에서만 읽는다.
import {
BLOG_SETTINGS_CACHE_TAG,
fetchBlogSettings,
fetchCategoryCounts,
fetchPost,
type CmsPostContent,
} from "@roottale/cms-client/server";
import {
type ArchivePromotion,
fetchBlogArchivePosts,
resolveCategoryPromotion,
storedPostPath,
} from "@roottale/cms-renderer-next/routes";
function getApiKey(): string {
const key = process.env.ROOTTALE_API_KEY;
if (!key) throw new Error("ROOTTALE_API_KEY is not set");
return key;
}
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
modified: string; // updatedAt ISO — avcd 구조 og:article:modified_time·dateModified
category: string;
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?: {
title?: string;
description?: string;
canonical?: string;
ogImage?: string;
noindex?: boolean;
nofollow?: boolean;
};
}
function toMeta(post: CmsPostContent): BlogPostMeta {
const category = post.terms?.find((t) => t.taxonomy === "category");
const meta = (post.metaJson ?? {}) as Record<string, unknown>;
return {
id: post.id,
slug: post.slug,
path: storedPostPath(post),
title: post.title,
description: post.excerpt ?? "",
date: post.publishedAt ?? "",
modified: post.updatedAt,
category: category?.name ?? "",
categorySlug: category?.slug ?? "",
tags:
post.terms
?.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"],
};
}
// `/blog` 계열 표면(목록·분류 모음)이 다루는 글 = 콘텐츠 유형(스트림)에 속하지
// 않은 글. 사이트맵도 **같은 함수**로 같은 글을 세므로 "사이트맵엔 주소가 있는데
// 페이지는 404" 가 생기지 않습니다(한도 상수도 함께 따라옵니다).
export async function getAllPosts(): Promise<BlogPostMeta[]> {
const posts = await fetchBlogArchivePosts({
apiKey: getApiKey(),
apiBase: baseUrl,
});
return posts.map(toMeta);
}
export async function getPost(
slug: string,
): Promise<(BlogPostMeta & { bodyJson: unknown }) | null> {
const post = await fetchPost({ apiKey: getApiKey(), baseUrl, slugOrId: slug });
if (!post) return null;
return { ...toMeta(post), bodyJson: post.bodyJson };
}
// 카테고리 허브(`/blog/categories/{slug}`)용 — RootTaleBlogList/RootTaleBlogCategories
// 의 기본 카테고리 링크가 이 경로를 가리키므로(defaultCategoryHref), 사이트는 이
// 라우트를 반드시 구현해야 합니다(안 하면 카테고리 칩·브레드크럼 클릭이 404).
// `/v1/cms/public/posts` 는 카테고리 서버 필터가 없어 클라이언트에서 거릅니다.
export async function getPostsByCategory(
categorySlug: string,
): Promise<BlogPostMeta[]> {
const posts = await getAllPosts();
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 "색인 위생" 절).
//
// 반환은 boolean 이 아니라 3-state(`promoted` / `not-promoted` / `unknown`)입니다.
// 설정을 못 읽었을 때(구버전 API·조회 실패) `not-promoted` 로 바꿔 넘기면, 설정
// 조회가 한 번 실패했다는 이유만으로 이미 검색에 올라가 있던 주소에 noindex 가
// 붙습니다. `unknown` 을 그대로 넘기면 정책이 알아서 기존 상태를 보존합니다.
export async function getCategoryPromotion(
categorySlug: string,
): Promise<ArchivePromotion> {
try {
// `tags` = 캐시 이름표. 어드민에서 블로그 표시 설정을 저장하면 revalidate
// 라우트가 이 이름표로 이 fetch 캐시를 지운다.
const settings = await fetchBlogSettings({
apiKey: getApiKey(),
baseUrl,
tags: [BLOG_SETTINGS_CACHE_TAG],
});
return resolveCategoryPromotion(
settings.sitemap?.promotedCategorySlugs,
categorySlug,
);
} catch {
return "unknown";
}
}