@roottale/cms-client 0.67.1 → 0.69.0

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # @roottale/cms-client
 
+## 0.69.0
+
+### Minor Changes
+
+- 30b830f: 분류 기반 경로에서 선언한 첫 분류 선택, 미분류 대체 경로와 예약 경로를 공통 계산기로 처리합니다. 기존 분류 하나 필수 규칙은 그대로 유지합니다.
+
+  공개 필드와 본문에 기반한 콘텐츠 공개·검색 색인 정책 및 목록 선택 계약을 추가합니다. FRONT의 본문, 목록, sitemap과 관리자 메타데이터가 같은 평가기를 사용하며 강제 검색 제외 사유와 정책 전용 웹훅 캐시 무효화를 제공합니다. 정책을 선언하지 않은 연동의 동작은 유지됩니다.
+
+  글 조회에 캐시 태그 옵션을 공개하고 RootTaleBlogPost에 독립 categoryHref 속성을 추가해 별도 breadcrumb가 있는 사이트도 분류 링크를 정확히 연결할 수 있습니다. 정책 적용 예제와 공개 문서를 함께 제공합니다.
+
+### Patch Changes
+
+- Updated dependencies [30b830f]
+  - @roottale/cms-core@0.69.0
+
+## 0.68.0
+
+### Minor Changes
+
+- d7130d8: 기존 고객 사이트의 검색·공유 기본값을 선언형 계약으로 보존합니다. 문자열 커스텀 필드 템플릿, 본문 문단 대체값, Unicode와 단어 경계 말줄임, 고정 이미지 기본값, 모델별 강제 robots와 분류 공개 경로를 지원합니다. 수동 SEO 설정은 우선하며 강제 검색 차단은 유지합니다.
+
+  분류 조회 SDK에 색인 전환 상태와 추가 캐시 태그를 연결하고 외부 연동 문서·실행 예제를 함께 제공합니다.
+
+### Patch Changes
+
+- Updated dependencies [d7130d8]
+  - @roottale/cms-core@0.68.0
+
 ## 0.67.1
 
 ### Patch Changes

package/dist/server.d.ts

@@ -3,7 +3,7 @@ export { InquiryAnswer, InquiryFormDefinition, InquiryFormField, InquiryKind } f
 import { InquiryAttribution } from './attribution.js';
 export { parseAttributionJson } from './attribution.js';
 import { PublicRouteMetadata } from '@roottale/cms-core';
-export { MetadataDefaultRules, MetadataDefaultRulesSchema, MetadataDefaultsDeclaration, MetadataDefaultsInput, MetadataField, MetadataPatch, MetadataResolutionInput, MetadataRobotsPolicy, MetadataTextRule, MetadataValues, PublicRouteMetadata, formatMetadataDefaults, metadataContentImageUrl, readMetadataValues, resolveMetadata } from '@roottale/cms-core';
+export { MetadataDefaultRules, MetadataDefaultRulesSchema, MetadataDefaultsDeclaration, MetadataDefaultsInput, MetadataField, MetadataPatch, MetadataResolutionInput, MetadataRobotsPolicy, MetadataTextRule, MetadataValues, PublicRouteMetadata, formatMetadataDefaults, metadataBodyParagraphs, metadataContentImageUrl, readMetadataValues, resolveMetadata } from '@roottale/cms-core';
 
 /**
  * `@roottale/cms-client/server` — RootTale CMS Public API server-side fetch client.
@@ -31,6 +31,8 @@ interface CmsTermRef {
     taxonomy: CmsTaxonomyKind;
     slug: string;
     name: string;
+    termOrder?: number;
+    parentId?: string | null;
 }
 interface CmsArchiveRelatedPost {
     id: string;
@@ -251,6 +253,8 @@ interface FetchPostsOptions {
     signal?: AbortSignal;
     /** ISR revalidate 초(opt-in, W0-9). 미지정 시 현행 동작 유지. */
     revalidate?: number;
+    /** Next fetch cache tags. Use CONTENT_POLICY_CACHE_TAG for declared policy facts. */
+    tags?: string[];
 }
 interface FetchPostOptions {
     apiKey: string;
@@ -264,6 +268,8 @@ interface FetchPostOptions {
     signal?: AbortSignal;
     /** ISR revalidate 초(opt-in, W0-9). 미지정 시 현행 동작 유지. */
     revalidate?: number;
+    /** Next fetch cache tags. Use CONTENT_POLICY_CACHE_TAG for declared policy facts. */
+    tags?: string[];
 }
 declare class CmsApiError extends Error {
     readonly status: number;
@@ -643,6 +649,9 @@ interface CmsContentModel {
         readonly categoryDepth: number;
         /** `leaf`면 하위 분류가 없는 분류에 단계와 무관하게 글을 붙인다. 생략은 `deepest`. */
         readonly entryCategory?: "deepest" | "leaf";
+        readonly categorySelection?: "first";
+        readonly categoryFallbackSlug?: string;
+        readonly reservedCategorySlugs?: readonly string[];
         readonly templateKey?: string;
         readonly listPaths?: readonly string[];
     };
@@ -742,6 +751,7 @@ interface CmsCategoryCount {
     name: string;
     /** 부모 category term id. 루트면 null. */
     parentId?: string | null;
+    termOrder?: number;
     /** 요청 스코프(미소속/특정 스트림) 안에서 이 분류에 걸린 발행 글 수. 0 가능. */
     publishedPostCount: number;
     /** 이 분류가 귀속된 콘텐츠 유형 key (ADR-0060). 미귀속·구버전 응답이면 null. */
@@ -767,6 +777,8 @@ interface CmsCategoryCount {
 }
 interface CmsCategoryCounts {
     categories: CmsCategoryCount[];
+    /** Apply hubPromoted metadata policy only after explicit site activation. */
+    categoryIndexActivated?: boolean;
     /** 분류 수가 서버 상한을 넘어 일부가 빠졌으면 true — 소비처는 경고를 남길 것. */
     truncated: boolean;
 }
@@ -787,6 +799,8 @@ interface FetchCategoryCountsOptions {
     signal?: AbortSignal;
     /** ISR revalidate 초(opt-in). 미지정 시 현행 동작 유지. */
     revalidate?: number;
+    /** Additional Next.js data-cache tags (for example METADATA_CACHE_TAG). */
+    tags?: string[];
 }
 /**
  * 사이트의 모든 분류와 발행 글 수를 가져온다. 네트워크/서버 에러는 **throw** —
@@ -1353,6 +1367,8 @@ declare function selectSitePatternForSlot(patternSlots: Readonly<Record<string,
 
 declare const METADATA_CACHE_TAG = "rt-metadata";
 declare const SITE_METADATA_DEFAULTS_CACHE_TAG = "rt-metadata-defaults";
+/** Add to public post/term fetches whose fields determine a declared content policy. */
+declare const CONTENT_POLICY_CACHE_TAG = "rt-content-policy";
 /** locale를 생략한 요청은 사이트 기본 locale을 조회한다. */
 declare function routeMetadataCacheTag(routeKey: string, locale?: string): string;
 interface FetchRouteMetadataOptions {
@@ -1691,4 +1707,4 @@ declare function formatKoreanPhoneNumber(input: string): string;
  */
 declare function submitInquiry(options: SubmitInquiryOptions): Promise<SubmitInquiryResult>;
 
-export { type ActionDockAction, type ActionDockKind, type ActionDockPosition, type ActionDockSettings, type AnalyticsTagConfig, type AnalyticsTagProvider, type AnnouncementItem, type AnnouncementSettings, type AnnouncementTone, type AnnouncementVariant, type ArticleSchemaInput, BLOG_SETTINGS_CACHE_TAG, BUSINESS_CACHE_TAG, type BusinessDayCode, type BusinessOpeningHours, type BusinessType, CMS_CLIENT_VERSION, COLLECTIONS_CACHE_TAG, CmsApiError, type CmsArchiveRelatedGroup, type CmsArchiveRelatedPost, type CmsCategoryCount, type CmsCategoryCounts, type CmsContentModel, type CmsExposureCampaign, type CmsExposureDecision, type CmsFieldMetaEntry, type CmsPostContent, type CmsPostContentPage, type CmsPostPreviewContent, type CmsPostPreviewInfo, type CmsPostTranslationRef, type CmsPostType, type CmsRouteCollection, type CmsSearchHit, type CmsSitePattern, type CmsSitePatternPresentation, type CmsTaxonomyKind, type CmsTermRef, DEFAULT_BLOG_SETTINGS, DEFAULT_SITE_PATTERN_PRESENTATION, EXPOSURE_CACHE_TAG, type FetchAnalyticsOptions, type FetchAuthorsOptions, type FetchBlogSettingsOptions, type FetchBusinessProfileOptions, type FetchCategoryCountsOptions, type FetchCollectionsOptions, type FetchContentModelsOptions, type FetchExposureDecisionOptions, type FetchExposureOptions, type FetchInquiryFormOptions, type FetchMenuOptions, type FetchMenusOptions, type FetchPageBySlugOptions, type FetchPostOptions, type FetchPostPreviewOptions, type FetchPostsOptions, type FetchRedirectsOptions, type FetchRouteMetadataOptions, type FetchSiteInquiriesOptions, type FetchSiteInquiryOptions, type FetchSitePatternsOptions, type FetchThemeOptions, type FormInquiryReceipt, INQUIRY_ERROR_MESSAGES, InquiryAttribution, type InquiryBoardSettings, type InquiryVertical, LOCAL_BUSINESS_MAX_SERVICES, LOCAL_BUSINESS_SERVICE_MAX_LENGTH, type LocalBusinessProfileInput, MENUS_CACHE_TAG, METADATA_CACHE_TAG, POST_FOOTER_PATTERN_SLOT, type PublishedInquiryForm, type ResolvedPostDisplay, type RootTaleAuthor, type RootTaleBlogPostCta, type RootTaleBlogSettings, type RootTaleBusinessProfile, type RootTaleMenu, type RootTaleMenuItem, type RootTaleRedirect, type RootTaleSiteProfile, type RootTaleSitemapSettings, type RootTaleTheme, type RssFeedInput, type RssItemInput, SETTINGS_CACHE_TAGS, SITE_METADATA_DEFAULTS_CACHE_TAG, SITE_PATTERNS_CACHE_TAG, type SearchPostsOptions, type SiteAnalyticsTags, type SiteInquiryDetail, type SiteInquiryListItem, type SiteInquiryListPage, type SiteInquiryStatus, type SiteNavColumn, type SiteNavCta, type SiteNavGroup, type SiteNavLink, type SiteNavSettings, type SiteVerificationMetadata, type SiteVerificationSettings, type SubmitFormInquiryFields, type SubmitFormInquiryOptions, type SubmitFormInquiryResult, type SubmitInquiryFields, type SubmitInquiryOptions, type SubmitInquiryResult, type SubmitSiteInquiryFields, type SubmitSiteInquiryOptions, type SubmitSiteInquiryResult, THEME_CACHE_TAG, articleSchema, breadcrumbSchema, businessProfileFromWire, collectionPageSchema, contentIdMeta, faqSchema, fetchAnalyticsConfig, fetchAuthors, fetchBlogSettings, fetchBusinessProfile, fetchCategoryCounts, fetchCollections, fetchCollectionsSafeDefault, fetchContentModels, fetchExposure, fetchExposureDecision, fetchInquiryForm, fetchMenu, fetchMenus, fetchPageBySlug, fetchPost, fetchPostPreview, fetchPosts, fetchRedirects, fetchRouteMetadata, fetchSiteInquiries, fetchSiteInquiry, fetchSitePatterns, fetchTheme, formatKoreanPhoneNumber, generateRssXml, inquiryErrorMessage, isPreviewExpiredError, jsonLdJson, jsonLdScript, localBusinessSchema, metadataContractChecksum, organizationSchema, parseInquiryRedirect, profilePageSchema, resolvePostDisplay, resolveSearchHitPath, routeMetadataCacheTag, rssItemsFromPosts, searchPosts, selectRelatedPosts, selectSitePatternForSlot, sitePatternPresentationAttributes, siteVerificationMetadata, submitFormInquiry, submitInquiry, submitSiteInquiry, websiteSchema };
+export { type ActionDockAction, type ActionDockKind, type ActionDockPosition, type ActionDockSettings, type AnalyticsTagConfig, type AnalyticsTagProvider, type AnnouncementItem, type AnnouncementSettings, type AnnouncementTone, type AnnouncementVariant, type ArticleSchemaInput, BLOG_SETTINGS_CACHE_TAG, BUSINESS_CACHE_TAG, type BusinessDayCode, type BusinessOpeningHours, type BusinessType, CMS_CLIENT_VERSION, COLLECTIONS_CACHE_TAG, CONTENT_POLICY_CACHE_TAG, CmsApiError, type CmsArchiveRelatedGroup, type CmsArchiveRelatedPost, type CmsCategoryCount, type CmsCategoryCounts, type CmsContentModel, type CmsExposureCampaign, type CmsExposureDecision, type CmsFieldMetaEntry, type CmsPostContent, type CmsPostContentPage, type CmsPostPreviewContent, type CmsPostPreviewInfo, type CmsPostTranslationRef, type CmsPostType, type CmsRouteCollection, type CmsSearchHit, type CmsSitePattern, type CmsSitePatternPresentation, type CmsTaxonomyKind, type CmsTermRef, DEFAULT_BLOG_SETTINGS, DEFAULT_SITE_PATTERN_PRESENTATION, EXPOSURE_CACHE_TAG, type FetchAnalyticsOptions, type FetchAuthorsOptions, type FetchBlogSettingsOptions, type FetchBusinessProfileOptions, type FetchCategoryCountsOptions, type FetchCollectionsOptions, type FetchContentModelsOptions, type FetchExposureDecisionOptions, type FetchExposureOptions, type FetchInquiryFormOptions, type FetchMenuOptions, type FetchMenusOptions, type FetchPageBySlugOptions, type FetchPostOptions, type FetchPostPreviewOptions, type FetchPostsOptions, type FetchRedirectsOptions, type FetchRouteMetadataOptions, type FetchSiteInquiriesOptions, type FetchSiteInquiryOptions, type FetchSitePatternsOptions, type FetchThemeOptions, type FormInquiryReceipt, INQUIRY_ERROR_MESSAGES, InquiryAttribution, type InquiryBoardSettings, type InquiryVertical, LOCAL_BUSINESS_MAX_SERVICES, LOCAL_BUSINESS_SERVICE_MAX_LENGTH, type LocalBusinessProfileInput, MENUS_CACHE_TAG, METADATA_CACHE_TAG, POST_FOOTER_PATTERN_SLOT, type PublishedInquiryForm, type ResolvedPostDisplay, type RootTaleAuthor, type RootTaleBlogPostCta, type RootTaleBlogSettings, type RootTaleBusinessProfile, type RootTaleMenu, type RootTaleMenuItem, type RootTaleRedirect, type RootTaleSiteProfile, type RootTaleSitemapSettings, type RootTaleTheme, type RssFeedInput, type RssItemInput, SETTINGS_CACHE_TAGS, SITE_METADATA_DEFAULTS_CACHE_TAG, SITE_PATTERNS_CACHE_TAG, type SearchPostsOptions, type SiteAnalyticsTags, type SiteInquiryDetail, type SiteInquiryListItem, type SiteInquiryListPage, type SiteInquiryStatus, type SiteNavColumn, type SiteNavCta, type SiteNavGroup, type SiteNavLink, type SiteNavSettings, type SiteVerificationMetadata, type SiteVerificationSettings, type SubmitFormInquiryFields, type SubmitFormInquiryOptions, type SubmitFormInquiryResult, type SubmitInquiryFields, type SubmitInquiryOptions, type SubmitInquiryResult, type SubmitSiteInquiryFields, type SubmitSiteInquiryOptions, type SubmitSiteInquiryResult, THEME_CACHE_TAG, articleSchema, breadcrumbSchema, businessProfileFromWire, collectionPageSchema, contentIdMeta, faqSchema, fetchAnalyticsConfig, fetchAuthors, fetchBlogSettings, fetchBusinessProfile, fetchCategoryCounts, fetchCollections, fetchCollectionsSafeDefault, fetchContentModels, fetchExposure, fetchExposureDecision, fetchInquiryForm, fetchMenu, fetchMenus, fetchPageBySlug, fetchPost, fetchPostPreview, fetchPosts, fetchRedirects, fetchRouteMetadata, fetchSiteInquiries, fetchSiteInquiry, fetchSitePatterns, fetchTheme, formatKoreanPhoneNumber, generateRssXml, inquiryErrorMessage, isPreviewExpiredError, jsonLdJson, jsonLdScript, localBusinessSchema, metadataContractChecksum, organizationSchema, parseInquiryRedirect, profilePageSchema, resolvePostDisplay, resolveSearchHitPath, routeMetadataCacheTag, rssItemsFromPosts, searchPosts, selectRelatedPosts, selectSitePatternForSlot, sitePatternPresentationAttributes, siteVerificationMetadata, submitFormInquiry, submitInquiry, submitSiteInquiry, websiteSchema };

package/dist/server.js

@@ -4,7 +4,7 @@ import {
 
 // src/server-base.ts
 var DEFAULT_BASE_URL = "https://api.roottale.com";
-var CLIENT_VERSION = true ? "0.67.1" : "dev";
+var CLIENT_VERSION = true ? "0.69.0" : "dev";
 var CMS_CLIENT_VERSION = CLIENT_VERSION;
 function authHeaders(apiKey) {
   return {
@@ -129,7 +129,11 @@ function postFromWire(wire) {
         }))
       } : {}
     })),
-    terms: wire.terms ?? [],
+    terms: (wire.terms ?? []).map(({ term_order, parent_id, ...term }) => ({
+      ...term,
+      ...term_order !== void 0 ? { termOrder: term_order } : {},
+      ...parent_id !== void 0 ? { parentId: parent_id } : {}
+    })),
     archiveRelated: (wire.archive_related ?? []).map((group) => ({
       collectionKey: group.collection_key,
       label: group.label,
@@ -394,6 +398,9 @@ async function fetchContentModels(options) {
       kind: "category_tree",
       basePath: rawPresentation.basePath,
       categoryDepth: rawPresentation.categoryDepth,
+      ...rawPresentation.categorySelection === "first" ? { categorySelection: "first" } : {},
+      ...typeof rawPresentation.categoryFallbackSlug === "string" ? { categoryFallbackSlug: rawPresentation.categoryFallbackSlug } : {},
+      ...Array.isArray(rawPresentation.reservedCategorySlugs) ? { reservedCategorySlugs: rawPresentation.reservedCategorySlugs.filter((slug) => typeof slug === "string") } : {},
       ...rawPresentation.entryCategory === "leaf" || rawPresentation.entryCategory === "deepest" ? { entryCategory: rawPresentation.entryCategory } : {},
       ...typeof rawPresentation.templateKey === "string" ? { templateKey: rawPresentation.templateKey } : {},
       ...withListPaths
@@ -553,6 +560,7 @@ async function fetchCategoryCounts(options) {
           slug,
           name,
           parentId: typeof o.parent_id === "string" ? o.parent_id : null,
+          ...typeof o.term_order === "number" && Number.isInteger(o.term_order) ? { termOrder: o.term_order } : {},
           publishedPostCount: toNonNegativeInt(o.published_post_count),
           collectionKey: typeof o.collection_key === "string" ? o.collection_key : null,
           hubPromoted: o.hub_promoted === true,
@@ -569,7 +577,8 @@ async function fetchCategoryCounts(options) {
         }
       ];
     }),
-    truncated: json.truncated === true
+    truncated: json.truncated === true,
+    ...typeof json.category_index_activated === "boolean" ? { categoryIndexActivated: json.category_index_activated } : {}
   };
 }
 
@@ -1201,9 +1210,10 @@ function selectSitePatternForSlot(patternSlots, patterns, slot = POST_FOOTER_PAT
 
 // src/server-metadata.ts
 import { MetadataRobotsPolicySchema, MetadataValuesSchema } from "@roottale/cms-core";
-import { readMetadataValues, resolveMetadata, formatMetadataDefaults, metadataContentImageUrl, MetadataDefaultRulesSchema } from "@roottale/cms-core";
+import { readMetadataValues, resolveMetadata, formatMetadataDefaults, metadataBodyParagraphs, metadataContentImageUrl, MetadataDefaultRulesSchema } from "@roottale/cms-core";
 var METADATA_CACHE_TAG = "rt-metadata";
 var SITE_METADATA_DEFAULTS_CACHE_TAG = "rt-metadata-defaults";
+var CONTENT_POLICY_CACHE_TAG = "rt-content-policy";
 function routeMetadataCacheTag(routeKey, locale) {
   if (!/^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/.test(routeKey) || routeKey.length > 160) throw new Error("Invalid metadata route key");
   const language = locale?.trim().toLowerCase() || "default";
@@ -1705,6 +1715,7 @@ export {
   BUSINESS_CACHE_TAG,
   CMS_CLIENT_VERSION,
   COLLECTIONS_CACHE_TAG,
+  CONTENT_POLICY_CACHE_TAG,
   CmsApiError,
   DEFAULT_BLOG_SETTINGS,
   DEFAULT_SITE_PATTERN_PRESENTATION,
@@ -1757,6 +1768,7 @@ export {
   jsonLdJson,
   jsonLdScript,
   localBusinessSchema,
+  metadataBodyParagraphs,
   metadataContentImageUrl,
   metadataContractChecksum,
   organizationSchema,