@roottale/cms-renderer-next 0.48.0 → 0.51.0

package/dist/routes.js

@@ -1,5 +1,5 @@
 import {
-  collectCategories,
+  collectCategoriesWithCounts,
   collectCollectionCategories,
   resolveCollections,
   resolveCollectionsResult,
@@ -14,20 +14,21 @@ import { CMS_CLIENT_VERSION } from "@roottale/cms-client/server";
 
 // src/routes-feed-sitemap.ts
 import {
-  fetchAuthors,
-  fetchBlogSettings,
-  fetchPosts,
   generateRssXml,
   rssItemsFromPosts
 } from "@roottale/cms-client/server";
 import {
-  isInCollectionMode,
-  resolvePostCollection as resolvePostCollection2,
-  resolvePostUrl as resolvePostUrl2
+  isInCollectionMode as isInCollectionMode2,
+  resolvePostCollection as resolvePostCollection3,
+  resolvePostUrl as resolvePostUrl3
 } from "@roottale/cms-core";
 
 // src/routes-metadata.ts
 import { resolvePostPath } from "@roottale/cms-core";
+function resolveRobotsMeta(flags) {
+  if (!flags.noindex && !flags.nofollow) return void 0;
+  return { index: !flags.noindex, follow: !flags.nofollow };
+}
 function buildPostMetadata(post, options = {}) {
   const seo = post.seo ?? void 0;
   const title = seo?.title || post.title;
@@ -79,9 +80,11 @@ function buildPostMetadata(post, options = {}) {
       }
     };
   }
-  if (seo?.noindex || seo?.nofollow) {
-    meta.robots = { index: !seo.noindex, follow: !seo.nofollow };
-  }
+  const robots = resolveRobotsMeta({
+    ...seo?.noindex !== void 0 && { noindex: seo.noindex },
+    ...seo?.nofollow !== void 0 && { nofollow: seo.nofollow }
+  });
+  if (robots) meta.robots = robots;
   if (post.id) meta.other = { "rt:content-id": post.id };
   const twitter = { card: "summary_large_image", title };
   if (description) twitter.description = description;
@@ -106,40 +109,133 @@ function buildHreflangLanguages(translations, siteUrl, locales) {
   return languages;
 }
 
-// src/routes-feed-sitemap.ts
-function createFeedRoute(config) {
-  return async function GET() {
-    const siteUrl = trimSlash(config.siteUrl);
-    const collections = await resolveCollections(config.collections);
-    const allPosts = await safeFetchPosts(config, 50);
-    const inCollectionMode = isInCollectionMode(collections);
-    const blogBase = config.blogBasePath ?? "/blog";
-    const posts = inCollectionMode ? allPosts.filter((p) => {
-      const c = resolvePostCollection2(p, collections);
-      return c ? c.feed === true && c.detail !== false && c.basePath !== "" : false;
-    }) : allPosts;
-    const xml = generateRssXml({
-      title: config.title,
-      link: inCollectionMode ? siteUrl : `${siteUrl}${blogBase}`,
-      feedUrl: `${siteUrl}/feed.xml`,
-      description: config.description,
-      language: config.language,
-      items: rssItemsFromPosts(posts, {
-        postUrl: (p) => inCollectionMode ? resolvePostUrl2(siteUrl, p, collections) ?? `${siteUrl}${blogBase}/${p.slug}` : `${siteUrl}${blogBase}/${p.slug}`
-      })
-    });
-    return new Response(xml, {
-      headers: {
-        "content-type": "application/rss+xml; charset=utf-8",
-        "cache-control": "public, max-age=1800, s-maxage=1800"
-      }
+// src/archive-index-policy.ts
+var ARCHIVE_POST_COUNT_LIMIT = 200;
+var NOT_FOUND = {
+  render: "notFound",
+  index: false,
+  inSitemap: false
+};
+var NOINDEX = {
+  render: "ok",
+  index: false,
+  inSitemap: false
+};
+var INDEXED = {
+  render: "ok",
+  index: true,
+  inSitemap: true
+};
+var POLICY_NOT_APPLIED = INDEXED;
+function isNonNegativeInteger(value) {
+  return Number.isInteger(value) && value >= 0;
+}
+function resolveCategoryPromotion(promotedSlugs, slug) {
+  if (!promotedSlugs) return "unknown";
+  return promotedSlugs.includes(slug) ? "promoted" : "not-promoted";
+}
+function resolveAuthorPromotion(authorsEnabled) {
+  if (authorsEnabled === void 0) return "unknown";
+  return authorsEnabled ? "promoted" : "not-promoted";
+}
+function decideArchiveIndex(input) {
+  const page = input.page ?? 1;
+  if (!isNonNegativeInteger(input.postCount)) return NOINDEX;
+  if (!isNonNegativeInteger(page) || page < 1) return NOINDEX;
+  if (input.postCount === 0 && input.kind !== "search") return NOT_FOUND;
+  if (page >= 2) return NOINDEX;
+  if (input.kind !== "category" && input.kind !== "author") return NOINDEX;
+  switch (input.promotion) {
+    case "promoted":
+      return INDEXED;
+    case "unknown":
+      return POLICY_NOT_APPLIED;
+    default:
+      return NOINDEX;
+  }
+}
+function buildArchiveMetadata(input, options = {}) {
+  const decision = decideArchiveIndex(input);
+  const meta = { title: input.title };
+  if (input.description) meta.description = input.description;
+  if (options.siteUrl && options.path) {
+    const normalized = options.path.startsWith("/") ? options.path : `/${options.path}`;
+    meta.alternates = { canonical: `${trimSlash(options.siteUrl)}${normalized}` };
+  }
+  const robots = resolveRobotsMeta({
+    noindex: !decision.index,
+    ...input.nofollow !== void 0 && { nofollow: input.nofollow }
+  });
+  if (robots) meta.robots = robots;
+  return meta;
+}
+
+// src/routes-sitemap-entries.ts
+import {
+  fetchAuthors,
+  fetchBlogSettings,
+  fetchPosts as fetchPosts2
+} from "@roottale/cms-client/server";
+import { isInCollectionMode, resolvePostCollection as resolvePostCollection2, resolvePostUrl as resolvePostUrl2 } from "@roottale/cms-core";
+
+// src/archive-categories.ts
+import {
+  fetchCategoryCounts,
+  fetchPosts
+} from "@roottale/cms-client/server";
+async function fetchBlogArchivePosts(config, options = {}) {
+  const page = await fetchPosts({
+    apiKey: config.apiKey,
+    baseUrl: config.apiBase,
+    type: "post",
+    limit: ARCHIVE_POST_COUNT_LIMIT,
+    // 서버측 "미소속 글" 필터 — 페이지(`excludeCollections`)와 같은 정의.
+    excludeCollections: true,
+    ...options.revalidate !== void 0 && { revalidate: options.revalidate }
+  });
+  return page.items;
+}
+async function fetchServerCategoryCounts(config, options) {
+  try {
+    const result = await fetchCategoryCounts({
+      apiKey: config.apiKey,
+      baseUrl: config.apiBase,
+      // 레거시 `/blog` 계열의 모집단 = 미소속 글. 페이지(`excludeCollections`)·
+      // 사이트맵과 **같은 서버 판정**을 쓰기 위해 서버 필터로 지정한다.
+      excludeCollections: true,
+      ...options.revalidate !== void 0 && { revalidate: options.revalidate }
     });
-  };
+    if (result.truncated) {
+      console.warn(
+        "[@roottale/cms-renderer-next/routes] \uBD84\uB958 \uC218\uAC00 \uC11C\uBC84 \uC0C1\uD55C\uC744 \uB118\uC5B4 \uC77C\uBD80\uAC00 \uC751\uB2F5\uC5D0\uC11C \uBE60\uC84C\uC2B5\uB2C8\uB2E4(\uC0C9\uC778\uC5D0\uC11C \uB204\uB77D\uB420 \uC218 \uC788\uC74C)."
+      );
+    }
+    return result.categories.filter((category) => category.publishedPostCount > 0).map((category) => ({
+      name: category.name,
+      slug: category.slug,
+      count: category.publishedPostCount
+    }));
+  } catch (err) {
+    console.warn(
+      "[@roottale/cms-renderer-next/routes] \uBD84\uB958\uBCC4 \uAE00 \uC218 \uC9D1\uACC4 API \uC2E4\uD328 \u2014 \uCD5C\uADFC \uAE00 \uBC30\uCE58 \uD30C\uC0DD\uC73C\uB85C \uD3F4\uBC31:",
+      err
+    );
+    return null;
+  }
+}
+async function fetchBlogArchiveCategories(config, options = {}) {
+  const counts = await fetchServerCategoryCounts(config, options);
+  if (counts) return counts;
+  return collectCategoriesWithCounts(await fetchBlogArchivePosts(config, options));
 }
+
+// src/routes-sitemap-entries.ts
 var SITEMAP_DEFAULTS = {
   blogImages: true,
   locales: [],
   authors: false
+  // promotedCategorySlugs 는 의도적으로 기본값이 없다 — "모름"(undefined)과
+  // "승격 0건"([])을 구분해야 색인 정책을 fail-soft 로 적용할 수 있다.
 };
 async function safeFetchAuthors(config) {
   try {
@@ -151,27 +247,36 @@ async function safeFetchAuthors(config) {
 }
 async function resolveSitemapSettings(config, opts) {
   let remote = {};
+  let settingsFetchFailed = false;
   if (!opts.skipRemoteSettings) {
     try {
       remote = (await fetchBlogSettings({
         apiKey: config.apiKey,
         baseUrl: config.apiBase
       })).sitemap ?? {};
-    } catch {
+    } catch (err) {
+      settingsFetchFailed = true;
+      console.error(
+        "[@roottale/cms-renderer-next/routes] fetchBlogSettings \uC2E4\uD328(\uAE30\uBCF8\uAC12\uC73C\uB85C \uC9C4\uD589):",
+        err
+      );
     }
   }
-  return {
+  const settings = {
     blogImages: opts.blogImages ?? remote.blogImages ?? SITEMAP_DEFAULTS.blogImages,
     locales: opts.locales ?? remote.locales ?? SITEMAP_DEFAULTS.locales,
     authors: opts.authors ?? remote.authors ?? SITEMAP_DEFAULTS.authors
   };
+  const promoted = opts.promotedCategorySlugs ?? remote.promotedCategorySlugs;
+  if (promoted) settings.promotedCategorySlugs = promoted;
+  return { settings, settingsFetchFailed };
 }
 async function localesWithPublishedContent(config, locales) {
   if (locales.length === 0) return locales;
   const checks = await Promise.all(
     locales.map(async (locale) => {
       try {
-        const page = await fetchPosts({
+        const page = await fetchPosts2({
           apiKey: config.apiKey,
           baseUrl: config.apiBase,
           type: "post",
@@ -224,84 +329,152 @@ function postEntries(config, siteUrl, posts, collections, settings, defaultLocal
     return [entry];
   });
 }
-function categoryEntries(config, siteUrl, posts, collections) {
+async function safeBlogArchiveCategories(config) {
+  try {
+    return await fetchBlogArchiveCategories(config);
+  } catch (err) {
+    console.error(
+      "[@roottale/cms-renderer-next/routes] \uC544\uCE74\uC774\uBE0C \uCE74\uD14C\uACE0\uB9AC \uC870\uD68C \uC2E4\uD328:",
+      err
+    );
+    return [];
+  }
+}
+async function categoryEntries(config, siteUrl, collections, promotedSlugs) {
+  const inSitemap = (category) => decideArchiveIndex({
+    kind: "category",
+    promotion: resolveCategoryPromotion(promotedSlugs, category.slug),
+    postCount: category.count
+  }).inSitemap;
   if (isInCollectionMode(collections)) {
+    const posts = await safeFetchPosts(config, ARCHIVE_POST_COUNT_LIMIT);
     return collections.filter((c) => c.archives && c.basePath).flatMap((c) => {
       const cats = collectCollectionCategories(posts, collections, c.key);
       if (!cats.length) return [];
       const base = `${siteUrl}${trimSlash(c.basePath)}`;
       return [
         { url: `${base}/categories` },
-        ...cats.map((category) => ({
+        ...cats.filter(inSitemap).map((category) => ({
           url: `${base}/categories/${category.slug}`
         }))
       ];
     });
   }
-  const categories = collectCategories(posts);
+  const categories = await safeBlogArchiveCategories(config);
   if (!categories.length) return [];
   const blogBase = config.blogBasePath ?? "/blog";
   return [
     { url: `${siteUrl}${blogBase}/categories` },
-    ...categories.map((category) => ({
+    ...categories.filter(inSitemap).map((category) => ({
       url: `${siteUrl}${blogBase}/categories/${category.slug}`
     }))
   ];
 }
+async function authorEntries(config, siteUrl, settings, authorBasePath) {
+  if (!settings.authors) return [];
+  const authors = await safeFetchAuthors(config);
+  const base = trimSlash(authorBasePath ?? "/blog/author");
+  const promotion = resolveAuthorPromotion(settings.authors);
+  return authors.filter(
+    (a) => decideArchiveIndex({
+      kind: "author",
+      promotion,
+      postCount: a.postCount
+    }).inSitemap
+  ).map((a) => ({
+    url: `${siteUrl}${base}/${encodeURIComponent(a.slug)}`,
+    lastModified: a.lastUpdatedAt ?? void 0
+  }));
+}
+
+// src/routes-feed-sitemap.ts
+function createFeedRoute(config) {
+  return async function GET() {
+    const siteUrl = trimSlash(config.siteUrl);
+    const collections = await resolveCollections(config.collections);
+    const allPosts = await safeFetchPosts(config, 50);
+    const inCollectionMode = isInCollectionMode2(collections);
+    const blogBase = config.blogBasePath ?? "/blog";
+    const posts = inCollectionMode ? allPosts.filter((p) => {
+      const c = resolvePostCollection3(p, collections);
+      return c ? c.feed === true && c.detail !== false && c.basePath !== "" : false;
+    }) : allPosts;
+    const xml = generateRssXml({
+      title: config.title,
+      link: inCollectionMode ? siteUrl : `${siteUrl}${blogBase}`,
+      feedUrl: `${siteUrl}/feed.xml`,
+      description: config.description,
+      language: config.language,
+      items: rssItemsFromPosts(posts, {
+        postUrl: (p) => inCollectionMode ? resolvePostUrl3(siteUrl, p, collections) ?? `${siteUrl}${blogBase}/${p.slug}` : `${siteUrl}${blogBase}/${p.slug}`
+      })
+    });
+    return new Response(xml, {
+      headers: {
+        "content-type": "application/rss+xml; charset=utf-8",
+        "cache-control": "public, max-age=1800, s-maxage=1800"
+      }
+    });
+  };
+}
 function createSitemap(config, staticRoutes = []) {
   return async function sitemap() {
     const siteUrl = trimSlash(config.siteUrl);
     const collections = await resolveCollections(config.collections);
-    const posts = await safeFetchPosts(config, 200);
-    const settings = await resolveSitemapSettings(config, {
+    const posts = await safeFetchPosts(config, ARCHIVE_POST_COUNT_LIMIT);
+    const { settings } = await resolveSitemapSettings(config, {
       skipRemoteSettings: true,
       blogImages: false
     });
     return [
       ...staticEntries(staticRoutes),
       ...postEntries(config, siteUrl, posts, collections, settings),
-      ...categoryEntries(config, siteUrl, posts, collections)
+      // settings.promotedCategorySlugs 는 여기서 항상 undefined(위 skipRemoteSettings)
+      // → 색인 정책 미적용 = 레거시 동등. 정책이 필요하면 createSitemapIndex 로.
+      ...await categoryEntries(config, siteUrl, collections, void 0)
     ];
   };
 }
 function createSitemapIndex(config, staticRoutes = [], opts = {}) {
   async function generateSitemaps() {
-    const settings = await resolveSitemapSettings(config, opts);
+    const { settings, settingsFetchFailed } = await resolveSitemapSettings(
+      config,
+      opts
+    );
     const ids = ["static", "blog", "categories"];
-    if (settings.authors) ids.push("authors");
+    if (settings.authors || settingsFetchFailed) ids.push("authors");
     return ids.map((id) => ({ id }));
   }
   async function sitemap(props) {
     const id = await props.id;
     const siteUrl = trimSlash(config.siteUrl);
-    const settings = await resolveSitemapSettings(config, opts);
+    const { settings } = await resolveSitemapSettings(config, opts);
     const activeLocales = await localesWithPublishedContent(config, settings.locales);
     const defaultLocale = activeLocales[0];
     if (id === "static") return staticEntries(staticRoutes);
     if (id === "authors") {
-      if (!settings.authors) return [];
-      const authors = await safeFetchAuthors(config);
-      const base = trimSlash(opts.authorBasePath ?? "/blog/author");
-      return authors.map((a) => ({
-        url: `${siteUrl}${base}/${encodeURIComponent(a.slug)}`,
-        lastModified: a.lastUpdatedAt ?? void 0
-      }));
+      return authorEntries(config, siteUrl, settings, opts.authorBasePath);
     }
     const collections = await resolveCollections(config.collections);
-    const posts = await safeFetchPosts(config, 200);
+    if (id === "categories") {
+      return categoryEntries(
+        config,
+        siteUrl,
+        collections,
+        settings.promotedCategorySlugs
+      );
+    }
     if (id === "blog") {
+      const posts = await safeFetchPosts(config, ARCHIVE_POST_COUNT_LIMIT);
       return postEntries(config, siteUrl, posts, collections, settings, defaultLocale);
     }
-    if (id === "categories") {
-      return categoryEntries(config, siteUrl, posts, collections);
-    }
     return [];
   }
   return { generateSitemaps, sitemap };
 }
 
 // src/routes-llms.ts
-import { isInCollectionMode as isInCollectionMode2, resolvePostUrl as resolvePostUrl3 } from "@roottale/cms-core";
+import { isInCollectionMode as isInCollectionMode3, resolvePostUrl as resolvePostUrl4 } from "@roottale/cms-core";
 function mdLinkSafe(text) {
   return text.replace(/[[\]()]/g, "").trim();
 }
@@ -326,10 +499,10 @@ function createLlmsTxtRoute(config) {
       }
     }
     if (posts.length > 0) {
-      const inCollectionMode = isInCollectionMode2(collections);
+      const inCollectionMode = isInCollectionMode3(collections);
       lines.push("", inCollectionMode ? "## \uCF58\uD150\uCE20" : "## \uBE14\uB85C\uADF8");
       for (const p of posts) {
-        const url = inCollectionMode ? resolvePostUrl3(siteUrl, p, collections) : `${siteUrl}${blogBase}/${p.slug}`;
+        const url = inCollectionMode ? resolvePostUrl4(siteUrl, p, collections) : `${siteUrl}${blogBase}/${p.slug}`;
         if (!url) continue;
         const excerpt = p.excerpt ? `: ${oneLine(p.excerpt)}` : "";
         lines.push(`- [${mdLinkSafe(p.title)}](${url})${excerpt}`);
@@ -350,7 +523,7 @@ function createLlmsTxtRoute(config) {
 import {
   verifyRootTaleWebhook
 } from "@roottale/cms-client/webhook";
-import { isInCollectionMode as isInCollectionMode3 } from "@roottale/cms-core";
+import { isInCollectionMode as isInCollectionMode4 } from "@roottale/cms-core";
 function pathsFromBody(rawBody) {
   try {
     const body = JSON.parse(rawBody);
@@ -406,7 +579,7 @@ function createRevalidateRoute(config) {
       if (failed) {
         alsoRevalidate = INVARIANTS;
         warning = "collections_resolve_failed";
-      } else if (isInCollectionMode3(collections)) {
+      } else if (isInCollectionMode4(collections)) {
         alsoRevalidate = [
           ...INVARIANTS,
           // 주소 없는 유형(basePath === "")은 라우트가 없으므로 revalidate 대상에서
@@ -657,7 +830,7 @@ function createFleetInfoRoute(config = {}) {
         site: config.site ?? env.VERCEL_PROJECT_PRODUCTION_URL ?? null,
         framework: "next",
         cms_client: CMS_CLIENT_VERSION,
-        cms_renderer: true ? "0.48.0" : "dev",
+        cms_renderer: true ? "0.51.0" : "dev",
         build_sha: env.VERCEL_GIT_COMMIT_SHA?.slice(0, 7) ?? null
       },
       { headers: { "cache-control": "public, max-age=300" } }
@@ -665,8 +838,10 @@ function createFleetInfoRoute(config = {}) {
   };
 }
 export {
+  ARCHIVE_POST_COUNT_LIMIT,
   OG_IMAGE_CONTENT_TYPE,
   OG_IMAGE_SIZE,
+  buildArchiveMetadata,
   buildHreflangLanguages,
   buildPostMetadata,
   createFeedRoute,
@@ -677,13 +852,19 @@ export {
   createRevalidateRoute,
   createSitemap,
   createSitemapIndex,
+  decideArchiveIndex,
+  fetchBlogArchiveCategories,
+  fetchBlogArchivePosts,
   matchRedirect,
   normalizeRedirectPath,
   postRedirectPath,
+  resolveAuthorPromotion,
+  resolveCategoryPromotion,
   resolveCollections,
   resolveCollectionsResult,
   resolvePostCollection,
   resolvePostUrl,
+  resolveRobotsMeta,
   safeFetchPosts,
   trimSlash
 };