@roottale/cms-client 0.53.0 → 0.55.0

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.53.0" : "dev";
+var CLIENT_VERSION = true ? "0.55.0" : "dev";
 var CMS_CLIENT_VERSION = CLIENT_VERSION;
 function authHeaders(apiKey) {
   return {
@@ -55,6 +55,65 @@ function assertServer() {
   }
 }
 
+// src/server-post-wire.ts
+function postFromWire(wire) {
+  return {
+    id: wire.id,
+    tenantId: wire.tenant_id,
+    siteId: wire.site_id,
+    type: wire.type,
+    collectionKey: wire.collection_key ?? null,
+    modelKey: wire.model_key ?? null,
+    slug: wire.slug,
+    ...wire.locale !== void 0 ? { locale: wire.locale } : {},
+    ...wire.translations !== void 0 ? { translations: wire.translations } : {},
+    ...wire.previous_slugs !== void 0 ? { previousSlugs: wire.previous_slugs } : {},
+    title: wire.title,
+    excerpt: wire.excerpt,
+    featuredMediaId: wire.featured_media_id,
+    featuredImageUrl: wire.featured_media_url ?? null,
+    authorProfileId: wire.author_profile_id ?? null,
+    authorId: wire.author_id,
+    authorName: wire.author_name ?? null,
+    authorImageUrl: wire.author_image_url ?? null,
+    authorBio: wire.author_bio ?? null,
+    authorSlug: wire.author_slug ?? null,
+    bodyJson: wire.body_json,
+    // 구 서버(필드 없음) → null → body_json 폴백 = 종전 동작 그대로.
+    bodyHtml: wire.body_html ?? null,
+    status: wire.status,
+    metaJson: wire.meta_json,
+    fields: wire.fields ?? null,
+    fieldsMeta: (wire.fields_meta ?? []).map((entry) => ({
+      name: entry.name,
+      label: entry.label,
+      type: entry.type,
+      ...entry.choices ? {
+        choices: entry.choices.map((c) => ({
+          value: c.value,
+          label: c.label
+        }))
+      } : {}
+    })),
+    terms: wire.terms ?? [],
+    archiveRelated: (wire.archive_related ?? []).map((group) => ({
+      collectionKey: group.collection_key,
+      label: group.label,
+      items: group.items.map((item) => ({
+        id: item.id,
+        title: item.title,
+        slug: item.slug,
+        excerpt: item.excerpt,
+        collectionKey: item.collection_key
+      }))
+    })),
+    ...typeof wire.view_count === "number" ? { viewCount: wire.view_count } : {},
+    publishedAt: wire.published_at,
+    createdAt: wire.created_at,
+    updatedAt: wire.updated_at
+  };
+}
+
 // src/server-posts-theme.ts
 var THEME_CACHE_TAG = "rt-theme";
 async function fetchTheme(options) {
@@ -104,6 +163,7 @@ async function fetchPosts(options) {
   if (options.author) params.set("author", options.author);
   if (options.siteId) params.set("site_id", options.siteId);
   if (options.collectionKey) params.set("collection_key", options.collectionKey);
+  if (options.modelKey) params.set("model_key", options.modelKey);
   if (options.excludeCollections) params.set("exclude_collections", "true");
   if (options.locale) params.set("locale", options.locale);
   const qs = params.toString();
@@ -114,7 +174,7 @@ async function fetchPosts(options) {
   }
   const json = await response.json();
   return {
-    items: json.items.map(fromWire),
+    items: json.items.map(postFromWire),
     hasMore: json.has_more,
     nextCursor: json.next_cursor
   };
@@ -133,7 +193,7 @@ async function fetchPost(options) {
     throw await toApiError(response);
   }
   const json = await response.json();
-  return fromWire(json);
+  return postFromWire(json);
 }
 async function fetchPageBySlug(options) {
   let cursor;
@@ -155,58 +215,6 @@ async function fetchPageBySlug(options) {
   } while (cursor);
   return null;
 }
-function fromWire(wire) {
-  return {
-    id: wire.id,
-    tenantId: wire.tenant_id,
-    siteId: wire.site_id,
-    type: wire.type,
-    collectionKey: wire.collection_key ?? null,
-    slug: wire.slug,
-    ...wire.locale !== void 0 ? { locale: wire.locale } : {},
-    ...wire.translations !== void 0 ? { translations: wire.translations } : {},
-    title: wire.title,
-    excerpt: wire.excerpt,
-    featuredMediaId: wire.featured_media_id,
-    featuredImageUrl: wire.featured_media_url ?? null,
-    authorId: wire.author_id,
-    authorName: wire.author_name ?? null,
-    authorImageUrl: wire.author_image_url ?? null,
-    authorBio: wire.author_bio ?? null,
-    authorSlug: wire.author_slug ?? null,
-    bodyJson: wire.body_json,
-    status: wire.status,
-    metaJson: wire.meta_json,
-    fields: wire.fields ?? null,
-    fieldsMeta: (wire.fields_meta ?? []).map((entry) => ({
-      name: entry.name,
-      label: entry.label,
-      type: entry.type,
-      ...entry.choices ? {
-        choices: entry.choices.map((c) => ({
-          value: c.value,
-          label: c.label
-        }))
-      } : {}
-    })),
-    terms: wire.terms ?? [],
-    archiveRelated: (wire.archive_related ?? []).map((group) => ({
-      collectionKey: group.collection_key,
-      label: group.label,
-      items: group.items.map((item) => ({
-        id: item.id,
-        title: item.title,
-        slug: item.slug,
-        excerpt: item.excerpt,
-        collectionKey: item.collection_key
-      }))
-    })),
-    ...typeof wire.view_count === "number" ? { viewCount: wire.view_count } : {},
-    publishedAt: wire.published_at,
-    createdAt: wire.created_at,
-    updatedAt: wire.updated_at
-  };
-}
 
 // src/server-blog.ts
 var BLOG_SETTINGS_CACHE_TAG = "rt-blog-settings";
@@ -301,12 +309,59 @@ async function fetchCollections(options) {
         pinning: o.pinning === true,
         icon: typeof o.icon === "string" ? o.icon : null,
         // 기본 true(하위 호환) — 명시적으로 false 인 경우만 목록 전용.
-        detail: o.detail !== false
+        detail: o.detail !== false,
+        detailPath: o.detail_path === "category" ? "category" : "flat",
+        categoryPath: o.category_path === "direct" ? "direct" : "namespaced",
+        categoryCardinality: o.category_cardinality === "exactly-one" ? "exactly-one" : "multiple"
       }
     ];
   });
 }
 var fetchCollectionsSafeDefault = [];
+async function fetchContentModels(options) {
+  assertServer();
+  const baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+  const params = new URLSearchParams();
+  if (options.siteId) params.set("site_id", options.siteId);
+  const qs = params.toString();
+  const response = await fetch(
+    `${baseUrl}/v1/cms/public/content-models${qs ? `?${qs}` : ""}`,
+    buildGetInit(options.apiKey, options)
+  );
+  if (!response.ok) throw await toApiError(response);
+  const json = await response.json();
+  return (Array.isArray(json.models) ? json.models : []).flatMap((model) => {
+    if (typeof model.key !== "string" || typeof model.label !== "string") return [];
+    const cardinality = model.cardinality === "singleton" ? "singleton" : "collection";
+    const preset = model.preset === "page" || model.preset === "article" || model.preset === "entity" ? model.preset : null;
+    const rawPresentation = model.presentation && typeof model.presentation === "object" && !Array.isArray(model.presentation) ? model.presentation : {};
+    const presentation = rawPresentation.kind === "fixed_page" && typeof rawPresentation.path === "string" ? {
+      kind: "fixed_page",
+      path: rawPresentation.path,
+      allowedSections: Array.isArray(rawPresentation.allowedSections) ? rawPresentation.allowedSections.filter(
+        (item) => typeof item === "string"
+      ) : [],
+      ...typeof rawPresentation.templateKey === "string" ? { templateKey: rawPresentation.templateKey } : {}
+    } : rawPresentation.kind === "detail" && typeof rawPresentation.detailPath === "string" ? {
+      kind: "detail",
+      detailPath: rawPresentation.detailPath,
+      ...typeof rawPresentation.templateKey === "string" ? { templateKey: rawPresentation.templateKey } : {}
+    } : rawPresentation.kind === "category_tree" && typeof rawPresentation.basePath === "string" && typeof rawPresentation.categoryDepth === "number" ? {
+      kind: "category_tree",
+      basePath: rawPresentation.basePath,
+      categoryDepth: rawPresentation.categoryDepth,
+      ...typeof rawPresentation.templateKey === "string" ? { templateKey: rawPresentation.templateKey } : {}
+    } : { kind: "data_only" };
+    return [{
+      key: model.key,
+      label: model.label,
+      cardinality,
+      preset,
+      source: model.source === "site" ? "site" : "code",
+      presentation
+    }];
+  });
+}
 async function fetchAuthors(options) {
   assertServer();
   const baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
@@ -444,11 +499,20 @@ async function fetchCategoryCounts(options) {
       if (!slug || !name) return [];
       return [
         {
+          id: typeof o.id === "string" ? o.id : null,
           slug,
           name,
+          parentId: typeof o.parent_id === "string" ? o.parent_id : null,
           publishedPostCount: toNonNegativeInt(o.published_post_count),
           collectionKey: typeof o.collection_key === "string" ? o.collection_key : null,
-          hubPromoted: o.hub_promoted === true
+          hubPromoted: o.hub_promoted === true,
+          description: typeof o.description === "string" ? o.description : null,
+          seoTitle: typeof o.seo_title === "string" ? o.seo_title : null,
+          seoDescription: typeof o.seo_description === "string" ? o.seo_description : null,
+          imageMediaId: typeof o.image_media_id === "string" ? o.image_media_id : null,
+          imageUrl: typeof o.image_url === "string" ? o.image_url : null,
+          imageAlt: typeof o.image_alt === "string" ? o.image_alt : null,
+          path: typeof o.path === "string" ? o.path : null
         }
       ];
     }),
@@ -522,6 +586,7 @@ async function searchPosts(options) {
   params.set("q", options.query);
   if (options.limit !== void 0) params.set("limit", String(options.limit));
   if (options.type) params.set("type", options.type);
+  if (options.locale) params.set("locale", options.locale);
   if (options.siteId) params.set("site_id", options.siteId);
   const url = `${baseUrl}/v1/cms/public/search?${params.toString()}`;
   const response = await fetch(url, buildGetInit(options.apiKey, options));
@@ -533,6 +598,9 @@ async function searchPosts(options) {
   return json.items.map((w) => ({
     id: w.id,
     type: w.type,
+    collectionKey: w.collection_key ?? null,
+    modelKey: w.model_key ?? null,
+    locale: w.locale,
     title: w.title,
     slug: w.slug,
     excerpt: w.excerpt,
@@ -540,6 +608,25 @@ async function searchPosts(options) {
     publishedAt: w.published_at
   }));
 }
+function resolveSearchHitPath(hit, collections, locale) {
+  let path;
+  if (hit.type === "page") {
+    path = `/${hit.slug}`;
+  } else {
+    const collection = hit.collectionKey ? collections.find((candidate) => candidate.key === hit.collectionKey) : void 0;
+    if (!collection) {
+      path = `/blog/${hit.slug}`;
+    } else if (!collection.detail || collection.basePath.length === 0) {
+      path = null;
+    } else {
+      const basePath = `/${collection.basePath}`.replace(/\/{2,}/g, "/").replace(/\/$/, "");
+      path = `${basePath}/${hit.slug}`;
+    }
+  }
+  if (!path || !locale) return path;
+  const localePrefix = `/${locale.replace(/^\/+|\/+$/g, "")}`;
+  return `${localePrefix}${path}`;
+}
 var MENUS_CACHE_TAG = "rt-menus";
 function menuItemFromWire(w) {
   const item = { id: w.id, label: w.label, url: w.url };
@@ -609,6 +696,39 @@ async function fetchRedirects(options) {
   }));
 }
 
+// src/server-exposure.ts
+var EXPOSURE_CACHE_TAG = "rt-exposures";
+async function fetchExposure(options) {
+  assertServer();
+  const baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+  const params = new URLSearchParams({ slot_key: options.slotKey, path: options.path });
+  if (options.siteId) params.set("site_id", options.siteId);
+  const response = await fetch(
+    `${baseUrl}/v1/cms/public/exposures?${params.toString()}`,
+    buildGetInit(options.apiKey, options)
+  );
+  if (!response.ok) throw await toApiError(response);
+  const json = await response.json();
+  const campaign = json.campaign;
+  if (!campaign) return null;
+  return {
+    id: campaign.id,
+    slotKey: campaign.slot_key,
+    kind: campaign.kind,
+    content: {
+      variant: campaign.content.variant,
+      ...campaign.content.eyebrow ? { eyebrow: campaign.content.eyebrow } : {},
+      title: campaign.content.title,
+      ...campaign.content.description ? { description: campaign.content.description } : {},
+      ...campaign.content.asset_url ? { assetUrl: campaign.content.asset_url } : {},
+      ...campaign.content.asset_alt ? { assetAlt: campaign.content.asset_alt } : {},
+      ...campaign.content.link_label ? { linkLabel: campaign.content.link_label } : {},
+      ...campaign.content.link_url ? { linkUrl: campaign.content.link_url } : {}
+    },
+    repeat: campaign.repeat
+  };
+}
+
 // src/server-site-inquiries.ts
 async function fetchSiteInquiries(options) {
   assertServer();
@@ -694,13 +814,44 @@ function fromDetailWire(item) {
   };
 }
 
+// src/server-preview.ts
+function isPreviewExpiredError(error) {
+  return error instanceof CmsApiError && (error.code === "preview_expired" || error.status === 410);
+}
+async function fetchPostPreview(options) {
+  assertServer();
+  const token = options.token.trim();
+  if (!token) return null;
+  const baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+  const params = new URLSearchParams({ token });
+  if (options.siteId) params.set("site_id", options.siteId);
+  const url = `${baseUrl}/v1/cms/public/posts/preview?${params.toString()}`;
+  const response = await fetch(url, {
+    ...buildGetInit(options.apiKey, { signal: options.signal }),
+    cache: "no-store"
+  });
+  if (response.status === 404) return null;
+  if (!response.ok) {
+    throw await toApiError(response);
+  }
+  const json = await response.json();
+  return {
+    ...postFromWire(json),
+    preview: {
+      expiresAt: json.preview.expires_at,
+      sourceStatus: json.preview.source_status
+    }
+  };
+}
+
 // src/server-cache-tags.ts
 var SETTINGS_CACHE_TAGS = [
   THEME_CACHE_TAG,
   BUSINESS_CACHE_TAG,
   MENUS_CACHE_TAG,
   BLOG_SETTINGS_CACHE_TAG,
-  COLLECTIONS_CACHE_TAG
+  COLLECTIONS_CACHE_TAG,
+  EXPOSURE_CACHE_TAG
 ];
 
 // src/seo.ts
@@ -1132,6 +1283,7 @@ export {
   COLLECTIONS_CACHE_TAG,
   CmsApiError,
   DEFAULT_BLOG_SETTINGS,
+  EXPOSURE_CACHE_TAG,
   INQUIRY_ERROR_MESSAGES,
   LOCAL_BUSINESS_MAX_SERVICES,
   LOCAL_BUSINESS_SERVICE_MAX_LENGTH,
@@ -1151,10 +1303,13 @@ export {
   fetchCategoryCounts,
   fetchCollections,
   fetchCollectionsSafeDefault,
+  fetchContentModels,
+  fetchExposure,
   fetchMenu,
   fetchMenus,
   fetchPageBySlug,
   fetchPost,
+  fetchPostPreview,
   fetchPosts,
   fetchRedirects,
   fetchSiteInquiries,
@@ -1163,6 +1318,7 @@ export {
   formatKoreanPhoneNumber,
   generateRssXml,
   inquiryErrorMessage,
+  isPreviewExpiredError,
   jsonLdJson,
   jsonLdScript,
   localBusinessSchema,
@@ -1171,6 +1327,7 @@ export {
   parseInquiryRedirect,
   profilePageSchema,
   resolvePostDisplay,
+  resolveSearchHitPath,
   rssItemsFromPosts,
   searchPosts,
   selectRelatedPosts,