UNPKG

@roottale/cms-mcp

Version:

RootTale CMS MCP server and CLI for models, entries, exposures, media, integration docs, and public API access.

113 lines (105 loc) • 5 kB
// @roottale/cms-core를 사이트의 직접 의존성에 추가합니다(SDK 0.70.0+). import { ContentPolicyWhenSchema, evaluateContentPolicy, resolvePostPublicPath, type ContentPolicy, type ContentPolicyCheck, type ContentQueryCandidate, type MetadataRobotsPolicy, type PublicPathContext, } from "@roottale/cms-core"; import { CONTENT_POLICY_CACHE_TAG, fetchCategoryCounts, fetchAllPosts, type CmsPostContent, type FetchCategoryCountsOptions, type FetchPostsOptions, } from "@roottale/cms-client/server"; // 이 예제에는 등록된 사이트 콘텐츠 계약이 없습니다. 정책을 사용하는 사이트는 // 배포 계약 metadata.posts.contentPolicies를 여기서 import하여 그대로 내보냅니다. // 상세·목록·사이트맵에 같은 정책을 연결한 뒤 이 값을 설정하세요. export const registeredContentPolicies: | Readonly<Record<string, ContentPolicy>> | undefined = undefined; export type PolicyPost = CmsPostContent & { path: string | null }; // 예외 조건도 등록한 정책 안에 둡니다. 이 상수만으로 글을 공개하지 않습니다. // 아래 세 값이 정확히 일치할 때만 방송 기록이며 누락/null은 false가 아닙니다. const broadcastRecordFields = [ { field: "content_format", equals: "media" }, { field: "broadcast_record", equals: true }, { field: "medical_content", equals: false }, ]; export const broadcastRecordWhen = ContentPolicyWhenSchema.parse({ all: broadcastRecordFields }); export const reviewExceptBroadcastRecordWhen = ContentPolicyWhenSchema.parse({ unlessAll: broadcastRecordFields }); export const performerExceptBroadcastRecordWhen = ContentPolicyWhenSchema.parse({ all: [{ field: "content_format", equals: "media" }], unlessAll: broadcastRecordFields, }); /** Add to the full indexing policy; direct noindex:false cannot override a failed check. */ export const broadcastRecordNoindexCheck: ContentPolicyCheck = { field: "broadcast_record", op: "notEquals", value: true, when: { all: [ { field: "content_format", equals: "media" }, { field: "medical_content", equals: false }, ] }, }; // 문서의 compatibilityCollectionKey: null인 blog 모델 예제입니다. // 경로 계산에는 글에 붙은 분류만이 아닌 모델의 전체 graph가 필요합니다. // null collectionKey는 기존 blog 범위이며 응답 원본은 재작성하지 않습니다. export async function fetchBlogCategoryGraph( options: Omit<FetchCategoryCountsOptions, "collectionKey" | "excludeCollections">, ) { const result = await fetchCategoryCounts({ ...options, tags: [...new Set([...(options.tags ?? []), CONTENT_POLICY_CACHE_TAG])], }); if (result.truncated) throw new Error("모델의 전체 분류를 가져오지 못했습니다"); return result.categories.filter((category) => (category.collectionKey ?? "blog") === "blog").map((category) => { if (!category.id) throw new Error("분류의 안정 ID가 없습니다"); return { ...category, id: category.id }; }); } // 첫 100건은 완전한 목록이 아닙니다. query.modelKeys의 각 모델에 대해 호출하고, // 모든 호출이 성공한 뒤에만 evaluateContentQuery에 complete: true를 전달합니다. export async function fetchAllContentPolicyPosts( options: Omit<FetchPostsOptions, "cursor" | "limit">, ): Promise<PolicyPost[]> { const posts = await fetchAllPosts({ ...options, tags: [...new Set([...(options.tags ?? []), CONTENT_POLICY_CACHE_TAG])], limit: 100, maxPages: 100, cursorGuard: "repeated", }); return posts.map((post) => ({ ...post, path: post.path ?? null })); } // 한 요청에서 이 결과를 목록 본문·메타데이터·사이트맵에 재사용합니다. // contextFor는 해당 모델의 presentation/호환 컬렉션/전체 분류를 반환해야 합니다. // 분류·모델·컬렉션을 fetch할 때도 CONTENT_POLICY_CACHE_TAG를 붙입니다. export function evaluateContentPolicyPosts( posts: readonly PolicyPost[], policies: Readonly<Record<string, ContentPolicy>>, contextFor: (post: PolicyPost) => PublicPathContext, options: { now?: number; robotsFor?: (post: PolicyPost) => MetadataRobotsPolicy | undefined; } = {}, ): ContentQueryCandidate<PolicyPost>[] { const now = options.now ?? Date.now(); return posts.map((post) => { const modelKey = post.modelKey ?? post.collectionKey ?? ""; const policy = Object.hasOwn(policies, modelKey) ? policies[modelKey] : undefined; if (!policy) throw new Error(`모델 ${modelKey}의 공개 정책이 없습니다`); return { post, policy: evaluateContentPolicy(policy, post, { now, // null도 그대로 전달합니다. post.path 자체를 expectedPath로 쓰면 // 모델의 실제 경로와 다른 글을 걸러낼 수 없습니다. expectedPath: resolvePostPublicPath(post, contextFor(post)), robots: options.robotsFor?.(post), }), }; }); }