@roottale/cms-renderer-next 0.53.0 → 0.53.1

package/dist/server.d.ts

@@ -4,6 +4,7 @@ export { RootTaleTheme } from '@roottale/cms-client/server';
 import { RootTaleThemeStyle } from '@roottale/ui-react/theme';
 import { Block, BindingResolver, RouteCollection } from '@roottale/cms-core';
 export { a as BlogCategory, B as BlogCategoryWithCount, c as collectCategories, b as collectCategoriesWithCounts, d as defaultCategoryHref, f as filterPostsByCategory } from './blog-filter-BKCGM0qd.js';
+import * as react_jsx_runtime from 'react/jsx-runtime';
 
 /**
  * `<RootTalePostCard>` — server-only summary card for a single CmsPostContent.
@@ -277,9 +278,23 @@ type RootTalePageProps = {
     showTitle?: boolean;
     theme?: RootTaleThemeInput;
     locale?: string;
+    /** 페이지 JSON을 렌더하기 직전 콘텐츠 참조를 실제 섹션 props로 바꾸는 서버 함수. */
+    prepareBody?: (document: Record<string, unknown>) => Promise<Record<string, unknown>>;
 };
 declare function RootTalePage(props: RootTalePageProps): Promise<ReactElement>;
 
+interface RootTaleExposureSlotProps {
+    readonly apiKey: string;
+    readonly baseUrl?: string;
+    readonly siteId?: string;
+    readonly slotKey: string;
+    readonly path: string;
+    readonly allowedVariants: readonly string[];
+    readonly revalidate?: number;
+}
+/** FRONT가 코드로 만든 슬롯 안에서만 활성 배너·팝업을 렌더한다. */
+declare function RootTaleExposureSlot(props: RootTaleExposureSlotProps): Promise<react_jsx_runtime.JSX.Element | null>;
+
 type RenderTiptapProps = {
     readonly doc: Record<string, unknown>;
     readonly fields?: Record<string, unknown> | null;
@@ -288,4 +303,33 @@ type RenderTiptapProps = {
 };
 declare function RenderTiptap({ doc, fields, apiKey, baseUrl, }: RenderTiptapProps): ReactElement;
 
-export { type BlogPostBreadcrumbOptions, type CtaButton, type CtaButtonType, type FloatingCtaPosition, type LeadFormVertical, RenderTiptap, RootTaleBlogCategories, type RootTaleBlogCategoriesProps, RootTaleBlogList, type RootTaleBlogListProps, RootTaleBlogPost, type RootTaleBlogPostProps, type RootTaleCssVars, RootTaleFaqJsonLd, RootTaleFloatingCta, type RootTaleFloatingCtaProps, RootTaleLeadForm, type RootTaleLeadFormProps, RootTalePage, type RootTalePageProps, RootTalePostCard, type RootTalePostCardProps, RootTaleTableOfContents, type RootTaleTableOfContentsProps, type RootTaleThemeInput, RootTaleThemeProvider, type TocEntry, attachHeadingIds, extractToc, headingToId, renderBlock, renderBlocks, renderBoundBlocks, themeToCssVars };
+/**
+ * 본문 렌더 소스 결정 — HTML 정본 우선, 없으면 Block JSON 폴백.
+ *
+ * 배경: 외부에서 이관한 글은 **HTML 이 정본**이고 body_json 은 그 파생/대체본이다.
+ * 파생본은 표·중첩 목록 같은 구조에서 원문과 미묘하게 달라질 수 있으므로, 원문이
+ * 남아 있으면 그것을 보여주는 편이 정확하다. 반대로 에디터에서 편집된 글은
+ * body_html 이 비워지므로(저장 경로가 무효화) 자동으로 JSON 경로로 돌아온다.
+ *
+ * 안전성: HTML 은 신뢰하지 않는다. 최종 sink 는 공용 `sanitizeHtml` 하나뿐이며
+ * (cms-core), 렌더 직전 여기서 통과시킨다 — 저장 시점에 정제됐더라도 다시 한다
+ * (저장 경로가 여럿이고 sanitizer 규칙은 갱신되므로, 방어는 렌더 시점 기준).
+ *
+ * sanitize 결과가 실질적으로 비면(태그만 남고 내용이 없음) HTML 을 쓰지 않고
+ * JSON 으로 폴백한다 — 빈 화면보다 파생본이 낫다.
+ */
+type PostBodySource = {
+    readonly kind: "html";
+    readonly html: string;
+} | {
+    readonly kind: "json";
+};
+/**
+ * 렌더에 쓸 본문 소스를 고른다.
+ *
+ * @param bodyHtml 원문 HTML 정본 (null/미포함 = 구 서버이거나 JSON 이 정본).
+ * @returns `kind: "html"` 이면 `html` 은 **이미 sanitize 된** 값이라 그대로 주입 가능.
+ */
+declare function resolvePostBodySource(bodyHtml: string | null | undefined): PostBodySource;
+
+export { type BlogPostBreadcrumbOptions, type CtaButton, type CtaButtonType, type FloatingCtaPosition, type LeadFormVertical, type PostBodySource, RenderTiptap, RootTaleBlogCategories, type RootTaleBlogCategoriesProps, RootTaleBlogList, type RootTaleBlogListProps, RootTaleBlogPost, type RootTaleBlogPostProps, type RootTaleCssVars, RootTaleExposureSlot, type RootTaleExposureSlotProps, RootTaleFaqJsonLd, RootTaleFloatingCta, type RootTaleFloatingCtaProps, RootTaleLeadForm, type RootTaleLeadFormProps, RootTalePage, type RootTalePageProps, RootTalePostCard, type RootTalePostCardProps, RootTaleTableOfContents, type RootTaleTableOfContentsProps, type RootTaleThemeInput, RootTaleThemeProvider, type TocEntry, attachHeadingIds, extractToc, headingToId, renderBlock, renderBlocks, renderBoundBlocks, resolvePostBodySource, themeToCssVars };

package/dist/server.js

@@ -12,6 +12,9 @@ import {
 import {
   LeadFormMeta
 } from "./chunk-VG6UUF4D.js";
+import {
+  RootTaleExposure
+} from "./chunk-GVKENK6H.js";
 
 // src/PostCard.tsx
 import { jsx, jsxs } from "react/jsx-runtime";
@@ -623,7 +626,6 @@ function attachHeadingIds(doc, entries) {
 
 // src/server/blog-list.tsx
 import {
-  fetchPosts,
   resolvePostDisplay
 } from "@roottale/cms-client/server";
 import {
@@ -640,6 +642,18 @@ async function fetchBlogSettingsFailSoft(input) {
   return fetchBlogSettings(input).catch(() => DEFAULT_BLOG_SETTINGS);
 }
 
+// src/server/fetch-posts-fail-soft.ts
+import {
+  fetchPosts
+} from "@roottale/cms-client/server";
+async function fetchPostsFailSoft(options) {
+  try {
+    return await fetchPosts(options);
+  } catch {
+    return { items: [], hasMore: false, nextCursor: null };
+  }
+}
+
 // src/server/post-links.ts
 import {
   resolvePostCollection,
@@ -726,7 +740,7 @@ async function RootTaleBlogList(props) {
   } = props;
   const postHref = props.postHref ?? (collections ? makeCollectionPostHref(collections) : defaultPostHref);
   const [page, themeStyle, blogSettings] = await Promise.all([
-    fetchPosts({
+    fetchPostsFailSoft({
       apiKey,
       baseUrl,
       limit,
@@ -787,9 +801,6 @@ async function RootTaleBlogList(props) {
 }
 
 // src/server/blog-categories.tsx
-import {
-  fetchPosts as fetchPosts2
-} from "@roottale/cms-client/server";
 import { jsx as jsx8, jsxs as jsxs7 } from "react/jsx-runtime";
 async function RootTaleBlogCategories(props) {
   const {
@@ -804,7 +815,7 @@ async function RootTaleBlogCategories(props) {
     theme: themeProp
   } = props;
   const [page, themeStyle] = await Promise.all([
-    fetchPosts2({
+    fetchPostsFailSoft({
       apiKey,
       baseUrl,
       limit,
@@ -839,7 +850,7 @@ async function RootTaleBlogCategories(props) {
 // src/server/blog-post.tsx
 import {
   fetchPost,
-  fetchPosts as fetchPosts3,
+  fetchPosts as fetchPosts2,
   resolvePostDisplay as resolvePostDisplay2,
   selectRelatedPosts
 } from "@roottale/cms-client/server";
@@ -931,12 +942,30 @@ function renderFieldFacts(post) {
   ] }, meta.name)) }) });
 }
 
+// src/server/post-body-source.ts
+import { sanitizeHtml as sanitizeHtml2 } from "@roottale/cms-core";
+function hasVisibleContent(html) {
+  if (/<(?:img|hr|br|iframe|video|audio)\b/i.test(html)) return true;
+  return html.replace(/<[^>]*>/g, "").replace(/&nbsp;/gi, " ").trim().length > 0;
+}
+function resolvePostBodySource(bodyHtml) {
+  if (typeof bodyHtml !== "string") return { kind: "json" };
+  const trimmed = bodyHtml.trim();
+  if (trimmed.length === 0) return { kind: "json" };
+  const sanitized = sanitizeHtml2(trimmed);
+  if (!hasVisibleContent(sanitized)) return { kind: "json" };
+  return { kind: "html", html: sanitized };
+}
+
 // src/server/tiptap-node-renderer.tsx
+import { Fragment as Fragment4 } from "react";
 import {
   bindingSrcValue,
   bindingTextValue,
   boundFieldValue,
-  normalizeImageAlt
+  ensureImportedHtmlDocumentRoots,
+  normalizeImageAlt,
+  scopeImportedCss
 } from "@roottale/cms-core";
 
 // src/server/tiptap-embed-renderer.tsx
@@ -1151,6 +1180,33 @@ function renderTiptapNode(value, key, context) {
         key
       );
     }
+    case "importedHtml": {
+      const rawHtml = node.attrs?.html;
+      if (typeof rawHtml !== "string" || rawHtml.length === 0) return null;
+      const scope = typeof node.attrs?.scope === "string" ? node.attrs.scope : "";
+      const assetUrls = Array.isArray(node.attrs?.assetUrls) ? node.attrs.assetUrls.filter(
+        (value2) => typeof value2 === "string" && /^https:\/\//i.test(value2)
+      ) : [];
+      const scopedCss = scopeImportedCss(
+        typeof node.attrs?.css === "string" ? node.attrs.css : "",
+        scope,
+        assetUrls
+      );
+      return /* @__PURE__ */ jsxs9(Fragment4, { children: [
+        scopedCss ? /* @__PURE__ */ jsx12("style", { "data-rt-imported-style": scope, children: scopedCss }) : null,
+        /* @__PURE__ */ jsx12(
+          "div",
+          {
+            className: "rt-imported-html",
+            "data-rt-import-scope": scopedCss ? scope : void 0,
+            style: { position: "relative", isolation: "isolate" },
+            dangerouslySetInnerHTML: {
+              __html: ensureImportedHtmlDocumentRoots(rawHtml, assetUrls)
+            }
+          }
+        )
+      ] }, key);
+    }
     case "columns":
       return /* @__PURE__ */ jsx12("div", { className: "rt-columns", children }, key);
     case "column":
@@ -1217,7 +1273,7 @@ function renderTiptapNode(value, key, context) {
 }
 
 // src/server/render-tiptap.tsx
-import { Fragment as Fragment4, jsx as jsx13 } from "react/jsx-runtime";
+import { Fragment as Fragment5, jsx as jsx13 } from "react/jsx-runtime";
 function isDevelopmentRuntime() {
   const processValue = Reflect.get(globalThis, "process");
   if (!isRecord(processValue)) return true;
@@ -1252,7 +1308,7 @@ function RenderTiptap({
     fields: fields ?? null,
     section: createSectionContextWithBlogListNetworkFetch(apiKey, baseUrl)
   };
-  return /* @__PURE__ */ jsx13(Fragment4, { children: contentNodes(renderDoc).map((value, index) => {
+  return /* @__PURE__ */ jsx13(Fragment5, { children: contentNodes(renderDoc).map((value, index) => {
     const node = parseTiptapNode(value);
     if (node?.type !== "tableOfContents") {
       return renderTiptapNode(value, index, context);
@@ -1270,7 +1326,7 @@ function RenderTiptap({
 }
 
 // src/server/blog-post-body.tsx
-import { Fragment as Fragment5, jsx as jsx14, jsxs as jsxs10 } from "react/jsx-runtime";
+import { Fragment as Fragment6, jsx as jsx14, jsxs as jsxs10 } from "react/jsx-runtime";
 function BlogPostBody(props) {
   const {
     doc,
@@ -1279,10 +1335,17 @@ function BlogPostBody(props) {
     baseUrl,
     toc,
     tocTitle,
-    tocPosition
+    tocPosition,
+    bodyHtml
   } = props;
   const tableOfContents = toc.length > 0 ? /* @__PURE__ */ jsx14(RootTaleTableOfContents, { entries: toc, title: tocTitle }) : null;
-  const body = /* @__PURE__ */ jsx14("div", { "data-roottale-cms": "body", className: "rt-cms-body", children: /* @__PURE__ */ jsx14(
+  const source = resolvePostBodySource(bodyHtml);
+  const body = /* @__PURE__ */ jsx14("div", { "data-roottale-cms": "body", className: "rt-cms-body", children: source.kind === "html" ? (
+    // source.html 은 resolvePostBodySource 가 공용 sanitizeHtml 로 정제한 값이다
+    // (이 컴포넌트에서 한 번 더 정제하지 않는 이유 — sink 가 한 곳이어야 눈으로
+    // 추적 가능하고, 이중 정제는 안전을 더 만들지 않으면서 비용만 든다).
+    /* @__PURE__ */ jsx14("div", { dangerouslySetInnerHTML: { __html: source.html } })
+  ) : /* @__PURE__ */ jsx14(
     RenderTiptap,
     {
       doc,
@@ -1297,7 +1360,7 @@ function BlogPostBody(props) {
       /* @__PURE__ */ jsx14("aside", { className: "rt-cms-toc-side", children: tableOfContents })
     ] });
   }
-  return /* @__PURE__ */ jsxs10(Fragment5, { children: [
+  return /* @__PURE__ */ jsxs10(Fragment6, { children: [
     tableOfContents,
     body
   ] });
@@ -1311,7 +1374,7 @@ import {
 import {
   resolvePostCollection as resolvePostCollection2
 } from "@roottale/cms-core";
-import { Fragment as Fragment6, jsx as jsx15, jsxs as jsxs11 } from "react/jsx-runtime";
+import { Fragment as Fragment7, jsx as jsx15, jsxs as jsxs11 } from "react/jsx-runtime";
 function absoluteUrl(siteUrl, path) {
   const normalizedPath = path.startsWith("/") ? path : `/${path}`;
   return `${trimSlash(siteUrl)}${normalizedPath}`;
@@ -1346,7 +1409,7 @@ function renderBlogPostBreadcrumb(input) {
       url: absoluteUrl(siteUrl, crumb.href)
     }))
   ) : null;
-  return /* @__PURE__ */ jsxs11(Fragment6, { children: [
+  return /* @__PURE__ */ jsxs11(Fragment7, { children: [
     /* @__PURE__ */ jsx15("nav", { "aria-label": "\uBE0C\uB808\uB4DC\uD06C\uB7FC", className: "rt-cms-breadcrumb", children: /* @__PURE__ */ jsx15("ol", { children: crumbs.map(
       (crumb, index) => index === crumbs.length - 1 ? /* @__PURE__ */ jsx15("li", { "aria-current": "page", children: crumb.label }, index) : /* @__PURE__ */ jsx15("li", { children: /* @__PURE__ */ jsx15("a", { href: crumb.href, children: crumb.label }) }, index)
     ) }) }),
@@ -1426,7 +1489,7 @@ function RootTaleFaqJsonLd({
 import { jsx as jsx17, jsxs as jsxs13 } from "react/jsx-runtime";
 async function fetchRelatedPostsFailSoft(input) {
   if (input.count <= 0) return [];
-  const candidates = await fetchPosts3({
+  const candidates = await fetchPosts2({
     apiKey: input.apiKey,
     baseUrl: input.baseUrl,
     type: "post",
@@ -1611,7 +1674,8 @@ async function RootTaleBlogPost(props) {
             baseUrl,
             toc,
             tocTitle: display.tocTitle,
-            tocPosition: display.tocPosition
+            tocPosition: display.tocPosition,
+            bodyHtml: post.bodyHtml
           }
         ),
         showAuthorCard && authorName ? /* @__PURE__ */ jsxs13("section", { className: "rt-cms-author-card", "aria-label": "\uC791\uC131\uC790", children: [
@@ -1650,7 +1714,8 @@ async function RootTalePage(props) {
     notFoundElement,
     showTitle = true,
     theme: themeProp,
-    locale
+    locale,
+    prepareBody
   } = props;
   const [post, themeStyle] = await Promise.all([
     fetchPost2({ apiKey, slugOrId, baseUrl, ...locale ? { locale } : {} }),
@@ -1659,6 +1724,8 @@ async function RootTalePage(props) {
   if (!post) {
     return notFoundElement ?? /* @__PURE__ */ jsx18("div", { "data-roottale-cms": "page-missing", style: themeStyle ?? void 0, children: /* @__PURE__ */ jsx18("p", { className: "rt-cms-empty", children: t(locale, "pageNotFound") }) });
   }
+  const pageBodySource = resolvePostBodySource(post.bodyHtml);
+  const bodyJson = pageBodySource.kind === "json" && prepareBody ? await prepareBody(post.bodyJson) : post.bodyJson;
   return /* @__PURE__ */ jsxs14(
     "article",
     {
@@ -1667,10 +1734,10 @@ async function RootTalePage(props) {
       style: themeStyle ?? void 0,
       children: [
         showTitle ? /* @__PURE__ */ jsx18("header", { className: "rt-cms-post-header", children: /* @__PURE__ */ jsx18("h1", { className: "rt-cms-title", children: post.title }) }) : null,
-        /* @__PURE__ */ jsx18("div", { "data-roottale-cms": "body", className: "rt-cms-body", children: /* @__PURE__ */ jsx18(
+        /* @__PURE__ */ jsx18("div", { "data-roottale-cms": "body", className: "rt-cms-body", children: pageBodySource.kind === "html" ? /* @__PURE__ */ jsx18("div", { dangerouslySetInnerHTML: { __html: pageBodySource.html } }) : /* @__PURE__ */ jsx18(
           RenderTiptap,
           {
-            doc: post.bodyJson,
+            doc: bodyJson,
             fields: post.fields,
             apiKey,
             baseUrl
@@ -1680,11 +1747,28 @@ async function RootTalePage(props) {
     }
   );
 }
+
+// src/server/exposure-slot.tsx
+import { fetchExposure } from "@roottale/cms-client/server";
+import { jsx as jsx19 } from "react/jsx-runtime";
+async function RootTaleExposureSlot(props) {
+  const campaign = await fetchExposure({
+    apiKey: props.apiKey,
+    baseUrl: props.baseUrl,
+    siteId: props.siteId,
+    slotKey: props.slotKey,
+    path: props.path,
+    revalidate: props.revalidate
+  });
+  if (!campaign || !props.allowedVariants.includes(campaign.content.variant)) return null;
+  return /* @__PURE__ */ jsx19(RootTaleExposure, { campaign, allowedVariants: props.allowedVariants });
+}
 export {
   RenderTiptap,
   RootTaleBlogCategories,
   RootTaleBlogList,
   RootTaleBlogPost,
+  RootTaleExposureSlot,
   RootTaleFaqJsonLd,
   RootTaleFloatingCta,
   RootTaleLeadForm,
@@ -1702,6 +1786,7 @@ export {
   renderBlock,
   renderBlocks,
   renderBoundBlocks,
+  resolvePostBodySource,
   themeToCssVars2 as themeToCssVars
 };
 //# sourceMappingURL=server.js.map