@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
text/typescript
// @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),
}),
};
});
}