@roottale/cms-renderer-next 0.35.0 → 0.36.0

package/dist/routes.d.ts

@@ -306,6 +306,124 @@ declare function matchRedirect(redirects: readonly RootTaleRedirect[], pathname:
  */
 declare function createRedirectMiddleware(config: RedirectMiddlewareConfig): (request: Request) => Promise<Response | null>;
 
+/**
+ * `@roottale/cms-renderer-next/routes` — 블로그 글 메타데이터 빌더.
+ *
+ * 어드민 SEO 패널(`metaJson.seo`) 값을 Next.js `Metadata` 형태로 1줄 변환한다.
+ * 고객사 `app/blog/[slug]/page.tsx` 의 `generateMetadata` 에서 매번 직접 쓰던
+ * canonical/robots/openGraph 분기 보일러플레이트를 표준화 — 한 곳이라도
+ * 빠뜨려 SEO 가 새는 사고(noindex 누락·canonical 미설정)를 방지한다.
+ *
+ * 설계 원칙(패키지 공통): `next` 에 직접 의존하지 않는다. 반환은 Next `Metadata`
+ * 의 구조적 부분집합인 plain 객체이므로, 소비자는 `generateMetadata` 에서 그대로
+ * `return` 하면 된다.
+ */
+
+/** 어드민 SEO 패널 override (`metaJson.seo`). 전부 선택. */
+interface PostSeoOverrides {
+    /** 검색 제목 — 비면 글 제목 사용. */
+    title?: string;
+    /** 메타 설명 — 비면 글 요약 사용. */
+    description?: string;
+    /** 대표 URL. 비면 `siteUrl`+`path` 로 self-canonical 생성(옵션 제공 시). */
+    canonical?: string;
+    /** OG 이미지 — 비면 글 대표 이미지 사용. */
+    ogImage?: string;
+    /** 색인 제외. */
+    noindex?: boolean;
+    /** 링크 추적 제외. */
+    nofollow?: boolean;
+}
+/** `buildPostMetadata` 입력 — `BlogPostMeta`·원본 post 모두 구조적으로 호환. */
+interface PostMetadataInput {
+    /** 글 제목 (`seo.title` 없을 때 fallback). */
+    title: string;
+    /** 글 요약/설명 (`seo.description` 없을 때 fallback). */
+    description?: string | null;
+    /** 발행 ISO 일시 → `openGraph.publishedTime`. */
+    date?: string | null;
+    /** 대표 이미지 URL → `openGraph.images` (`seo.ogImage` 우선). */
+    image?: string | null;
+    /** 어드민 SEO 패널 override (`metaJson.seo`). */
+    seo?: PostSeoOverrides | null;
+    /** 글 slug — `collections` 기반 canonical 자동 해석에 사용. */
+    slug?: string;
+    /**
+     * 소속 섹션 key (ADR-0060). `collections` 와 함께 주면 canonical basePath 를
+     * 공지/블로그로 구분해 해석한다(`collectionKey:"notice"` → `/notice`).
+     */
+    collectionKey?: string | null;
+}
+interface BuildPostMetadataOptions {
+    /**
+     * self-canonical 기본값 origin (예: `https://example.com`).
+     * `seo.canonical` override 가 있으면 무시된다. `path` 또는 `collections` 와
+     * 함께 줄 때만 동작.
+     */
+    siteUrl?: string;
+    /**
+     * self-canonical 기본값 경로 (예: `/blog/my-post`). `siteUrl` 과 함께.
+     * 명시하면 `collections` 파생보다 우선한다(단일 라우트 사이트용 명시 경로).
+     */
+    path?: string;
+    /**
+     * 섹션 정의 (ADR-0060). `path` 를 안 주면 글의 `collectionKey` 로 소속 섹션
+     * basePath 를 찾아 canonical 경로를 **공지/블로그로 구분해 자동 해석**한다
+     * (공지 글 → `/notice/{slug}`, 블로그 글 → `/blog/{slug}`). 어느 섹션에도
+     * 안 속하면(미설정·미존재 key) canonical 을 생략한다. `post.slug` 필요.
+     */
+    collections?: readonly RouteCollection[];
+}
+/** Next `Metadata` 의 구조적 부분집합 — 소비자는 그대로 return 가능. */
+interface PostMetadata {
+    title: string;
+    description?: string;
+    alternates?: {
+        canonical: string;
+    };
+    robots?: {
+        index: boolean;
+        follow: boolean;
+    };
+    openGraph: {
+        type: "article";
+        title: string;
+        description?: string;
+        url?: string;
+        publishedTime?: string;
+        images?: {
+            url: string;
+            alt: string;
+        }[];
+    };
+}
+/**
+ * 글 메타데이터를 Next `Metadata` 형태로 빌드.
+ *
+ * - 제목/설명/OG 이미지는 어드민 SEO override 가 있으면 우선, 없으면 글 값 fallback.
+ * - canonical: `seo.canonical` override → 없으면 `siteUrl`+`path`(명시) → 없으면
+ *   `siteUrl`+`collections`(글의 `collectionKey` 로 공지/블로그 basePath 자동 해석)
+ *   → 없으면 생략. 모든 글이 자기 자신을 가리키는 canonical 을 갖는 게 권장이므로
+ *   `siteUrl` 과 함께 `path` 또는 `collections` 전달을 권장한다.
+ * - `noindex`/`nofollow` 중 하나라도 켜지면 `robots` 출력.
+ *
+ * ```ts
+ * // 단일 블로그(레거시): 라우트가 곧 섹션이므로 path 를 직접 준다.
+ * return buildPostMetadata(post, {
+ *   siteUrl: process.env.NEXT_PUBLIC_SITE_URL,
+ *   path: `/blog/${post.slug}`,
+ * });
+ *
+ * // 다중 스트림(ADR-0060): collections 를 주면 공지/블로그를 글의
+ * // collectionKey 로 구분해 canonical 을 자동 해석한다(공지→/notice, 블로그→/blog).
+ * return buildPostMetadata(post, {
+ *   siteUrl: process.env.NEXT_PUBLIC_SITE_URL,
+ *   collections: COLLECTIONS,
+ * });
+ * ```
+ */
+declare function buildPostMetadata(post: PostMetadataInput, options?: BuildPostMetadataOptions): PostMetadata;
+
 /**
  * `@roottale/cms-renderer-next/routes` — Next.js App Router 통합 라우트 팩토리.
  *
@@ -365,4 +483,4 @@ interface FleetInfoRouteConfig {
  */
 declare function createFleetInfoRoute(config?: FleetInfoRouteConfig): () => Promise<Response>;
 
-export { type CollectionsInput, type FleetInfoRouteConfig, type ImageResponseLike, type LlmsTxtLink, type LlmsTxtRouteConfig, type LlmsTxtSection, OG_IMAGE_CONTENT_TYPE, OG_IMAGE_SIZE, type OgImageRouteConfig, type RedirectMiddlewareConfig, type RevalidateRouteConfig, type RootTaleSiteConfig, type SitemapEntry, createFeedRoute, createFleetInfoRoute, createLlmsTxtRoute, createPostOgImage, createRedirectMiddleware, createRevalidateRoute, createSitemap, matchRedirect, normalizeRedirectPath, postRedirectPath, resolveCollections, resolveCollectionsResult, safeFetchPosts, trimSlash };
+export { type BuildPostMetadataOptions, type CollectionsInput, type FleetInfoRouteConfig, type ImageResponseLike, type LlmsTxtLink, type LlmsTxtRouteConfig, type LlmsTxtSection, OG_IMAGE_CONTENT_TYPE, OG_IMAGE_SIZE, type OgImageRouteConfig, type PostMetadata, type PostMetadataInput, type PostSeoOverrides, type RedirectMiddlewareConfig, type RevalidateRouteConfig, type RootTaleSiteConfig, type SitemapEntry, buildPostMetadata, createFeedRoute, createFleetInfoRoute, createLlmsTxtRoute, createPostOgImage, createRedirectMiddleware, createRevalidateRoute, createSitemap, matchRedirect, normalizeRedirectPath, postRedirectPath, resolveCollections, resolveCollectionsResult, safeFetchPosts, trimSlash };

package/dist/routes.js

@@ -1,7 +1,7 @@
 import {
   collectCategories,
   collectCollectionCategories
-} from "./chunk-O6KHDNGH.js";
+} from "./chunk-FUA5H6JE.js";
 
 // src/routes.ts
 import { CMS_CLIENT_VERSION } from "@roottale/cms-client/server";
@@ -453,6 +453,41 @@ function createRedirectMiddleware(config) {
   };
 }
 
+// src/routes-metadata.ts
+import { resolvePostPath } from "@roottale/cms-core";
+function buildPostMetadata(post, options = {}) {
+  const seo = post.seo ?? void 0;
+  const title = seo?.title || post.title;
+  const description = seo?.description || post.description || void 0;
+  const ogImage = seo?.ogImage || post.image || void 0;
+  let canonical = seo?.canonical || void 0;
+  if (!canonical && options.siteUrl) {
+    let path = options.path;
+    if (!path && options.collections && post.slug) {
+      path = resolvePostPath(
+        { slug: post.slug, terms: [], collectionKey: post.collectionKey ?? null },
+        options.collections
+      ) ?? void 0;
+    }
+    if (path) {
+      const normalized = path.startsWith("/") ? path : `/${path}`;
+      canonical = `${trimSlash(options.siteUrl)}${normalized}`;
+    }
+  }
+  const openGraph = { type: "article", title };
+  if (description) openGraph.description = description;
+  if (canonical) openGraph.url = canonical;
+  if (post.date) openGraph.publishedTime = post.date;
+  if (ogImage) openGraph.images = [{ url: ogImage, alt: title }];
+  const meta = { title, openGraph };
+  if (description) meta.description = description;
+  if (canonical) meta.alternates = { canonical };
+  if (seo?.noindex || seo?.nofollow) {
+    meta.robots = { index: !seo.noindex, follow: !seo.nofollow };
+  }
+  return meta;
+}
+
 // src/routes.ts
 function postRedirectPath(post, requestedSlug, blogBasePath = "/blog") {
   let requested = requestedSlug;
@@ -471,7 +506,7 @@ function createFleetInfoRoute(config = {}) {
         site: config.site ?? env.VERCEL_PROJECT_PRODUCTION_URL ?? null,
         framework: "next",
         cms_client: CMS_CLIENT_VERSION,
-        cms_renderer: true ? "0.35.0" : "dev",
+        cms_renderer: true ? "0.36.0" : "dev",
         build_sha: env.VERCEL_GIT_COMMIT_SHA?.slice(0, 7) ?? null
       },
       { headers: { "cache-control": "public, max-age=300" } }
@@ -481,6 +516,7 @@ function createFleetInfoRoute(config = {}) {
 export {
   OG_IMAGE_CONTENT_TYPE,
   OG_IMAGE_SIZE,
+  buildPostMetadata,
   createFeedRoute,
   createFleetInfoRoute,
   createLlmsTxtRoute,

package/dist/routes.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/routes.ts","../src/routes-shared.ts","../src/routes-feed-sitemap.ts","../src/routes-llms.ts","../src/routes-revalidate.ts","../src/routes-og.ts","../src/routes-redirects.ts"],"sourcesContent":["/**\n * `@roottale/cms-renderer-next/routes` — Next.js App Router 통합 라우트 팩토리.\n *\n * 외부 고객사 사이트가 매번 직접 작성하던 공통 라우트(RSS feed / sitemap /\n * revalidate webhook / llms.txt / OG 이미지)를 1줄 팩토리로 표준화. 블로그 조회와\n * *동일한* 단일 customer API key(`ROOTTALE_API_KEY`)를 사용한다.\n *\n * 설계 원칙:\n * - feed/sitemap/llms 는 fetch 실패를 swallow → 라우트가 *항상 200*.\n * - revalidate 는 서명 webhook 을 검증하고 본문 paths + 파생 경로를 revalidate.\n * - `next` 에 직접 의존하지 않음(revalidate 콜백·ImageResponse 주입).\n *\n * 구현은 `routes-*.ts` 모듈로 분리되어 있고 본 파일은 공개 배럴이다(파일당 ≤400줄).\n * 사용 예는 roottale-docs `services/external-site-integration.md` 참조.\n */\n\nimport { CMS_CLIENT_VERSION } from \"@roottale/cms-client/server\";\n\nimport { trimSlash } from \"./routes-shared.js\";\n\n// ── 공개 표면 배럴 (모듈별 구현 re-export) ───────────────────────────────────\nexport * from \"./routes-shared.js\";\nexport * from \"./routes-feed-sitemap.js\";\nexport * from \"./routes-llms.js\";\nexport * from \"./routes-revalidate.js\";\nexport * from \"./routes-og.js\";\n// 커스텀 리다이렉트 미들웨어 (WP RankMath Redirections 패리티).\nexport * from \"./routes-redirects.js\";\n\n// ── slug 변경 301 (WP permalink 패리티) ─────────────────────────────────────\n\n/**\n * 옛 slug → 현재 slug 301 redirect 판단 (순수 함수, `next` 비의존).\n *\n * Public API 는 slug 변경 후에도 옛 slug 로 글을 찾아 *현재* slug 를 응답한다\n * (post_slug_history fallback). 요청 slug 와 응답 slug 가 다르면 새 경로를\n * 반환 — 페이지에서 `permanentRedirect()` 로 301 처리한다:\n *\n * ```ts\n * import { permanentRedirect, notFound } from \"next/navigation\";\n * import { postRedirectPath } from \"@roottale/cms-renderer-next/routes\";\n *\n * const post = await getPost(slug);\n * if (!post) notFound();\n * const redirect = postRedirectPath(post, slug);\n * if (redirect) permanentRedirect(redirect);\n * ```\n *\n * Next App Router 의 `params` 는 percent-encoding 된 채 들어올 수 있어\n * (한글 slug) 디코딩 후 비교한다. redirect 가 불필요하면 null.\n */\nexport function postRedirectPath(\n  post: { slug: string },\n  requestedSlug: string,\n  blogBasePath = \"/blog\",\n): string | null {\n  let requested = requestedSlug;\n  try {\n    requested = decodeURIComponent(requestedSlug);\n  } catch {\n    /* 잘못된 escape — 원본 그대로 비교 */\n  }\n  if (post.slug === requested) return null;\n  // blogBasePath \"/\" 또는 \"\" = 루트 배치 → \"/{slug}\".\n  return `${trimSlash(blogBasePath)}/${encodeURIComponent(post.slug)}`;\n}\n\n// ── fleet well-known (사이트 버전 노출 컨벤션) ───────────────────────────────\n\ndeclare const __CMS_RENDERER_VERSION__: string | undefined;\n\nexport interface FleetInfoRouteConfig {\n  /** 사이트 식별 라벨 (선택 — 기본 Vercel project URL 또는 null). */\n  site?: string;\n}\n\n/**\n * `GET /.well-known/roottale.json` — fleet 가시성 컨벤션 라우트.\n *\n * 플랫폼 internal fleet API 의 `?probe=1` 이 본 엔드포인트를 읽어 \"배포된\"\n * 패키지 버전을 트래픽 없이도 확인한다 (런타임 check-in 의 보조 신호).\n * 노출은 의도적으로 최소: 패키지 버전 + 짧은 build sha — 비밀 없음.\n *\n * 사용 (Next App Router):\n * ```ts\n * // app/.well-known/roottale.json/route.ts\n * import { createFleetInfoRoute } from \"@roottale/cms-renderer-next/routes\";\n * export const GET = createFleetInfoRoute();\n * ```\n */\nexport function createFleetInfoRoute(\n  config: FleetInfoRouteConfig = {},\n): () => Promise<Response> {\n  // dts 빌드는 node types 없이 돈다 — process 는 globalThis 경유로 안전 접근.\n  const env =\n    (globalThis as { process?: { env?: Record<string, string | undefined> } })\n      .process?.env ?? {};\n  return async function GET(): Promise<Response> {\n    return Response.json(\n      {\n        site: config.site ?? env.VERCEL_PROJECT_PRODUCTION_URL ?? null,\n        framework: \"next\",\n        cms_client: CMS_CLIENT_VERSION,\n        cms_renderer:\n          typeof __CMS_RENDERER_VERSION__ === \"string\"\n            ? __CMS_RENDERER_VERSION__\n            : \"dev\",\n        build_sha: env.VERCEL_GIT_COMMIT_SHA?.slice(0, 7) ?? null,\n      },\n      { headers: { \"cache-control\": \"public, max-age=300\" } },\n    );\n  };\n}\n","/**\n * `routes` 공통 — config 타입, collections resolve, fetch 헬퍼. feed/sitemap/llms/\n * revalidate/og 모듈이 공유한다(순환 import 회피). 공개 표면은 `routes.ts` 배럴.\n */\n\nimport { fetchPosts, type CmsPostContent } from \"@roottale/cms-client/server\";\nimport type { RouteCollection } from \"@roottale/cms-core\";\n\nexport type { RouteCollection };\n// 소비자 가드용 재export (`/blog/[slug]` 에서 스트림 누출 차단 등) — ADR-0060.\nexport { resolvePostCollection, resolvePostUrl } from \"@roottale/cms-core\";\n\nexport interface RootTaleSiteConfig {\n  /** `rtlk_cust_*` — 블로그 조회와 같은 키. 서버에서만(절대 브라우저 금지). */\n  apiKey: string;\n  /** API base 오버라이드. 기본 `https://api.roottale.com`. */\n  apiBase?: string;\n  /** 사이트 절대 URL (뒤 슬래시 없이). 예: `https://kjmtax.roottale.app`. */\n  siteUrl: string;\n  /** 피드/사이트 제목. */\n  title: string;\n  description?: string;\n  /** 기본 \"ko-KR\". */\n  language?: string;\n  /** 블로그 base path. 기본 \"/blog\". 레거시 단일 스트림 — `collections` 미사용 시. */\n  blogBasePath?: string;\n  /**\n   * 다중 스트림 라우팅 (ADR-0060). **길이 > 0 이면 collection 모드** — feed/sitemap/\n   * llms.txt 가 글을 소속 스트림 basePath 로 라우팅하고, 어느 스트림에도 안 속한 글은\n   * 제외한다. 비우거나 미전달 = 레거시 단일 `blogBasePath`(/blog) 동작(하위호환).\n   * 선언 순서 = 우선순위(first-wins).\n   *\n   * 배열 또는 **async resolver**(`() => Promise<RouteCollection[]>`)를 받는다 — 후자는\n   * 사이트가 `@roottale/cms-client` `fetchCollections()` 로 admin 설정을 가져올 때 쓴다.\n   * resolver 가 throw 하면 fail-soft(레거시 단일 /blog).\n   */\n  collections?: CollectionsInput;\n}\n\n/** collections 입력 — 정적 배열 또는 async resolver(admin 설정 fetch 용). */\nexport type CollectionsInput =\n  | RouteCollection[]\n  | (() => RouteCollection[] | Promise<RouteCollection[]>);\n\n/** resolve 결과 — `failed` 로 \"resolver throw\" 를 \"collections 미설정\" 과 구분한다. */\nexport async function resolveCollectionsResult(\n  input: CollectionsInput | undefined,\n): Promise<{ collections: RouteCollection[] | undefined; failed: boolean }> {\n  if (typeof input === \"function\") {\n    try {\n      return { collections: await input(), failed: false };\n    } catch (err) {\n      console.error(\n        \"[@roottale/cms-renderer-next/routes] collections resolver 실패:\",\n        err,\n      );\n      return { collections: undefined, failed: true };\n    }\n  }\n  return { collections: input, failed: false };\n}\n\n/**\n * resolver 면 호출(실패 시 undefined → 레거시), 배열이면 그대로. GET 팩토리(feed/\n * sitemap/llms)는 always-200 철학상 실패를 레거시 /blog 로 흡수 — revalidate 만\n * `resolveCollectionsResult` 로 실패를 구분해 under-invalidation 을 막는다.\n */\nexport async function resolveCollections(\n  input: CollectionsInput | undefined,\n): Promise<RouteCollection[] | undefined> {\n  return (await resolveCollectionsResult(input)).collections;\n}\n\nexport function trimSlash(u: string): string {\n  return u.replace(/\\/+$/, \"\");\n}\n\nexport async function safeFetchPosts(\n  config: RootTaleSiteConfig,\n  limit: number,\n): Promise<CmsPostContent[]> {\n  try {\n    const page = await fetchPosts({\n      apiKey: config.apiKey,\n      baseUrl: config.apiBase,\n      type: \"post\",\n      limit,\n    });\n    return page.items;\n  } catch (err) {\n    // 빌드/런타임 fetch 실패 시 빈 목록 — 라우트는 항상 정상 응답(404 방지).\n    console.error(\"[@roottale/cms-renderer-next/routes] fetchPosts 실패:\", err);\n    return [];\n  }\n}\n","/** `routes` — RSS feed + sitemap 팩토리. collection 모드/레거시 양쪽. */\n\nimport { generateRssXml, rssItemsFromPosts } from \"@roottale/cms-client/server\";\nimport {\n  isInCollectionMode,\n  resolvePostCollection,\n  resolvePostUrl,\n} from \"@roottale/cms-core\";\n\nimport { collectCategories, collectCollectionCategories } from \"./blog-filter.js\";\nimport {\n  type RootTaleSiteConfig,\n  resolveCollections,\n  safeFetchPosts,\n  trimSlash,\n} from \"./routes-shared.js\";\n\n/**\n * `app/feed.xml/route.ts` 용 GET 핸들러. RSS 2.0.\n *\n * ```ts\n * import { createFeedRoute } from \"@roottale/cms-renderer-next/routes\";\n * export const dynamic = \"force-dynamic\";\n * export const GET = createFeedRoute({\n *   apiKey: process.env.ROOTTALE_API_KEY!,\n *   siteUrl: \"https://example.com\",\n *   title: \"Example 블로그\",\n *   description: \"...\",\n * });\n * ```\n */\nexport function createFeedRoute(\n  config: RootTaleSiteConfig,\n): () => Promise<Response> {\n  return async function GET(): Promise<Response> {\n    const siteUrl = trimSlash(config.siteUrl);\n    const collections = await resolveCollections(config.collections);\n    const allPosts = await safeFetchPosts(config, 50);\n\n    // collection 모드: /feed.xml = `feed:true` 스트림들의 합집합(aggregate). RSS\n    // 리더는 안정적 사이트 피드를 기대하므로 스트림별 분리 대신 통합 피드(codex).\n    // 각 글 링크는 소속 스트림 basePath 로. 레거시: 단일 blogBasePath.\n    const inCollectionMode = isInCollectionMode(collections);\n    const blogBase = config.blogBasePath ?? \"/blog\";\n    const posts = inCollectionMode\n      ? allPosts.filter((p) => {\n          const c = resolvePostCollection(p, collections!);\n          return c ? c.feed === true : false;\n        })\n      : allPosts;\n\n    const xml = generateRssXml({\n      title: config.title,\n      link: inCollectionMode ? siteUrl : `${siteUrl}${blogBase}`,\n      feedUrl: `${siteUrl}/feed.xml`,\n      description: config.description,\n      language: config.language,\n      items: rssItemsFromPosts(posts, {\n        postUrl: (p) =>\n          inCollectionMode\n            ? (resolvePostUrl(siteUrl, p, collections!) ?? `${siteUrl}${blogBase}/${p.slug}`)\n            : `${siteUrl}${blogBase}/${p.slug}`,\n      }),\n    });\n    return new Response(xml, {\n      headers: {\n        \"content-type\": \"application/rss+xml; charset=utf-8\",\n        \"cache-control\": \"public, max-age=1800, s-maxage=1800\",\n      },\n    });\n  };\n}\n\n/** Next `MetadataRoute.Sitemap[number]` 와 구조 호환(타입 결합 회피). */\nexport interface SitemapEntry {\n  url: string;\n  lastModified?: string | Date;\n  changeFrequency?:\n    | \"always\"\n    | \"hourly\"\n    | \"daily\"\n    | \"weekly\"\n    | \"monthly\"\n    | \"yearly\"\n    | \"never\";\n  priority?: number;\n}\n\n/**\n * `app/sitemap.ts` default export. 정적 경로 + 글 경로를 합친다.\n *\n * ```ts\n * import { createSitemap } from \"@roottale/cms-renderer-next/routes\";\n * export default createSitemap(\n *   { apiKey: process.env.ROOTTALE_API_KEY!, siteUrl: \"https://example.com\", title: \"...\" },\n *   [{ url: \"https://example.com\", changeFrequency: \"weekly\", priority: 1 }],\n * );\n * ```\n */\nexport function createSitemap(\n  config: RootTaleSiteConfig,\n  staticRoutes: SitemapEntry[] = [],\n): () => Promise<SitemapEntry[]> {\n  return async function sitemap(): Promise<SitemapEntry[]> {\n    const siteUrl = trimSlash(config.siteUrl);\n    const blogBase = config.blogBasePath ?? \"/blog\";\n    const collections = await resolveCollections(config.collections);\n    const posts = await safeFetchPosts(config, 200);\n\n    if (isInCollectionMode(collections)) {\n      // 글마다 소속 스트림 basePath 로(공지→/notice, 블로그→/blog). 어느 스트림에도\n      // 안 속한 글(상세 라우트 없음)은 제외. 아카이브는 `archives:true` 스트림만.\n      const postEntries: SitemapEntry[] = posts.flatMap((p) => {\n        const url = resolvePostUrl(siteUrl, p, collections!);\n        if (!url) return [];\n        return [\n          {\n            url,\n            lastModified: p.updatedAt ?? p.publishedAt ?? undefined,\n            changeFrequency: \"weekly\" as const,\n            priority: 0.6,\n          },\n        ];\n      });\n\n      const categoryEntries: SitemapEntry[] = collections!\n        .filter((c) => c.archives)\n        .flatMap((c) => {\n          const cats = collectCollectionCategories(posts, collections!, c.key);\n          if (!cats.length) return [];\n          const base = `${siteUrl}${trimSlash(c.basePath)}`;\n          return [\n            { url: `${base}/categories`, changeFrequency: \"weekly\" as const, priority: 0.5 },\n            ...cats.map((category) => ({\n              url: `${base}/categories/${category.slug}`,\n              changeFrequency: \"weekly\" as const,\n              priority: 0.5,\n            })),\n          ];\n        });\n\n      return [...staticRoutes, ...postEntries, ...categoryEntries];\n    }\n\n    // 레거시: 단일 blogBasePath.\n    const postEntries: SitemapEntry[] = posts.map((p) => ({\n      url: `${siteUrl}${blogBase}/${p.slug}`,\n      lastModified: p.updatedAt ?? p.publishedAt ?? undefined,\n      changeFrequency: \"weekly\",\n      priority: 0.6,\n    }));\n    const categories = collectCategories(posts);\n    const categoryEntries: SitemapEntry[] = categories.length\n      ? [\n          {\n            url: `${siteUrl}${blogBase}/categories`,\n            changeFrequency: \"weekly\",\n            priority: 0.5,\n          },\n          ...categories.map((category) => ({\n            url: `${siteUrl}${blogBase}/categories/${category.slug}`,\n            changeFrequency: \"weekly\" as const,\n            priority: 0.5,\n          })),\n        ]\n      : [];\n    return [...staticRoutes, ...postEntries, ...categoryEntries];\n  };\n}\n","/** `routes` — llms.txt (AEO/GEO, AI 검색·생성엔진용 마크다운 인덱스). */\n\nimport { isInCollectionMode, resolvePostUrl } from \"@roottale/cms-core\";\n\nimport {\n  type RootTaleSiteConfig,\n  resolveCollections,\n  safeFetchPosts,\n  trimSlash,\n} from \"./routes-shared.js\";\n\n/** llms.txt 정적 섹션의 링크 1개. */\nexport interface LlmsTxtLink {\n  title: string;\n  url: string;\n  /** 링크 뒤 \": {note}\" 로 붙는 한 줄 설명 (선택). */\n  note?: string;\n}\n\n/** llms.txt 의 정적 페이지 링크 그룹 — 블로그 목록 앞에 출력. */\nexport interface LlmsTxtSection {\n  title: string;\n  links: LlmsTxtLink[];\n}\n\nexport type LlmsTxtRouteConfig = RootTaleSiteConfig & {\n  /** (선택) 서비스 소개 등 정적 페이지 링크 그룹. */\n  sections?: LlmsTxtSection[];\n};\n\n/** 마크다운 링크 텍스트를 깨뜨리는 문자([, ], (, )) 제거. */\nfunction mdLinkSafe(text: string): string {\n  return text.replace(/[[\\]()]/g, \"\").trim();\n}\n\n/** excerpt 를 1줄로 — 개행·연속 공백을 공백 1개로 정리 후 200자 절단. */\nfunction oneLine(text: string): string {\n  return text.replace(/\\s+/g, \" \").trim().slice(0, 200);\n}\n\n/**\n * `app/llms.txt/route.ts` 용 GET 핸들러 — AEO/GEO(AI 검색·생성엔진 최적화).\n *\n * AI 크롤러(ChatGPT/Claude/Perplexity 등)가 사이트 구조·콘텐츠를 빠르게\n * 파악하도록 llms.txt 스펙(https://llmstxt.org)의 마크다운 인덱스를 제공한다.\n * 발행 글 최대 100개를 \"## 블로그\" 섹션으로 자동 포함 — feed/sitemap 처럼\n * fetch 실패도 swallow 하여 *항상 200* (헤더 부분만 출력).\n *\n * ```ts\n * import { createLlmsTxtRoute } from \"@roottale/cms-renderer-next/routes\";\n * export const dynamic = \"force-dynamic\";\n * export const GET = createLlmsTxtRoute({\n *   apiKey: process.env.ROOTTALE_API_KEY!,\n *   siteUrl: \"https://example.com\",\n *   title: \"Example\",\n *   description: \"...\",\n *   sections: [{ title: \"주요 페이지\", links: [{ title: \"서비스\", url: \"https://example.com/services\" }] }],\n * });\n * ```\n */\nexport function createLlmsTxtRoute(\n  config: LlmsTxtRouteConfig,\n): () => Promise<Response> {\n  return async function GET(): Promise<Response> {\n    const siteUrl = trimSlash(config.siteUrl);\n    const blogBase = config.blogBasePath ?? \"/blog\";\n    const collections = await resolveCollections(config.collections);\n    const posts = await safeFetchPosts(config, 100);\n\n    const lines: string[] = [`# ${config.title}`];\n    if (config.description) {\n      lines.push(\"\", `> ${oneLine(config.description)}`);\n    }\n    for (const section of config.sections ?? []) {\n      lines.push(\"\", `## ${section.title}`);\n      for (const link of section.links) {\n        const note = link.note ? `: ${oneLine(link.note)}` : \"\";\n        lines.push(`- [${mdLinkSafe(link.title)}](${link.url})${note}`);\n      }\n    }\n    if (posts.length > 0) {\n      const inCollectionMode = isInCollectionMode(collections);\n      // 레거시 헤딩(\"## 블로그\")은 하위호환 유지, 다중 스트림은 \"## 콘텐츠\".\n      lines.push(\"\", inCollectionMode ? \"## 콘텐츠\" : \"## 블로그\");\n      for (const p of posts) {\n        // collection 모드: 소속 스트림 URL, 미소속 글 제외. 레거시: 단일 blogBase.\n        const url = inCollectionMode\n          ? resolvePostUrl(siteUrl, p, collections!)\n          : `${siteUrl}${blogBase}/${p.slug}`;\n        if (!url) continue;\n        const excerpt = p.excerpt ? `: ${oneLine(p.excerpt)}` : \"\";\n        lines.push(`- [${mdLinkSafe(p.title)}](${url})${excerpt}`);\n      }\n    }\n    lines.push(\"\");\n\n    return new Response(lines.join(\"\\n\"), {\n      headers: {\n        \"content-type\": \"text/plain; charset=utf-8\",\n        // feed 와 동일한 30분 캐시 — webhook alsoRevalidate 로 즉시 갱신됨.\n        \"cache-control\": \"public, max-age=1800, s-maxage=1800\",\n      },\n    });\n  };\n}\n","/** `routes` — revalidate webhook 핸들러 (서명 검증 + 파생 경로 재검증). */\n\nimport {\n  verifyRootTaleWebhook,\n  type VerifyRootTaleWebhookResult,\n} from \"@roottale/cms-client/webhook\";\nimport { isInCollectionMode } from \"@roottale/cms-core\";\n\nimport { type CollectionsInput, resolveCollectionsResult } from \"./routes-shared.js\";\n\nexport interface RevalidateRouteConfig {\n  /** `rtlk_cust_*` — 블로그 조회/webhook 검증 공통 키. */\n  apiKey: string;\n  apiBase?: string;\n  /** Next 의 `revalidatePath` (또는 동등 콜백) 주입. */\n  revalidate: (path: string) => void | Promise<void>;\n  /** 블로그 base path. 기본 \"/blog\". */\n  blogBasePath?: string;\n  /**\n   * 다중 스트림 (ADR-0060). 지정 시 `alsoRevalidate` 기본값을 각 스트림 basePath\n   * (+ `archives:true` 면 `${basePath}/categories`)로 파생. 미지정 = 레거시 단일 blog.\n   * 배열 또는 async resolver(`fetchCollections()`) — resolver 실패 시 레거시로 fail-soft.\n   */\n  collections?: CollectionsInput;\n  /**\n   * 모든 글/분류/미디어 변경에 대해 *항상 함께* revalidate 할 파생 경로.\n   * 피드·사이트맵·블로그 인덱스처럼 \"글 목록\"에 의존하는 경로 — admin 변경이\n   * 자동 반영되려면 필수. 명시 시 collections 파생을 덮어쓴다.\n   * 기본(레거시): [\"/feed.xml\", \"/sitemap.xml\", \"/llms.txt\", blogBase, `${blogBase}/categories`].\n   */\n  alsoRevalidate?: string[];\n  /** (옵션) jti replay 방지 hook (cms-client verify 로 전달). */\n  consumeJti?: (jti: string, exp: number) => Promise<\"new\" | \"seen\">;\n}\n\n/** webhook 본문에서 paths[] 추출(서명 검증 후 호출 — body_hash 가 binding). */\nfunction pathsFromBody(rawBody: string): string[] {\n  try {\n    const body = JSON.parse(rawBody) as { paths?: unknown };\n    if (Array.isArray(body.paths)) {\n      return body.paths.filter((p): p is string => typeof p === \"string\");\n    }\n  } catch {\n    /* 비-JSON 본문 — 파생 경로만 revalidate */\n  }\n  return [];\n}\n\n/**\n * `app/api/revalidate/route.ts` 용 POST 핸들러.\n *\n * admin(mysite.roottale.com)이 글/카테고리/미디어 변경 시 보내는 서명 webhook 을\n * 검증하고, 본문 paths + 파생 경로(feed·sitemap·블로그 인덱스)를 revalidate.\n *\n * ```ts\n * import { revalidatePath } from \"next/cache\";\n * import { createRevalidateRoute } from \"@roottale/cms-renderer-next/routes\";\n * export const POST = createRevalidateRoute({\n *   apiKey: process.env.ROOTTALE_API_KEY!,\n *   revalidate: revalidatePath,\n * });\n * ```\n */\nexport function createRevalidateRoute(\n  config: RevalidateRouteConfig,\n): (req: Request) => Promise<Response> {\n  const blogBase = config.blogBasePath ?? \"/blog\";\n\n  return async function POST(req: Request): Promise<Response> {\n    const rawBody = await req.text();\n    const result: VerifyRootTaleWebhookResult = await verifyRootTaleWebhook({\n      rawBody,\n      headers: req.headers,\n      apiKey: config.apiKey,\n      apiBase: config.apiBase,\n      consumeJti: config.consumeJti,\n    });\n    if (!result.ok) {\n      return Response.json({ ok: false, reason: result.reason }, { status: 401 });\n    }\n\n    // 글 목록 의존 경로. 명시 alsoRevalidate 가 있으면 collections 를 resolve 하지 않는다\n    // (불필요한 fetch/지연 방지 — codex#1). 없으면 요청 시 resolve 해 파생.\n    // 항상 갱신하는 불변 경로 — feed/sitemap/llms 는 글 목록에 의존.\n    const INVARIANTS = [\"/feed.xml\", \"/sitemap.xml\", \"/llms.txt\"];\n    let alsoRevalidate: string[];\n    let warning: string | undefined;\n    if (config.alsoRevalidate) {\n      alsoRevalidate = config.alsoRevalidate;\n    } else {\n      const { collections, failed } = await resolveCollectionsResult(config.collections);\n      if (failed) {\n        // resolver 실패: 스트림을 추측하지 않는다(잘못된 /blog 무효화 방지 — codex#2).\n        // 불변 경로 + 본문 paths 만 갱신하고, 플랫폼이 재시도/알림하도록 warning 노출.\n        alsoRevalidate = INVARIANTS;\n        warning = \"collections_resolve_failed\";\n      } else if (isInCollectionMode(collections)) {\n        alsoRevalidate = [\n          ...INVARIANTS,\n          ...collections!.flatMap((c) =>\n            c.archives ? [c.basePath, `${c.basePath}/categories`] : [c.basePath],\n          ),\n        ];\n      } else {\n        alsoRevalidate = [...INVARIANTS, blogBase, `${blogBase}/categories`];\n      }\n    }\n\n    // 본문 paths + 파생 경로(항상) — 중복 제거.\n    const paths = [...new Set([...pathsFromBody(rawBody), ...alsoRevalidate])];\n    for (const p of paths) {\n      await config.revalidate(p);\n    }\n\n    return Response.json({\n      ok: true,\n      event: result.event,\n      deliveryId: result.deliveryId,\n      revalidated: paths,\n      ...(warning ? { warning } : {}),\n    });\n  };\n}\n","/** `routes` — 동적 OG 이미지 (글별 1200×630, 한글 폰트 subset). */\n\nimport { fetchPost } from \"@roottale/cms-client/server\";\n\nimport { type RootTaleSiteConfig, trimSlash } from \"./routes-shared.js\";\n\n/** Next `opengraph-image` export 컨벤션과 호환되는 크기 상수. */\nexport const OG_IMAGE_SIZE = { width: 1200, height: 630 } as const;\nexport const OG_IMAGE_CONTENT_TYPE = \"image/png\";\n\nexport interface OgImageRouteConfig extends RootTaleSiteConfig {\n  /** 배경색. 기본 진네이비 그라데이션 베이스. */\n  backgroundColor?: string;\n  /** 본문 텍스트 색. 기본 흰색. */\n  foregroundColor?: string;\n  /** 상단 액센트 바 + 브랜드 라벨 색. 기본 하늘색. */\n  accentColor?: string;\n  /** 하단 브랜드 라벨. 기본 = `title`. */\n  brandLabel?: string;\n}\n\n/** `next/og` 의 ImageResponse 와 구조 호환(직접 의존 회피 — revalidate 콜백 주입과 동일 원칙). */\nexport interface ImageResponseLike {\n  new (\n    element: unknown,\n    options?: {\n      width?: number;\n      height?: number;\n      fonts?: { name: string; data: ArrayBuffer; weight?: number; style?: \"normal\" }[];\n    },\n  ): Response;\n}\n\n/**\n * 제목에 쓰인 글자만 부분셋(subset)으로 받아 한글을 렌더 — satori 기본 폰트는\n * 한글 글리프가 없다. 구형 UA 로 css2 를 호출하면 TTF(satori 호환) URL 을 준다.\n * 실패 시 null — 폰트 없이도 이미지는 생성(라틴 fallback).\n */\nasync function loadKoreanFontSubset(text: string): Promise<ArrayBuffer | null> {\n  try {\n    const unique = Array.from(new Set(Array.from(text))).join(\"\");\n    const cssUrl = `https://fonts.googleapis.com/css2?family=Noto+Sans+KR:wght@700&text=${encodeURIComponent(unique)}`;\n    const cssRes = await fetch(cssUrl, {\n      headers: { \"user-agent\": \"Mozilla/5.0 (Windows NT 6.1; rv:10.0)\" },\n    });\n    if (!cssRes.ok) return null;\n    const css = await cssRes.text();\n    const match = css.match(\n      /src:\\s*url\\(([^)]+)\\)\\s*format\\(['\"](?:truetype|opentype)['\"]\\)/,\n    );\n    if (!match?.[1]) return null;\n    const fontRes = await fetch(match[1]);\n    if (!fontRes.ok) return null;\n    return await fontRes.arrayBuffer();\n  } catch (err) {\n    console.error(\"[@roottale/cms-renderer-next/routes] OG 폰트 로딩 실패:\", err);\n    return null;\n  }\n}\n\n/**\n * `app/blog/[slug]/opengraph-image.tsx` 용 동적 OG 이미지 (1200×630).\n *\n * `next/og` 의 ImageResponse 를 주입받는다 — 본 패키지는 `next` 에 직접\n * 의존하지 않는다. 글이 없거나 fetch 실패면 사이트 제목만으로 fail-soft 렌더\n * (소셜 크롤러에 빈 카드 대신 브랜드 카드).\n *\n * ```tsx\n * // app/blog/[slug]/opengraph-image.tsx\n * import { ImageResponse } from \"next/og\";\n * import {\n *   createPostOgImage,\n *   OG_IMAGE_SIZE,\n *   OG_IMAGE_CONTENT_TYPE,\n * } from \"@roottale/cms-renderer-next/routes\";\n * import { roottale } from \"@/lib/roottale\"; // RootTaleSiteConfig\n *\n * export const size = OG_IMAGE_SIZE;\n * export const contentType = OG_IMAGE_CONTENT_TYPE;\n * export default createPostOgImage(roottale, { ImageResponse });\n * ```\n */\nexport function createPostOgImage(\n  config: OgImageRouteConfig,\n  deps: { ImageResponse: ImageResponseLike },\n): (props: { params: Promise<{ slug: string }> | { slug: string } }) => Promise<Response> {\n  const background = config.backgroundColor ?? \"#10172a\";\n  const foreground = config.foregroundColor ?? \"#f8fafc\";\n  const accent = config.accentColor ?? \"#38bdf8\";\n  const brand = config.brandLabel ?? config.title;\n\n  return async function OgImage(props): Promise<Response> {\n    const { slug } = await props.params;\n\n    let title = config.title;\n    let dateLabel: string | null = null;\n    try {\n      const post = await fetchPost({\n        apiKey: config.apiKey,\n        baseUrl: config.apiBase,\n        slugOrId: slug,\n      });\n      if (post) {\n        title = post.title;\n        dateLabel = new Intl.DateTimeFormat(\"ko-KR\", { dateStyle: \"long\" }).format(\n          new Date(post.publishedAt),\n        );\n      }\n    } catch (err) {\n      console.error(\"[@roottale/cms-renderer-next/routes] OG fetchPost 실패:\", err);\n    }\n\n    // satori 줄바꿈에 맡기되 3줄을 넘는 초장문 제목만 자른다.\n    const display = title.length > 64 ? `${title.slice(0, 63)}…` : title;\n    const fontData = await loadKoreanFontSubset(`${display}${brand}${dateLabel ?? \"\"}`);\n\n    const { createElement: h } = await import(\"react\");\n    const element = h(\n      \"div\",\n      {\n        style: {\n          width: \"100%\",\n          height: \"100%\",\n          display: \"flex\",\n          flexDirection: \"column\",\n          justifyContent: \"space-between\",\n          padding: \"72px 80px\",\n          backgroundColor: background,\n          backgroundImage: `linear-gradient(135deg, ${background} 60%, rgba(56,189,248,0.25))`,\n          color: foreground,\n          fontFamily: fontData ? \"NotoSansKR\" : \"sans-serif\",\n        },\n      },\n      h(\"div\", {\n        style: { width: 96, height: 10, backgroundColor: accent, borderRadius: 5 },\n      }),\n      h(\n        \"div\",\n        {\n          style: {\n            display: \"flex\",\n            fontSize: display.length > 36 ? 56 : 68,\n            fontWeight: 700,\n            lineHeight: 1.25,\n            letterSpacing: \"-0.02em\",\n            wordBreak: \"keep-all\",\n          },\n        },\n        display,\n      ),\n      h(\n        \"div\",\n        {\n          style: {\n            display: \"flex\",\n            justifyContent: \"space-between\",\n            alignItems: \"center\",\n            fontSize: 28,\n          },\n        },\n        h(\"div\", { style: { display: \"flex\", color: accent, fontWeight: 700 } }, brand),\n        h(\n          \"div\",\n          { style: { display: \"flex\", color: \"rgba(248,250,252,0.72)\" } },\n          dateLabel ?? trimSlash(config.siteUrl).replace(/^https?:\\/\\//, \"\"),\n        ),\n      ),\n    );\n\n    return new deps.ImageResponse(element, {\n      width: OG_IMAGE_SIZE.width,\n      height: OG_IMAGE_SIZE.height,\n      ...(fontData\n        ? { fonts: [{ name: \"NotoSansKR\", data: fontData, weight: 700 as const, style: \"normal\" as const }] }\n        : {}),\n    });\n  };\n}\n","/**\n * 커스텀 리다이렉트 미들웨어 — 고객 Next 앱의 `middleware.ts` 에서 마운트.\n *\n * admin \"설정 > 주소 이동\" 에서 정의한 임의 경로 규칙(`/old → /new`)을 공개\n * API(`GET /v1/cms/public/redirects`)로 읽어 요청 경로에 매칭, 301/302 를\n * 발행한다. 슬러그 301(`postRedirectPath`)이 글 라우트에서 도는 것과 달리,\n * 임의 경로는 라우팅 *이전* 단계인 middleware 에서만 가로챌 수 있다.\n *\n * `next` 에 직접 의존하지 않는다(패키지 정책): 입력은 표준 `Request`(NextRequest\n * 가 상속), 출력은 표준 `Response`(NextResponse 가 상속)다.\n *\n * 사용 (Next App Router):\n * ```ts\n * // middleware.ts\n * import { NextResponse } from \"next/server\";\n * import { createRedirectMiddleware } from \"@roottale/cms-renderer-next/routes\";\n *\n * const redirects = createRedirectMiddleware({\n *   apiKey: process.env.ROOTTALE_API_KEY!,\n * });\n *\n * export async function middleware(req: Request) {\n *   return (await redirects(req)) ?? NextResponse.next();\n * }\n *\n * // Next 내부·정적 자산만 제외. `.*\\\\..*` 처럼 점 포함 경로를 전부 막으면\n * // `/old.html`·`/foo.php` 같은 레거시 마이그레이션 리다이렉트가 동작하지\n * // 않으므로, 알려진 자산 확장자만 제외한다.\n * export const config = {\n *   matcher: [\n *     \"/((?!_next/|api/|.*\\\\.(?:ico|png|jpg|jpeg|gif|svg|webp|css|js|txt|xml|json|woff2?|map)$).*)\",\n *   ],\n * };\n * ```\n */\n\nimport { fetchRedirects } from \"@roottale/cms-client/server\";\nimport type { RootTaleRedirect } from \"@roottale/cms-client/server\";\n\nexport interface RedirectMiddlewareConfig {\n  /** `rtlk_cust_*` — 블로그 조회와 같은 키. 서버에서만. */\n  apiKey: string;\n  /** API base 오버라이드. 기본 `https://api.roottale.com`. */\n  apiBase?: string;\n  /** site_id 명시(멀티사이트 키). 기본 = 키의 기본 사이트. */\n  siteId?: string;\n  /** 규칙 캐시 TTL(ms). 기본 60_000 (1분). */\n  cacheTtlMs?: number;\n}\n\n/**\n * 경로 정규화 — 앞 슬래시 보장, 뒤 슬래시 제거(루트 제외), 쿼리/해시 제거,\n * percent-decode. 출발 경로 비교·한글 slug 매칭·루프 탐지에 요청·규칙 양쪽에\n * 동일 적용한다. 쿼리 제거는 `/a → /a?x` 류의 무한 루프 방지에 중요.\n */\nexport function normalizeRedirectPath(path: string): string {\n  let p = path;\n  try {\n    p = decodeURIComponent(path);\n  } catch {\n    /* 잘못된 escape — 원본 유지 */\n  }\n  p = p.split(/[?#]/)[0] ?? p; // 쿼리·해시 제거\n  if (!p.startsWith(\"/\")) p = `/${p}`;\n  if (p.length > 1) p = p.replace(/\\/+$/, \"\");\n  return p === \"\" ? \"/\" : p;\n}\n\nfunction isAbsoluteUrl(target: string): boolean {\n  return /^https?:\\/\\//i.test(target);\n}\n\n/**\n * 요청 경로에 맞는 규칙을 찾는다(순수 함수, fetch 비의존 — 테스트 용이).\n * 정확 경로 일치만(와일드카드 없음).\n *\n * 내부 경로 체인을 따라가 최종 도착지를 한 번에 반환한다(`/a→/b→/c` ⇒ `/c`):\n * 리다이렉트 체인을 줄여 SEO·왕복을 개선하고, 한 호출 안에서의 무한 루프를\n * 막는다. 도착지가 출발지로 정규화되면(쿼리만 다른 경우 포함) 자기 루프로 보고\n * 매칭하지 않는다. 절대 URL 도착지는 체인 종단(다른 origin 위임). 상태 코드는\n * 실제 요청 경로에 매칭된 첫 규칙을 따른다. null = 해당 없음.\n */\nexport function matchRedirect(\n  redirects: readonly RootTaleRedirect[],\n  pathname: string,\n): { toTarget: string; statusCode: 301 | 302 } | null {\n  const byFrom = new Map<string, RootTaleRedirect>();\n  for (const r of redirects) {\n    const key = normalizeRedirectPath(r.fromPath);\n    if (!byFrom.has(key)) byFrom.set(key, r);\n  }\n\n  const start = normalizeRedirectPath(pathname);\n  const visited = new Set<string>([start]);\n  let current = start;\n  let finalTarget: string | null = null;\n  let firstStatus: 301 | 302 | null = null;\n\n  for (let hop = 0; hop < 10; hop++) {\n    const rule = byFrom.get(current);\n    if (!rule) break;\n    if (hop === 0) firstStatus = rule.statusCode;\n\n    if (isAbsoluteUrl(rule.toTarget)) {\n      finalTarget = rule.toTarget; // 절대 URL = 체인 종단\n      break;\n    }\n    const nextPath = normalizeRedirectPath(rule.toTarget);\n    if (nextPath === start) {\n      // 시작점으로 복귀 = 루프. 첫 홉이면 자기 루프(매칭 안 함), 아니면 직전\n      // finalTarget 까지만 적용해 한 호출 안에서의 무한 루프를 끊는다.\n      if (hop === 0) return null;\n      break;\n    }\n    finalTarget = rule.toTarget;\n    if (visited.has(nextPath)) break; // 사이클 — 현재까지로 종료\n    visited.add(nextPath);\n    current = nextPath;\n  }\n\n  if (finalTarget === null || firstStatus === null) return null;\n  return { toTarget: finalTarget, statusCode: firstStatus };\n}\n\ninterface CacheEntry {\n  expires: number;\n  value: RootTaleRedirect[];\n}\n\n/**\n * 미들웨어 팩토리. 규칙을 TTL 캐시하고(요청마다 API 호출 회피), fetch 실패는\n * swallow 해 트래픽을 절대 막지 않는다(stale 우선, 없으면 빈 목록 → 통과).\n *\n * 반환 함수: 매칭 시 redirect `Response`, 아니면 `null`(호출부가 통과 처리).\n */\nexport function createRedirectMiddleware(\n  config: RedirectMiddlewareConfig,\n): (request: Request) => Promise<Response | null> {\n  const ttl = config.cacheTtlMs ?? 60_000;\n  let cache: CacheEntry | null = null;\n\n  async function loadRedirects(now: number): Promise<RootTaleRedirect[]> {\n    if (cache && cache.expires > now) return cache.value;\n    try {\n      const value = await fetchRedirects({\n        apiKey: config.apiKey,\n        baseUrl: config.apiBase,\n        siteId: config.siteId,\n      });\n      cache = { expires: now + ttl, value };\n      return value;\n    } catch (err) {\n      console.error(\n        \"[@roottale/cms-renderer-next] fetchRedirects 실패 — 통과(fail-soft):\",\n        err,\n      );\n      // stale 값이 있으면 그것으로, 없으면 빈 목록. 짧게 재시도 억제.\n      if (cache) {\n        cache = { expires: now + Math.min(ttl, 10_000), value: cache.value };\n        return cache.value;\n      }\n      return [];\n    }\n  }\n\n  return async function redirectMiddleware(\n    request: Request,\n  ): Promise<Response | null> {\n    let pathname: string;\n    let origin: string;\n    try {\n      const u = new URL(request.url);\n      pathname = u.pathname;\n      origin = u.origin;\n    } catch {\n      return null;\n    }\n\n    // 캐시 키가 stable 한 시각 — Date.now 는 미들웨어 런타임에서 허용.\n    const now = Date.now();\n    const redirects = await loadRedirects(now);\n    const hit = matchRedirect(redirects, pathname);\n    if (!hit) return null;\n\n    // 내부 경로는 요청 origin 기준 절대화, 절대 URL 은 그대로.\n    const dest = new URL(hit.toTarget, origin);\n    // 같은 origin·같은 경로로의 redirect 는 무한 루프 — 통과시킨다. matchRedirect\n    // 의 순수 루프 가드가 못 잡는 절대 URL(같은 origin) 자기참조까지 여기서 차단.\n    if (\n      dest.origin === origin &&\n      normalizeRedirectPath(dest.pathname) === normalizeRedirectPath(pathname)\n    ) {\n      return null;\n    }\n    return Response.redirect(dest.toString(), hit.statusCode);\n  };\n}\n"],"mappings":"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","names":["resolvePostCollection","resolvePostUrl","resolvePostCollection","resolvePostUrl","postEntries","categoryEntries","isInCollectionMode","resolvePostUrl","isInCollectionMode","resolvePostUrl","isInCollectionMode","isInCollectionMode"]}
+{"version":3,"sources":["../src/routes.ts","../src/routes-shared.ts","../src/routes-feed-sitemap.ts","../src/routes-llms.ts","../src/routes-revalidate.ts","../src/routes-og.ts","../src/routes-redirects.ts","../src/routes-metadata.ts"],"sourcesContent":["/**\n * `@roottale/cms-renderer-next/routes` — Next.js App Router 통합 라우트 팩토리.\n *\n * 외부 고객사 사이트가 매번 직접 작성하던 공통 라우트(RSS feed / sitemap /\n * revalidate webhook / llms.txt / OG 이미지)를 1줄 팩토리로 표준화. 블로그 조회와\n * *동일한* 단일 customer API key(`ROOTTALE_API_KEY`)를 사용한다.\n *\n * 설계 원칙:\n * - feed/sitemap/llms 는 fetch 실패를 swallow → 라우트가 *항상 200*.\n * - revalidate 는 서명 webhook 을 검증하고 본문 paths + 파생 경로를 revalidate.\n * - `next` 에 직접 의존하지 않음(revalidate 콜백·ImageResponse 주입).\n *\n * 구현은 `routes-*.ts` 모듈로 분리되어 있고 본 파일은 공개 배럴이다(파일당 ≤400줄).\n * 사용 예는 roottale-docs `services/external-site-integration.md` 참조.\n */\n\nimport { CMS_CLIENT_VERSION } from \"@roottale/cms-client/server\";\n\nimport { trimSlash } from \"./routes-shared.js\";\n\n// ── 공개 표면 배럴 (모듈별 구현 re-export) ───────────────────────────────────\nexport * from \"./routes-shared.js\";\nexport * from \"./routes-feed-sitemap.js\";\nexport * from \"./routes-llms.js\";\nexport * from \"./routes-revalidate.js\";\nexport * from \"./routes-og.js\";\n// 커스텀 리다이렉트 미들웨어 (WP RankMath Redirections 패리티).\nexport * from \"./routes-redirects.js\";\n// 글 메타데이터 빌더 (canonical/robots/og 1줄 — 어드민 SEO 패널 반영).\nexport * from \"./routes-metadata.js\";\n\n// ── slug 변경 301 (WP permalink 패리티) ─────────────────────────────────────\n\n/**\n * 옛 slug → 현재 slug 301 redirect 판단 (순수 함수, `next` 비의존).\n *\n * Public API 는 slug 변경 후에도 옛 slug 로 글을 찾아 *현재* slug 를 응답한다\n * (post_slug_history fallback). 요청 slug 와 응답 slug 가 다르면 새 경로를\n * 반환 — 페이지에서 `permanentRedirect()` 로 301 처리한다:\n *\n * ```ts\n * import { permanentRedirect, notFound } from \"next/navigation\";\n * import { postRedirectPath } from \"@roottale/cms-renderer-next/routes\";\n *\n * const post = await getPost(slug);\n * if (!post) notFound();\n * const redirect = postRedirectPath(post, slug);\n * if (redirect) permanentRedirect(redirect);\n * ```\n *\n * Next App Router 의 `params` 는 percent-encoding 된 채 들어올 수 있어\n * (한글 slug) 디코딩 후 비교한다. redirect 가 불필요하면 null.\n */\nexport function postRedirectPath(\n  post: { slug: string },\n  requestedSlug: string,\n  blogBasePath = \"/blog\",\n): string | null {\n  let requested = requestedSlug;\n  try {\n    requested = decodeURIComponent(requestedSlug);\n  } catch {\n    /* 잘못된 escape — 원본 그대로 비교 */\n  }\n  if (post.slug === requested) return null;\n  // blogBasePath \"/\" 또는 \"\" = 루트 배치 → \"/{slug}\".\n  return `${trimSlash(blogBasePath)}/${encodeURIComponent(post.slug)}`;\n}\n\n// ── fleet well-known (사이트 버전 노출 컨벤션) ───────────────────────────────\n\ndeclare const __CMS_RENDERER_VERSION__: string | undefined;\n\nexport interface FleetInfoRouteConfig {\n  /** 사이트 식별 라벨 (선택 — 기본 Vercel project URL 또는 null). */\n  site?: string;\n}\n\n/**\n * `GET /.well-known/roottale.json` — fleet 가시성 컨벤션 라우트.\n *\n * 플랫폼 internal fleet API 의 `?probe=1` 이 본 엔드포인트를 읽어 \"배포된\"\n * 패키지 버전을 트래픽 없이도 확인한다 (런타임 check-in 의 보조 신호).\n * 노출은 의도적으로 최소: 패키지 버전 + 짧은 build sha — 비밀 없음.\n *\n * 사용 (Next App Router):\n * ```ts\n * // app/.well-known/roottale.json/route.ts\n * import { createFleetInfoRoute } from \"@roottale/cms-renderer-next/routes\";\n * export const GET = createFleetInfoRoute();\n * ```\n */\nexport function createFleetInfoRoute(\n  config: FleetInfoRouteConfig = {},\n): () => Promise<Response> {\n  // dts 빌드는 node types 없이 돈다 — process 는 globalThis 경유로 안전 접근.\n  const env =\n    (globalThis as { process?: { env?: Record<string, string | undefined> } })\n      .process?.env ?? {};\n  return async function GET(): Promise<Response> {\n    return Response.json(\n      {\n        site: config.site ?? env.VERCEL_PROJECT_PRODUCTION_URL ?? null,\n        framework: \"next\",\n        cms_client: CMS_CLIENT_VERSION,\n        cms_renderer:\n          typeof __CMS_RENDERER_VERSION__ === \"string\"\n            ? __CMS_RENDERER_VERSION__\n            : \"dev\",\n        build_sha: env.VERCEL_GIT_COMMIT_SHA?.slice(0, 7) ?? null,\n      },\n      { headers: { \"cache-control\": \"public, max-age=300\" } },\n    );\n  };\n}\n","/**\n * `routes` 공통 — config 타입, collections resolve, fetch 헬퍼. feed/sitemap/llms/\n * revalidate/og 모듈이 공유한다(순환 import 회피). 공개 표면은 `routes.ts` 배럴.\n */\n\nimport { fetchPosts, type CmsPostContent } from \"@roottale/cms-client/server\";\nimport type { RouteCollection } from \"@roottale/cms-core\";\n\nexport type { RouteCollection };\n// 소비자 가드용 재export (`/blog/[slug]` 에서 스트림 누출 차단 등) — ADR-0060.\nexport { resolvePostCollection, resolvePostUrl } from \"@roottale/cms-core\";\n\nexport interface RootTaleSiteConfig {\n  /** `rtlk_cust_*` — 블로그 조회와 같은 키. 서버에서만(절대 브라우저 금지). */\n  apiKey: string;\n  /** API base 오버라이드. 기본 `https://api.roottale.com`. */\n  apiBase?: string;\n  /** 사이트 절대 URL (뒤 슬래시 없이). 예: `https://kjmtax.roottale.app`. */\n  siteUrl: string;\n  /** 피드/사이트 제목. */\n  title: string;\n  description?: string;\n  /** 기본 \"ko-KR\". */\n  language?: string;\n  /** 블로그 base path. 기본 \"/blog\". 레거시 단일 스트림 — `collections` 미사용 시. */\n  blogBasePath?: string;\n  /**\n   * 다중 스트림 라우팅 (ADR-0060). **길이 > 0 이면 collection 모드** — feed/sitemap/\n   * llms.txt 가 글을 소속 스트림 basePath 로 라우팅하고, 어느 스트림에도 안 속한 글은\n   * 제외한다. 비우거나 미전달 = 레거시 단일 `blogBasePath`(/blog) 동작(하위호환).\n   * 선언 순서 = 우선순위(first-wins).\n   *\n   * 배열 또는 **async resolver**(`() => Promise<RouteCollection[]>`)를 받는다 — 후자는\n   * 사이트가 `@roottale/cms-client` `fetchCollections()` 로 admin 설정을 가져올 때 쓴다.\n   * resolver 가 throw 하면 fail-soft(레거시 단일 /blog).\n   */\n  collections?: CollectionsInput;\n}\n\n/** collections 입력 — 정적 배열 또는 async resolver(admin 설정 fetch 용). */\nexport type CollectionsInput =\n  | RouteCollection[]\n  | (() => RouteCollection[] | Promise<RouteCollection[]>);\n\n/** resolve 결과 — `failed` 로 \"resolver throw\" 를 \"collections 미설정\" 과 구분한다. */\nexport async function resolveCollectionsResult(\n  input: CollectionsInput | undefined,\n): Promise<{ collections: RouteCollection[] | undefined; failed: boolean }> {\n  if (typeof input === \"function\") {\n    try {\n      return { collections: await input(), failed: false };\n    } catch (err) {\n      console.error(\n        \"[@roottale/cms-renderer-next/routes] collections resolver 실패:\",\n        err,\n      );\n      return { collections: undefined, failed: true };\n    }\n  }\n  return { collections: input, failed: false };\n}\n\n/**\n * resolver 면 호출(실패 시 undefined → 레거시), 배열이면 그대로. GET 팩토리(feed/\n * sitemap/llms)는 always-200 철학상 실패를 레거시 /blog 로 흡수 — revalidate 만\n * `resolveCollectionsResult` 로 실패를 구분해 under-invalidation 을 막는다.\n */\nexport async function resolveCollections(\n  input: CollectionsInput | undefined,\n): Promise<RouteCollection[] | undefined> {\n  return (await resolveCollectionsResult(input)).collections;\n}\n\nexport function trimSlash(u: string): string {\n  return u.replace(/\\/+$/, \"\");\n}\n\nexport async function safeFetchPosts(\n  config: RootTaleSiteConfig,\n  limit: number,\n): Promise<CmsPostContent[]> {\n  try {\n    const page = await fetchPosts({\n      apiKey: config.apiKey,\n      baseUrl: config.apiBase,\n      type: \"post\",\n      limit,\n    });\n    return page.items;\n  } catch (err) {\n    // 빌드/런타임 fetch 실패 시 빈 목록 — 라우트는 항상 정상 응답(404 방지).\n    console.error(\"[@roottale/cms-renderer-next/routes] fetchPosts 실패:\", err);\n    return [];\n  }\n}\n","/** `routes` — RSS feed + sitemap 팩토리. collection 모드/레거시 양쪽. */\n\nimport { generateRssXml, rssItemsFromPosts } from \"@roottale/cms-client/server\";\nimport {\n  isInCollectionMode,\n  resolvePostCollection,\n  resolvePostUrl,\n} from \"@roottale/cms-core\";\n\nimport { collectCategories, collectCollectionCategories } from \"./blog-filter.js\";\nimport {\n  type RootTaleSiteConfig,\n  resolveCollections,\n  safeFetchPosts,\n  trimSlash,\n} from \"./routes-shared.js\";\n\n/**\n * `app/feed.xml/route.ts` 용 GET 핸들러. RSS 2.0.\n *\n * ```ts\n * import { createFeedRoute } from \"@roottale/cms-renderer-next/routes\";\n * export const dynamic = \"force-dynamic\";\n * export const GET = createFeedRoute({\n *   apiKey: process.env.ROOTTALE_API_KEY!,\n *   siteUrl: \"https://example.com\",\n *   title: \"Example 블로그\",\n *   description: \"...\",\n * });\n * ```\n */\nexport function createFeedRoute(\n  config: RootTaleSiteConfig,\n): () => Promise<Response> {\n  return async function GET(): Promise<Response> {\n    const siteUrl = trimSlash(config.siteUrl);\n    const collections = await resolveCollections(config.collections);\n    const allPosts = await safeFetchPosts(config, 50);\n\n    // collection 모드: /feed.xml = `feed:true` 스트림들의 합집합(aggregate). RSS\n    // 리더는 안정적 사이트 피드를 기대하므로 스트림별 분리 대신 통합 피드(codex).\n    // 각 글 링크는 소속 스트림 basePath 로. 레거시: 단일 blogBasePath.\n    const inCollectionMode = isInCollectionMode(collections);\n    const blogBase = config.blogBasePath ?? \"/blog\";\n    const posts = inCollectionMode\n      ? allPosts.filter((p) => {\n          const c = resolvePostCollection(p, collections!);\n          return c ? c.feed === true : false;\n        })\n      : allPosts;\n\n    const xml = generateRssXml({\n      title: config.title,\n      link: inCollectionMode ? siteUrl : `${siteUrl}${blogBase}`,\n      feedUrl: `${siteUrl}/feed.xml`,\n      description: config.description,\n      language: config.language,\n      items: rssItemsFromPosts(posts, {\n        postUrl: (p) =>\n          inCollectionMode\n            ? (resolvePostUrl(siteUrl, p, collections!) ?? `${siteUrl}${blogBase}/${p.slug}`)\n            : `${siteUrl}${blogBase}/${p.slug}`,\n      }),\n    });\n    return new Response(xml, {\n      headers: {\n        \"content-type\": \"application/rss+xml; charset=utf-8\",\n        \"cache-control\": \"public, max-age=1800, s-maxage=1800\",\n      },\n    });\n  };\n}\n\n/** Next `MetadataRoute.Sitemap[number]` 와 구조 호환(타입 결합 회피). */\nexport interface SitemapEntry {\n  url: string;\n  lastModified?: string | Date;\n  changeFrequency?:\n    | \"always\"\n    | \"hourly\"\n    | \"daily\"\n    | \"weekly\"\n    | \"monthly\"\n    | \"yearly\"\n    | \"never\";\n  priority?: number;\n}\n\n/**\n * `app/sitemap.ts` default export. 정적 경로 + 글 경로를 합친다.\n *\n * ```ts\n * import { createSitemap } from \"@roottale/cms-renderer-next/routes\";\n * export default createSitemap(\n *   { apiKey: process.env.ROOTTALE_API_KEY!, siteUrl: \"https://example.com\", title: \"...\" },\n *   [{ url: \"https://example.com\", changeFrequency: \"weekly\", priority: 1 }],\n * );\n * ```\n */\nexport function createSitemap(\n  config: RootTaleSiteConfig,\n  staticRoutes: SitemapEntry[] = [],\n): () => Promise<SitemapEntry[]> {\n  return async function sitemap(): Promise<SitemapEntry[]> {\n    const siteUrl = trimSlash(config.siteUrl);\n    const blogBase = config.blogBasePath ?? \"/blog\";\n    const collections = await resolveCollections(config.collections);\n    const posts = await safeFetchPosts(config, 200);\n\n    if (isInCollectionMode(collections)) {\n      // 글마다 소속 스트림 basePath 로(공지→/notice, 블로그→/blog). 어느 스트림에도\n      // 안 속한 글(상세 라우트 없음)은 제외. 아카이브는 `archives:true` 스트림만.\n      const postEntries: SitemapEntry[] = posts.flatMap((p) => {\n        const url = resolvePostUrl(siteUrl, p, collections!);\n        if (!url) return [];\n        return [\n          {\n            url,\n            lastModified: p.updatedAt ?? p.publishedAt ?? undefined,\n            changeFrequency: \"weekly\" as const,\n            priority: 0.6,\n          },\n        ];\n      });\n\n      const categoryEntries: SitemapEntry[] = collections!\n        .filter((c) => c.archives)\n        .flatMap((c) => {\n          const cats = collectCollectionCategories(posts, collections!, c.key);\n          if (!cats.length) return [];\n          const base = `${siteUrl}${trimSlash(c.basePath)}`;\n          return [\n            { url: `${base}/categories`, changeFrequency: \"weekly\" as const, priority: 0.5 },\n            ...cats.map((category) => ({\n              url: `${base}/categories/${category.slug}`,\n              changeFrequency: \"weekly\" as const,\n              priority: 0.5,\n            })),\n          ];\n        });\n\n      return [...staticRoutes, ...postEntries, ...categoryEntries];\n    }\n\n    // 레거시: 단일 blogBasePath.\n    const postEntries: SitemapEntry[] = posts.map((p) => ({\n      url: `${siteUrl}${blogBase}/${p.slug}`,\n      lastModified: p.updatedAt ?? p.publishedAt ?? undefined,\n      changeFrequency: \"weekly\",\n      priority: 0.6,\n    }));\n    const categories = collectCategories(posts);\n    const categoryEntries: SitemapEntry[] = categories.length\n      ? [\n          {\n            url: `${siteUrl}${blogBase}/categories`,\n            changeFrequency: \"weekly\",\n            priority: 0.5,\n          },\n          ...categories.map((category) => ({\n            url: `${siteUrl}${blogBase}/categories/${category.slug}`,\n            changeFrequency: \"weekly\" as const,\n            priority: 0.5,\n          })),\n        ]\n      : [];\n    return [...staticRoutes, ...postEntries, ...categoryEntries];\n  };\n}\n","/** `routes` — llms.txt (AEO/GEO, AI 검색·생성엔진용 마크다운 인덱스). */\n\nimport { isInCollectionMode, resolvePostUrl } from \"@roottale/cms-core\";\n\nimport {\n  type RootTaleSiteConfig,\n  resolveCollections,\n  safeFetchPosts,\n  trimSlash,\n} from \"./routes-shared.js\";\n\n/** llms.txt 정적 섹션의 링크 1개. */\nexport interface LlmsTxtLink {\n  title: string;\n  url: string;\n  /** 링크 뒤 \": {note}\" 로 붙는 한 줄 설명 (선택). */\n  note?: string;\n}\n\n/** llms.txt 의 정적 페이지 링크 그룹 — 블로그 목록 앞에 출력. */\nexport interface LlmsTxtSection {\n  title: string;\n  links: LlmsTxtLink[];\n}\n\nexport type LlmsTxtRouteConfig = RootTaleSiteConfig & {\n  /** (선택) 서비스 소개 등 정적 페이지 링크 그룹. */\n  sections?: LlmsTxtSection[];\n};\n\n/** 마크다운 링크 텍스트를 깨뜨리는 문자([, ], (, )) 제거. */\nfunction mdLinkSafe(text: string): string {\n  return text.replace(/[[\\]()]/g, \"\").trim();\n}\n\n/** excerpt 를 1줄로 — 개행·연속 공백을 공백 1개로 정리 후 200자 절단. */\nfunction oneLine(text: string): string {\n  return text.replace(/\\s+/g, \" \").trim().slice(0, 200);\n}\n\n/**\n * `app/llms.txt/route.ts` 용 GET 핸들러 — AEO/GEO(AI 검색·생성엔진 최적화).\n *\n * AI 크롤러(ChatGPT/Claude/Perplexity 등)가 사이트 구조·콘텐츠를 빠르게\n * 파악하도록 llms.txt 스펙(https://llmstxt.org)의 마크다운 인덱스를 제공한다.\n * 발행 글 최대 100개를 \"## 블로그\" 섹션으로 자동 포함 — feed/sitemap 처럼\n * fetch 실패도 swallow 하여 *항상 200* (헤더 부분만 출력).\n *\n * ```ts\n * import { createLlmsTxtRoute } from \"@roottale/cms-renderer-next/routes\";\n * export const dynamic = \"force-dynamic\";\n * export const GET = createLlmsTxtRoute({\n *   apiKey: process.env.ROOTTALE_API_KEY!,\n *   siteUrl: \"https://example.com\",\n *   title: \"Example\",\n *   description: \"...\",\n *   sections: [{ title: \"주요 페이지\", links: [{ title: \"서비스\", url: \"https://example.com/services\" }] }],\n * });\n * ```\n */\nexport function createLlmsTxtRoute(\n  config: LlmsTxtRouteConfig,\n): () => Promise<Response> {\n  return async function GET(): Promise<Response> {\n    const siteUrl = trimSlash(config.siteUrl);\n    const blogBase = config.blogBasePath ?? \"/blog\";\n    const collections = await resolveCollections(config.collections);\n    const posts = await safeFetchPosts(config, 100);\n\n    const lines: string[] = [`# ${config.title}`];\n    if (config.description) {\n      lines.push(\"\", `> ${oneLine(config.description)}`);\n    }\n    for (const section of config.sections ?? []) {\n      lines.push(\"\", `## ${section.title}`);\n      for (const link of section.links) {\n        const note = link.note ? `: ${oneLine(link.note)}` : \"\";\n        lines.push(`- [${mdLinkSafe(link.title)}](${link.url})${note}`);\n      }\n    }\n    if (posts.length > 0) {\n      const inCollectionMode = isInCollectionMode(collections);\n      // 레거시 헤딩(\"## 블로그\")은 하위호환 유지, 다중 스트림은 \"## 콘텐츠\".\n      lines.push(\"\", inCollectionMode ? \"## 콘텐츠\" : \"## 블로그\");\n      for (const p of posts) {\n        // collection 모드: 소속 스트림 URL, 미소속 글 제외. 레거시: 단일 blogBase.\n        const url = inCollectionMode\n          ? resolvePostUrl(siteUrl, p, collections!)\n          : `${siteUrl}${blogBase}/${p.slug}`;\n        if (!url) continue;\n        const excerpt = p.excerpt ? `: ${oneLine(p.excerpt)}` : \"\";\n        lines.push(`- [${mdLinkSafe(p.title)}](${url})${excerpt}`);\n      }\n    }\n    lines.push(\"\");\n\n    return new Response(lines.join(\"\\n\"), {\n      headers: {\n        \"content-type\": \"text/plain; charset=utf-8\",\n        // feed 와 동일한 30분 캐시 — webhook alsoRevalidate 로 즉시 갱신됨.\n        \"cache-control\": \"public, max-age=1800, s-maxage=1800\",\n      },\n    });\n  };\n}\n","/** `routes` — revalidate webhook 핸들러 (서명 검증 + 파생 경로 재검증). */\n\nimport {\n  verifyRootTaleWebhook,\n  type VerifyRootTaleWebhookResult,\n} from \"@roottale/cms-client/webhook\";\nimport { isInCollectionMode } from \"@roottale/cms-core\";\n\nimport { type CollectionsInput, resolveCollectionsResult } from \"./routes-shared.js\";\n\nexport interface RevalidateRouteConfig {\n  /** `rtlk_cust_*` — 블로그 조회/webhook 검증 공통 키. */\n  apiKey: string;\n  apiBase?: string;\n  /** Next 의 `revalidatePath` (또는 동등 콜백) 주입. */\n  revalidate: (path: string) => void | Promise<void>;\n  /** 블로그 base path. 기본 \"/blog\". */\n  blogBasePath?: string;\n  /**\n   * 다중 스트림 (ADR-0060). 지정 시 `alsoRevalidate` 기본값을 각 스트림 basePath\n   * (+ `archives:true` 면 `${basePath}/categories`)로 파생. 미지정 = 레거시 단일 blog.\n   * 배열 또는 async resolver(`fetchCollections()`) — resolver 실패 시 레거시로 fail-soft.\n   */\n  collections?: CollectionsInput;\n  /**\n   * 모든 글/분류/미디어 변경에 대해 *항상 함께* revalidate 할 파생 경로.\n   * 피드·사이트맵·블로그 인덱스처럼 \"글 목록\"에 의존하는 경로 — admin 변경이\n   * 자동 반영되려면 필수. 명시 시 collections 파생을 덮어쓴다.\n   * 기본(레거시): [\"/feed.xml\", \"/sitemap.xml\", \"/llms.txt\", blogBase, `${blogBase}/categories`].\n   */\n  alsoRevalidate?: string[];\n  /** (옵션) jti replay 방지 hook (cms-client verify 로 전달). */\n  consumeJti?: (jti: string, exp: number) => Promise<\"new\" | \"seen\">;\n}\n\n/** webhook 본문에서 paths[] 추출(서명 검증 후 호출 — body_hash 가 binding). */\nfunction pathsFromBody(rawBody: string): string[] {\n  try {\n    const body = JSON.parse(rawBody) as { paths?: unknown };\n    if (Array.isArray(body.paths)) {\n      return body.paths.filter((p): p is string => typeof p === \"string\");\n    }\n  } catch {\n    /* 비-JSON 본문 — 파생 경로만 revalidate */\n  }\n  return [];\n}\n\n/**\n * `app/api/revalidate/route.ts` 용 POST 핸들러.\n *\n * admin(mysite.roottale.com)이 글/카테고리/미디어 변경 시 보내는 서명 webhook 을\n * 검증하고, 본문 paths + 파생 경로(feed·sitemap·블로그 인덱스)를 revalidate.\n *\n * ```ts\n * import { revalidatePath } from \"next/cache\";\n * import { createRevalidateRoute } from \"@roottale/cms-renderer-next/routes\";\n * export const POST = createRevalidateRoute({\n *   apiKey: process.env.ROOTTALE_API_KEY!,\n *   revalidate: revalidatePath,\n * });\n * ```\n */\nexport function createRevalidateRoute(\n  config: RevalidateRouteConfig,\n): (req: Request) => Promise<Response> {\n  const blogBase = config.blogBasePath ?? \"/blog\";\n\n  return async function POST(req: Request): Promise<Response> {\n    const rawBody = await req.text();\n    const result: VerifyRootTaleWebhookResult = await verifyRootTaleWebhook({\n      rawBody,\n      headers: req.headers,\n      apiKey: config.apiKey,\n      apiBase: config.apiBase,\n      consumeJti: config.consumeJti,\n    });\n    if (!result.ok) {\n      return Response.json({ ok: false, reason: result.reason }, { status: 401 });\n    }\n\n    // 글 목록 의존 경로. 명시 alsoRevalidate 가 있으면 collections 를 resolve 하지 않는다\n    // (불필요한 fetch/지연 방지 — codex#1). 없으면 요청 시 resolve 해 파생.\n    // 항상 갱신하는 불변 경로 — feed/sitemap/llms 는 글 목록에 의존.\n    const INVARIANTS = [\"/feed.xml\", \"/sitemap.xml\", \"/llms.txt\"];\n    let alsoRevalidate: string[];\n    let warning: string | undefined;\n    if (config.alsoRevalidate) {\n      alsoRevalidate = config.alsoRevalidate;\n    } else {\n      const { collections, failed } = await resolveCollectionsResult(config.collections);\n      if (failed) {\n        // resolver 실패: 스트림을 추측하지 않는다(잘못된 /blog 무효화 방지 — codex#2).\n        // 불변 경로 + 본문 paths 만 갱신하고, 플랫폼이 재시도/알림하도록 warning 노출.\n        alsoRevalidate = INVARIANTS;\n        warning = \"collections_resolve_failed\";\n      } else if (isInCollectionMode(collections)) {\n        alsoRevalidate = [\n          ...INVARIANTS,\n          ...collections!.flatMap((c) =>\n            c.archives ? [c.basePath, `${c.basePath}/categories`] : [c.basePath],\n          ),\n        ];\n      } else {\n        alsoRevalidate = [...INVARIANTS, blogBase, `${blogBase}/categories`];\n      }\n    }\n\n    // 본문 paths + 파생 경로(항상) — 중복 제거.\n    const paths = [...new Set([...pathsFromBody(rawBody), ...alsoRevalidate])];\n    for (const p of paths) {\n      await config.revalidate(p);\n    }\n\n    return Response.json({\n      ok: true,\n      event: result.event,\n      deliveryId: result.deliveryId,\n      revalidated: paths,\n      ...(warning ? { warning } : {}),\n    });\n  };\n}\n","/** `routes` — 동적 OG 이미지 (글별 1200×630, 한글 폰트 subset). */\n\nimport { fetchPost } from \"@roottale/cms-client/server\";\n\nimport { type RootTaleSiteConfig, trimSlash } from \"./routes-shared.js\";\n\n/** Next `opengraph-image` export 컨벤션과 호환되는 크기 상수. */\nexport const OG_IMAGE_SIZE = { width: 1200, height: 630 } as const;\nexport const OG_IMAGE_CONTENT_TYPE = \"image/png\";\n\nexport interface OgImageRouteConfig extends RootTaleSiteConfig {\n  /** 배경색. 기본 진네이비 그라데이션 베이스. */\n  backgroundColor?: string;\n  /** 본문 텍스트 색. 기본 흰색. */\n  foregroundColor?: string;\n  /** 상단 액센트 바 + 브랜드 라벨 색. 기본 하늘색. */\n  accentColor?: string;\n  /** 하단 브랜드 라벨. 기본 = `title`. */\n  brandLabel?: string;\n}\n\n/** `next/og` 의 ImageResponse 와 구조 호환(직접 의존 회피 — revalidate 콜백 주입과 동일 원칙). */\nexport interface ImageResponseLike {\n  new (\n    element: unknown,\n    options?: {\n      width?: number;\n      height?: number;\n      fonts?: { name: string; data: ArrayBuffer; weight?: number; style?: \"normal\" }[];\n    },\n  ): Response;\n}\n\n/**\n * 제목에 쓰인 글자만 부분셋(subset)으로 받아 한글을 렌더 — satori 기본 폰트는\n * 한글 글리프가 없다. 구형 UA 로 css2 를 호출하면 TTF(satori 호환) URL 을 준다.\n * 실패 시 null — 폰트 없이도 이미지는 생성(라틴 fallback).\n */\nasync function loadKoreanFontSubset(text: string): Promise<ArrayBuffer | null> {\n  try {\n    const unique = Array.from(new Set(Array.from(text))).join(\"\");\n    const cssUrl = `https://fonts.googleapis.com/css2?family=Noto+Sans+KR:wght@700&text=${encodeURIComponent(unique)}`;\n    const cssRes = await fetch(cssUrl, {\n      headers: { \"user-agent\": \"Mozilla/5.0 (Windows NT 6.1; rv:10.0)\" },\n    });\n    if (!cssRes.ok) return null;\n    const css = await cssRes.text();\n    const match = css.match(\n      /src:\\s*url\\(([^)]+)\\)\\s*format\\(['\"](?:truetype|opentype)['\"]\\)/,\n    );\n    if (!match?.[1]) return null;\n    const fontRes = await fetch(match[1]);\n    if (!fontRes.ok) return null;\n    return await fontRes.arrayBuffer();\n  } catch (err) {\n    console.error(\"[@roottale/cms-renderer-next/routes] OG 폰트 로딩 실패:\", err);\n    return null;\n  }\n}\n\n/**\n * `app/blog/[slug]/opengraph-image.tsx` 용 동적 OG 이미지 (1200×630).\n *\n * `next/og` 의 ImageResponse 를 주입받는다 — 본 패키지는 `next` 에 직접\n * 의존하지 않는다. 글이 없거나 fetch 실패면 사이트 제목만으로 fail-soft 렌더\n * (소셜 크롤러에 빈 카드 대신 브랜드 카드).\n *\n * ```tsx\n * // app/blog/[slug]/opengraph-image.tsx\n * import { ImageResponse } from \"next/og\";\n * import {\n *   createPostOgImage,\n *   OG_IMAGE_SIZE,\n *   OG_IMAGE_CONTENT_TYPE,\n * } from \"@roottale/cms-renderer-next/routes\";\n * import { roottale } from \"@/lib/roottale\"; // RootTaleSiteConfig\n *\n * export const size = OG_IMAGE_SIZE;\n * export const contentType = OG_IMAGE_CONTENT_TYPE;\n * export default createPostOgImage(roottale, { ImageResponse });\n * ```\n */\nexport function createPostOgImage(\n  config: OgImageRouteConfig,\n  deps: { ImageResponse: ImageResponseLike },\n): (props: { params: Promise<{ slug: string }> | { slug: string } }) => Promise<Response> {\n  const background = config.backgroundColor ?? \"#10172a\";\n  const foreground = config.foregroundColor ?? \"#f8fafc\";\n  const accent = config.accentColor ?? \"#38bdf8\";\n  const brand = config.brandLabel ?? config.title;\n\n  return async function OgImage(props): Promise<Response> {\n    const { slug } = await props.params;\n\n    let title = config.title;\n    let dateLabel: string | null = null;\n    try {\n      const post = await fetchPost({\n        apiKey: config.apiKey,\n        baseUrl: config.apiBase,\n        slugOrId: slug,\n      });\n      if (post) {\n        title = post.title;\n        dateLabel = new Intl.DateTimeFormat(\"ko-KR\", { dateStyle: \"long\" }).format(\n          new Date(post.publishedAt),\n        );\n      }\n    } catch (err) {\n      console.error(\"[@roottale/cms-renderer-next/routes] OG fetchPost 실패:\", err);\n    }\n\n    // satori 줄바꿈에 맡기되 3줄을 넘는 초장문 제목만 자른다.\n    const display = title.length > 64 ? `${title.slice(0, 63)}…` : title;\n    const fontData = await loadKoreanFontSubset(`${display}${brand}${dateLabel ?? \"\"}`);\n\n    const { createElement: h } = await import(\"react\");\n    const element = h(\n      \"div\",\n      {\n        style: {\n          width: \"100%\",\n          height: \"100%\",\n          display: \"flex\",\n          flexDirection: \"column\",\n          justifyContent: \"space-between\",\n          padding: \"72px 80px\",\n          backgroundColor: background,\n          backgroundImage: `linear-gradient(135deg, ${background} 60%, rgba(56,189,248,0.25))`,\n          color: foreground,\n          fontFamily: fontData ? \"NotoSansKR\" : \"sans-serif\",\n        },\n      },\n      h(\"div\", {\n        style: { width: 96, height: 10, backgroundColor: accent, borderRadius: 5 },\n      }),\n      h(\n        \"div\",\n        {\n          style: {\n            display: \"flex\",\n            fontSize: display.length > 36 ? 56 : 68,\n            fontWeight: 700,\n            lineHeight: 1.25,\n            letterSpacing: \"-0.02em\",\n            wordBreak: \"keep-all\",\n          },\n        },\n        display,\n      ),\n      h(\n        \"div\",\n        {\n          style: {\n            display: \"flex\",\n            justifyContent: \"space-between\",\n            alignItems: \"center\",\n            fontSize: 28,\n          },\n        },\n        h(\"div\", { style: { display: \"flex\", color: accent, fontWeight: 700 } }, brand),\n        h(\n          \"div\",\n          { style: { display: \"flex\", color: \"rgba(248,250,252,0.72)\" } },\n          dateLabel ?? trimSlash(config.siteUrl).replace(/^https?:\\/\\//, \"\"),\n        ),\n      ),\n    );\n\n    return new deps.ImageResponse(element, {\n      width: OG_IMAGE_SIZE.width,\n      height: OG_IMAGE_SIZE.height,\n      ...(fontData\n        ? { fonts: [{ name: \"NotoSansKR\", data: fontData, weight: 700 as const, style: \"normal\" as const }] }\n        : {}),\n    });\n  };\n}\n","/**\n * 커스텀 리다이렉트 미들웨어 — 고객 Next 앱의 `middleware.ts` 에서 마운트.\n *\n * admin \"설정 > 주소 이동\" 에서 정의한 임의 경로 규칙(`/old → /new`)을 공개\n * API(`GET /v1/cms/public/redirects`)로 읽어 요청 경로에 매칭, 301/302 를\n * 발행한다. 슬러그 301(`postRedirectPath`)이 글 라우트에서 도는 것과 달리,\n * 임의 경로는 라우팅 *이전* 단계인 middleware 에서만 가로챌 수 있다.\n *\n * `next` 에 직접 의존하지 않는다(패키지 정책): 입력은 표준 `Request`(NextRequest\n * 가 상속), 출력은 표준 `Response`(NextResponse 가 상속)다.\n *\n * 사용 (Next App Router):\n * ```ts\n * // middleware.ts\n * import { NextResponse } from \"next/server\";\n * import { createRedirectMiddleware } from \"@roottale/cms-renderer-next/routes\";\n *\n * const redirects = createRedirectMiddleware({\n *   apiKey: process.env.ROOTTALE_API_KEY!,\n * });\n *\n * export async function middleware(req: Request) {\n *   return (await redirects(req)) ?? NextResponse.next();\n * }\n *\n * // Next 내부·정적 자산만 제외. `.*\\\\..*` 처럼 점 포함 경로를 전부 막으면\n * // `/old.html`·`/foo.php` 같은 레거시 마이그레이션 리다이렉트가 동작하지\n * // 않으므로, 알려진 자산 확장자만 제외한다.\n * export const config = {\n *   matcher: [\n *     \"/((?!_next/|api/|.*\\\\.(?:ico|png|jpg|jpeg|gif|svg|webp|css|js|txt|xml|json|woff2?|map)$).*)\",\n *   ],\n * };\n * ```\n */\n\nimport { fetchRedirects } from \"@roottale/cms-client/server\";\nimport type { RootTaleRedirect } from \"@roottale/cms-client/server\";\n\nexport interface RedirectMiddlewareConfig {\n  /** `rtlk_cust_*` — 블로그 조회와 같은 키. 서버에서만. */\n  apiKey: string;\n  /** API base 오버라이드. 기본 `https://api.roottale.com`. */\n  apiBase?: string;\n  /** site_id 명시(멀티사이트 키). 기본 = 키의 기본 사이트. */\n  siteId?: string;\n  /** 규칙 캐시 TTL(ms). 기본 60_000 (1분). */\n  cacheTtlMs?: number;\n}\n\n/**\n * 경로 정규화 — 앞 슬래시 보장, 뒤 슬래시 제거(루트 제외), 쿼리/해시 제거,\n * percent-decode. 출발 경로 비교·한글 slug 매칭·루프 탐지에 요청·규칙 양쪽에\n * 동일 적용한다. 쿼리 제거는 `/a → /a?x` 류의 무한 루프 방지에 중요.\n */\nexport function normalizeRedirectPath(path: string): string {\n  let p = path;\n  try {\n    p = decodeURIComponent(path);\n  } catch {\n    /* 잘못된 escape — 원본 유지 */\n  }\n  p = p.split(/[?#]/)[0] ?? p; // 쿼리·해시 제거\n  if (!p.startsWith(\"/\")) p = `/${p}`;\n  if (p.length > 1) p = p.replace(/\\/+$/, \"\");\n  return p === \"\" ? \"/\" : p;\n}\n\nfunction isAbsoluteUrl(target: string): boolean {\n  return /^https?:\\/\\//i.test(target);\n}\n\n/**\n * 요청 경로에 맞는 규칙을 찾는다(순수 함수, fetch 비의존 — 테스트 용이).\n * 정확 경로 일치만(와일드카드 없음).\n *\n * 내부 경로 체인을 따라가 최종 도착지를 한 번에 반환한다(`/a→/b→/c` ⇒ `/c`):\n * 리다이렉트 체인을 줄여 SEO·왕복을 개선하고, 한 호출 안에서의 무한 루프를\n * 막는다. 도착지가 출발지로 정규화되면(쿼리만 다른 경우 포함) 자기 루프로 보고\n * 매칭하지 않는다. 절대 URL 도착지는 체인 종단(다른 origin 위임). 상태 코드는\n * 실제 요청 경로에 매칭된 첫 규칙을 따른다. null = 해당 없음.\n */\nexport function matchRedirect(\n  redirects: readonly RootTaleRedirect[],\n  pathname: string,\n): { toTarget: string; statusCode: 301 | 302 } | null {\n  const byFrom = new Map<string, RootTaleRedirect>();\n  for (const r of redirects) {\n    const key = normalizeRedirectPath(r.fromPath);\n    if (!byFrom.has(key)) byFrom.set(key, r);\n  }\n\n  const start = normalizeRedirectPath(pathname);\n  const visited = new Set<string>([start]);\n  let current = start;\n  let finalTarget: string | null = null;\n  let firstStatus: 301 | 302 | null = null;\n\n  for (let hop = 0; hop < 10; hop++) {\n    const rule = byFrom.get(current);\n    if (!rule) break;\n    if (hop === 0) firstStatus = rule.statusCode;\n\n    if (isAbsoluteUrl(rule.toTarget)) {\n      finalTarget = rule.toTarget; // 절대 URL = 체인 종단\n      break;\n    }\n    const nextPath = normalizeRedirectPath(rule.toTarget);\n    if (nextPath === start) {\n      // 시작점으로 복귀 = 루프. 첫 홉이면 자기 루프(매칭 안 함), 아니면 직전\n      // finalTarget 까지만 적용해 한 호출 안에서의 무한 루프를 끊는다.\n      if (hop === 0) return null;\n      break;\n    }\n    finalTarget = rule.toTarget;\n    if (visited.has(nextPath)) break; // 사이클 — 현재까지로 종료\n    visited.add(nextPath);\n    current = nextPath;\n  }\n\n  if (finalTarget === null || firstStatus === null) return null;\n  return { toTarget: finalTarget, statusCode: firstStatus };\n}\n\ninterface CacheEntry {\n  expires: number;\n  value: RootTaleRedirect[];\n}\n\n/**\n * 미들웨어 팩토리. 규칙을 TTL 캐시하고(요청마다 API 호출 회피), fetch 실패는\n * swallow 해 트래픽을 절대 막지 않는다(stale 우선, 없으면 빈 목록 → 통과).\n *\n * 반환 함수: 매칭 시 redirect `Response`, 아니면 `null`(호출부가 통과 처리).\n */\nexport function createRedirectMiddleware(\n  config: RedirectMiddlewareConfig,\n): (request: Request) => Promise<Response | null> {\n  const ttl = config.cacheTtlMs ?? 60_000;\n  let cache: CacheEntry | null = null;\n\n  async function loadRedirects(now: number): Promise<RootTaleRedirect[]> {\n    if (cache && cache.expires > now) return cache.value;\n    try {\n      const value = await fetchRedirects({\n        apiKey: config.apiKey,\n        baseUrl: config.apiBase,\n        siteId: config.siteId,\n      });\n      cache = { expires: now + ttl, value };\n      return value;\n    } catch (err) {\n      console.error(\n        \"[@roottale/cms-renderer-next] fetchRedirects 실패 — 통과(fail-soft):\",\n        err,\n      );\n      // stale 값이 있으면 그것으로, 없으면 빈 목록. 짧게 재시도 억제.\n      if (cache) {\n        cache = { expires: now + Math.min(ttl, 10_000), value: cache.value };\n        return cache.value;\n      }\n      return [];\n    }\n  }\n\n  return async function redirectMiddleware(\n    request: Request,\n  ): Promise<Response | null> {\n    let pathname: string;\n    let origin: string;\n    try {\n      const u = new URL(request.url);\n      pathname = u.pathname;\n      origin = u.origin;\n    } catch {\n      return null;\n    }\n\n    // 캐시 키가 stable 한 시각 — Date.now 는 미들웨어 런타임에서 허용.\n    const now = Date.now();\n    const redirects = await loadRedirects(now);\n    const hit = matchRedirect(redirects, pathname);\n    if (!hit) return null;\n\n    // 내부 경로는 요청 origin 기준 절대화, 절대 URL 은 그대로.\n    const dest = new URL(hit.toTarget, origin);\n    // 같은 origin·같은 경로로의 redirect 는 무한 루프 — 통과시킨다. matchRedirect\n    // 의 순수 루프 가드가 못 잡는 절대 URL(같은 origin) 자기참조까지 여기서 차단.\n    if (\n      dest.origin === origin &&\n      normalizeRedirectPath(dest.pathname) === normalizeRedirectPath(pathname)\n    ) {\n      return null;\n    }\n    return Response.redirect(dest.toString(), hit.statusCode);\n  };\n}\n","/**\n * `@roottale/cms-renderer-next/routes` — 블로그 글 메타데이터 빌더.\n *\n * 어드민 SEO 패널(`metaJson.seo`) 값을 Next.js `Metadata` 형태로 1줄 변환한다.\n * 고객사 `app/blog/[slug]/page.tsx` 의 `generateMetadata` 에서 매번 직접 쓰던\n * canonical/robots/openGraph 분기 보일러플레이트를 표준화 — 한 곳이라도\n * 빠뜨려 SEO 가 새는 사고(noindex 누락·canonical 미설정)를 방지한다.\n *\n * 설계 원칙(패키지 공통): `next` 에 직접 의존하지 않는다. 반환은 Next `Metadata`\n * 의 구조적 부분집합인 plain 객체이므로, 소비자는 `generateMetadata` 에서 그대로\n * `return` 하면 된다.\n */\n\nimport { resolvePostPath, type RouteCollection } from \"@roottale/cms-core\";\n\nimport { trimSlash } from \"./routes-shared.js\";\n\n/** 어드민 SEO 패널 override (`metaJson.seo`). 전부 선택. */\nexport interface PostSeoOverrides {\n  /** 검색 제목 — 비면 글 제목 사용. */\n  title?: string;\n  /** 메타 설명 — 비면 글 요약 사용. */\n  description?: string;\n  /** 대표 URL. 비면 `siteUrl`+`path` 로 self-canonical 생성(옵션 제공 시). */\n  canonical?: string;\n  /** OG 이미지 — 비면 글 대표 이미지 사용. */\n  ogImage?: string;\n  /** 색인 제외. */\n  noindex?: boolean;\n  /** 링크 추적 제외. */\n  nofollow?: boolean;\n}\n\n/** `buildPostMetadata` 입력 — `BlogPostMeta`·원본 post 모두 구조적으로 호환. */\nexport interface PostMetadataInput {\n  /** 글 제목 (`seo.title` 없을 때 fallback). */\n  title: string;\n  /** 글 요약/설명 (`seo.description` 없을 때 fallback). */\n  description?: string | null;\n  /** 발행 ISO 일시 → `openGraph.publishedTime`. */\n  date?: string | null;\n  /** 대표 이미지 URL → `openGraph.images` (`seo.ogImage` 우선). */\n  image?: string | null;\n  /** 어드민 SEO 패널 override (`metaJson.seo`). */\n  seo?: PostSeoOverrides | null;\n  /** 글 slug — `collections` 기반 canonical 자동 해석에 사용. */\n  slug?: string;\n  /**\n   * 소속 섹션 key (ADR-0060). `collections` 와 함께 주면 canonical basePath 를\n   * 공지/블로그로 구분해 해석한다(`collectionKey:\"notice\"` → `/notice`).\n   */\n  collectionKey?: string | null;\n}\n\nexport interface BuildPostMetadataOptions {\n  /**\n   * self-canonical 기본값 origin (예: `https://example.com`).\n   * `seo.canonical` override 가 있으면 무시된다. `path` 또는 `collections` 와\n   * 함께 줄 때만 동작.\n   */\n  siteUrl?: string;\n  /**\n   * self-canonical 기본값 경로 (예: `/blog/my-post`). `siteUrl` 과 함께.\n   * 명시하면 `collections` 파생보다 우선한다(단일 라우트 사이트용 명시 경로).\n   */\n  path?: string;\n  /**\n   * 섹션 정의 (ADR-0060). `path` 를 안 주면 글의 `collectionKey` 로 소속 섹션\n   * basePath 를 찾아 canonical 경로를 **공지/블로그로 구분해 자동 해석**한다\n   * (공지 글 → `/notice/{slug}`, 블로그 글 → `/blog/{slug}`). 어느 섹션에도\n   * 안 속하면(미설정·미존재 key) canonical 을 생략한다. `post.slug` 필요.\n   */\n  collections?: readonly RouteCollection[];\n}\n\n/** Next `Metadata` 의 구조적 부분집합 — 소비자는 그대로 return 가능. */\nexport interface PostMetadata {\n  title: string;\n  description?: string;\n  alternates?: { canonical: string };\n  robots?: { index: boolean; follow: boolean };\n  openGraph: {\n    type: \"article\";\n    title: string;\n    description?: string;\n    url?: string;\n    publishedTime?: string;\n    images?: { url: string; alt: string }[];\n  };\n}\n\n/**\n * 글 메타데이터를 Next `Metadata` 형태로 빌드.\n *\n * - 제목/설명/OG 이미지는 어드민 SEO override 가 있으면 우선, 없으면 글 값 fallback.\n * - canonical: `seo.canonical` override → 없으면 `siteUrl`+`path`(명시) → 없으면\n *   `siteUrl`+`collections`(글의 `collectionKey` 로 공지/블로그 basePath 자동 해석)\n *   → 없으면 생략. 모든 글이 자기 자신을 가리키는 canonical 을 갖는 게 권장이므로\n *   `siteUrl` 과 함께 `path` 또는 `collections` 전달을 권장한다.\n * - `noindex`/`nofollow` 중 하나라도 켜지면 `robots` 출력.\n *\n * ```ts\n * // 단일 블로그(레거시): 라우트가 곧 섹션이므로 path 를 직접 준다.\n * return buildPostMetadata(post, {\n *   siteUrl: process.env.NEXT_PUBLIC_SITE_URL,\n *   path: `/blog/${post.slug}`,\n * });\n *\n * // 다중 스트림(ADR-0060): collections 를 주면 공지/블로그를 글의\n * // collectionKey 로 구분해 canonical 을 자동 해석한다(공지→/notice, 블로그→/blog).\n * return buildPostMetadata(post, {\n *   siteUrl: process.env.NEXT_PUBLIC_SITE_URL,\n *   collections: COLLECTIONS,\n * });\n * ```\n */\nexport function buildPostMetadata(\n  post: PostMetadataInput,\n  options: BuildPostMetadataOptions = {},\n): PostMetadata {\n  const seo = post.seo ?? undefined;\n  const title = seo?.title || post.title;\n  const description = seo?.description || post.description || undefined;\n  const ogImage = seo?.ogImage || post.image || undefined;\n\n  let canonical = seo?.canonical || undefined;\n  if (!canonical && options.siteUrl) {\n    // 경로 우선순위: 명시 path → collections 로 글의 섹션 basePath 자동 해석(공지/블로그).\n    let path = options.path;\n    if (!path && options.collections && post.slug) {\n      path =\n        resolvePostPath(\n          { slug: post.slug, terms: [], collectionKey: post.collectionKey ?? null },\n          options.collections,\n        ) ?? undefined;\n    }\n    if (path) {\n      const normalized = path.startsWith(\"/\") ? path : `/${path}`;\n      canonical = `${trimSlash(options.siteUrl)}${normalized}`;\n    }\n  }\n\n  const openGraph: PostMetadata[\"openGraph\"] = { type: \"article\", title };\n  if (description) openGraph.description = description;\n  if (canonical) openGraph.url = canonical;\n  if (post.date) openGraph.publishedTime = post.date;\n  if (ogImage) openGraph.images = [{ url: ogImage, alt: title }];\n\n  const meta: PostMetadata = { title, openGraph };\n  if (description) meta.description = description;\n  if (canonical) meta.alternates = { canonical };\n  if (seo?.noindex || seo?.nofollow) {\n    meta.robots = { index: !seo.noindex, follow: !seo.nofollow };\n  }\n  return meta;\n}\n"],"mappings":"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","names":["resolvePostCollection","resolvePostUrl","resolvePostCollection","resolvePostUrl","postEntries","categoryEntries","isInCollectionMode","resolvePostUrl","isInCollectionMode","resolvePostUrl","isInCollectionMode","isInCollectionMode"]}

package/dist/server.d.ts

@@ -1,7 +1,7 @@
 import { ReactElement, ReactNode } from 'react';
 import { CmsPostContent, RootTaleTheme, CmsPostType } from '@roottale/cms-client/server';
 export { RootTaleTheme } from '@roottale/cms-client/server';
-import { Block, BindingResolver } from '@roottale/cms-core';
+import { Block, BindingResolver, RouteCollection } from '@roottale/cms-core';
 
 /**
  * `<RootTalePostCard>` — server-only summary card for a single CmsPostContent.
@@ -250,10 +250,27 @@ type RootTaleBlogListProps = {
     limit?: number;
     /** Filter by post type (`post` or `page`). Default = `post` only (blog list 의도). */
     type?: CmsPostType;
-    /** Build a customer-side URL for a single post. Defaults to `/blog/${slug}`. */
+    /**
+     * Build a customer-side URL for a single post. Defaults to `/blog/${slug}`,
+     * 또는 `collections` 를 주면 글의 섹션 basePath 기준(`/notice/${slug}` 등).
+     */
     postHref?: (post: CmsPostContent) => string;
     /** Rendered when the tenant has no published posts yet. */
     emptyMessage?: string;
+    /**
+     * 단일 섹션(stream)으로 스코프 (ADR-0060). `collections` 와 함께 줘야 동작한다.
+     * 예: `collection="notice"` → 공지 섹션 글만 렌더. **미지정 = 전체** 글(레거시
+     * 단일 블로그). 이 prop 없이 다중 스트림 사이트에서 쓰면 공지·블로그가 한 목록에
+     * 섞여 나오므로(`/blog` 에 공지가 새어 들어옴), 섹션을 나눈 사이트는 각 목록
+     * 페이지에서 반드시 `collection` 으로 스코프해야 한다.
+     */
+    collection?: string;
+    /**
+     * 섹션 정의 (ADR-0060). `collection` 스코프와 collection-aware `postHref`(글을
+     * 소속 섹션 basePath 로 라우팅) 해석에 쓰인다. admin 에서 동적으로 받으려면
+     * `fetchCollections()` 결과를 넘긴다(`collections.md` 참고).
+     */
+    collections?: readonly RouteCollection[];
     /**
      * 카테고리 필터 칩을 목록 위에 렌더. SSR-only — 칩은 `<a>` 링크이고
      * `?category=<slug>` URL 파라미터로 동작한다(client JS 불요). consumer 는
@@ -285,6 +302,14 @@ type RootTaleBlogCategoriesProps = {
     categoryHref?: (slug: string) => string;
     /** Rendered when no categories are attached to published posts yet. */
     emptyMessage?: string;
+    /**
+     * 단일 섹션으로 스코프 (ADR-0060). `collections` 와 함께 줘야 동작. 그 섹션의
+     * `categories`(주제 allowlist) 안에서, 그 섹션에 귀속된 글의 카테고리만 집계한다.
+     * 미지정 = 전체 글의 카테고리.
+     */
+    collection?: string;
+    /** 섹션 정의 (ADR-0060). `collection` 스코프에 필요. */
+    collections?: readonly RouteCollection[];
     /** See `RootTaleBlogListProps['theme']`. */
     theme?: RootTaleThemeInput;
 };

package/dist/server.js

@@ -15,13 +15,13 @@ import {
   renderBlock,
   renderBlocks,
   renderBoundBlocks
-} from "./chunk-HPERSTZ2.js";
+} from "./chunk-GAHOVQYW.js";
 import {
   collectCategories,
   collectCategoriesWithCounts,
   defaultCategoryHref,
   filterPostsByCategory
-} from "./chunk-O6KHDNGH.js";
+} from "./chunk-FUA5H6JE.js";
 export {
   RenderTiptap,
   RootTaleBlogCategories,

package/dist/templates.js

@@ -1,8 +1,8 @@
 import {
   RootTaleBlogList,
   RootTaleLeadForm
-} from "./chunk-HPERSTZ2.js";
-import "./chunk-O6KHDNGH.js";
+} from "./chunk-GAHOVQYW.js";
+import "./chunk-FUA5H6JE.js";
 
 // src/templates/site-config.ts
 import { z } from "zod";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@roottale/cms-renderer-next",
-  "version": "0.35.0",
+  "version": "0.36.0",
   "type": "module",
   "description": "RootTale CMS public-render React/Next.js Server Components. SSR-only RSC components (RootTaleBlogList / RootTaleBlogPost / RootTaleLeadForm) for external customer sites. Companion of @roottale/cms-renderer-astro (ADR-0034 §1.5 amended).",
   "main": "./dist/index.js",
@@ -42,7 +42,7 @@
   ],
   "dependencies": {
     "zod": "^3.23.8",
-    "@roottale/cms-client": "^0.35.0",
+    "@roottale/cms-client": "^0.36.0",
     "@roottale/cms-core": "^0.34.0"
   },
   "peerDependencies": {