UNPKG

@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
// 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"; } }