@roottale/cms-client 0.25.0 → 0.33.0

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # @roottale/cms-client
 
+## 0.33.0
+
+### Minor Changes
+
+- 2e6cbd0: ADR-0060 Amendment 1 (Option A) — 글의 섹션을 명시 필드로
+
+  `resolvePostCollection` 이 글의 명시 `collectionKey` 를 카테고리 slug 파생보다
+  우선 사용한다. `RoutablePost`·`CmsPostContent` 에 `collectionKey` 추가, 공개 API
+  post 페이로드에 `collection_key` 포함. 미설정/구 서버면 기존 카테고리 파생으로
+  fallback(완전 하위호환). sitemap/feed/가드/아카이브가 명시 섹션을 따른다.
+
+## 0.31.0
+
+### Minor Changes
+
+- b68ed00: 콘텐츠 Collections 공개 API + 클라이언트 (ADR-0060 P2.1)
+
+  `fetchCollections()` + `CmsRouteCollection` 추가 — 사이트가 `/v1/cms/public/collections`
+  에서 콘텐츠 스트림(공지/블로그 등)을 가져온다. 응답은 cms-core `RouteCollection` 과
+  구조 호환이라 `createSitemap`/`createFeedRoute` 의 `collections` 에 그대로 넘길 수 있다.
+  미설정이면 빈 배열(레거시 단일 /blog). collections SSoT = 플랫폼 per-site `settings`
+  테이블 key `content_collections`(마이그레이션 불필요 — 기존 KV).
+
 ## 0.25.0
 
 ### Minor Changes

package/dist/server.d.ts

@@ -1,212 +1,6 @@
 import { InquiryAttribution } from './attribution.js';
 export { parseAttributionJson } from './attribution.js';
 
-interface RssItemInput {
-    title: string;
-    /** 글 절대 URL. */
-    link: string;
-    /** 고유 식별자. 미지정 시 link 사용. */
-    guid?: string;
-    description?: string | null;
-    /** 발행 시각. */
-    pubDate?: string | Date | null;
-}
-interface RssFeedInput {
-    /** 사이트/피드 제목. */
-    title: string;
-    /** 사이트 홈 URL. */
-    link: string;
-    /** 이 피드 자체의 URL (atom:self). */
-    feedUrl: string;
-    description?: string;
-    /** 기본 "ko-KR". */
-    language?: string;
-    items: RssItemInput[];
-}
-/** RSS 2.0 XML 문자열 생성. */
-declare function generateRssXml(input: RssFeedInput): string;
-/** CmsPostContent[] → RSS item[]. postUrl 로 글 절대 URL 생성. */
-declare function rssItemsFromPosts(posts: CmsPostContent[], opts: {
-    postUrl: (post: CmsPostContent) => string;
-}): RssItemInput[];
-type JsonLd = Record<string, unknown>;
-interface ArticleSchemaInput {
-    headline: string;
-    url: string;
-    description?: string | null;
-    image?: string | null;
-    datePublished?: string | Date | null;
-    dateModified?: string | Date | null;
-    authorName?: string | null;
-    publisherName?: string;
-    publisherLogo?: string;
-}
-declare function articleSchema(input: ArticleSchemaInput): JsonLd;
-declare function breadcrumbSchema(items: {
-    name: string;
-    url: string;
-}[]): JsonLd;
-declare function organizationSchema(input: {
-    name: string;
-    url: string;
-    logo?: string;
-    sameAs?: string[];
-}): JsonLd;
-/**
- * `localBusinessSchema` 입력 — `fetchBusinessProfile` 의 반환값
- * (RootTaleBusinessProfile) 을 그대로 받도록 느슨하게 정의 (null/undefined 모두
- * 허용). 수동 구성도 가능.
- */
-interface LocalBusinessProfileInput {
-    name: string;
-    legalName?: string | null;
-    /** Schema.org LocalBusiness 하위 타입. 미지정 시 "LocalBusiness". */
-    businessType?: string | null;
-    telephone?: string | null;
-    email?: string | null;
-    address?: {
-        streetAddress: string;
-        addressLocality: string;
-        addressRegion?: string | null;
-        postalCode?: string | null;
-    } | null;
-    geo?: {
-        latitude: number;
-        longitude: number;
-    } | null;
-    openingHours?: {
-        days: string[];
-        opens: string;
-        closes: string;
-    }[] | null;
-    priceRange?: string | null;
-    areaServed?: string[] | null;
-    /** 외부 프로필 URL — 값들이 sameAs 로 들어간다 (네이버플레이스·구글 등). */
-    profiles?: Record<string, string | null | undefined> | null;
-}
-/**
- * LocalBusiness JSON-LD — admin "운영 > 비즈니스 프로필" 의
- * `fetchBusinessProfile` 결과로 layout 에 1회 렌더한다 (로컬 SEO).
- *
- * - `@type` 은 `[businessType, "LocalBusiness"]` 중복 제거 배열.
- * - `profiles` 의 URL 들은 `sameAs` 로 — 검색엔진이 네이버플레이스/구글
- *   비즈니스 프로필과 동일 사업장임을 연결한다.
- */
-declare function localBusinessSchema(profile: LocalBusinessProfileInput | RootTaleBusinessProfile, opts: {
-    url: string;
-    image?: string | null;
-}): JsonLd;
-declare function websiteSchema(input: {
-    name: string;
-    url: string;
-    searchUrl?: string;
-}): JsonLd;
-declare function faqSchema(qa: {
-    question: string;
-    answer: string;
-}[]): JsonLd;
-/** JSON-LD 객체 → `<script type="application/ld+json">` HTML 문자열 (XSS-safe). */
-declare function jsonLdScript(schema: JsonLd | JsonLd[]): string;
-
-/**
- * `@roottale/cms-client` — 리드(문의) 접수 server-side 헬퍼.
- *
- * 외부 고객사 사이트가 *블로그 조회(`fetchPosts`)와 동일한 API key 하나* 로 리드도
- * 접수하기 위한 SSR-only 클라이언트. 브라우저가 아니라 사이트 서버(Server Action /
- * Route Handler)에서 호출해야 한다 — API key 는 절대 브라우저로 노출 금지
- * (ADR-0023 §5.1 #15). 키가 tenant 를 권위 식별하므로 `tenant_slug` 불필요.
- *
- * 사용 예 (Next.js server action):
- * ```ts
- * "use server";
- * import { submitInquiry } from "@roottale/cms-client/server";
- *
- * const result = await submitInquiry({
- *   apiKey: process.env.ROOTTALE_API_KEY!,   // fetchPosts 와 같은 키
- *   fields: {
- *     vertical: "tax",
- *     contactName: name,
- *     businessName: company,
- *     email,
- *     phone,
- *     message,
- *     privacyConsent: true,
- *   },
- * });
- * if (result.ok) showSuccess();   // 그 키의 tenant /crm 에 도착
- * else showError(result.message);
- * ```
- *
- * intake API 는 302 `?ok=1` / `?err=*` 로 응답 — 본 헬퍼가 파싱해 구조화 결과 반환.
- */
-
-type InquiryVertical = "consulting" | "medical" | "tax" | "legal";
-/** intake API 의 `err` 코드 → 한국어 사용자 메시지. */
-declare const INQUIRY_ERROR_MESSAGES: Record<string, string>;
-interface SubmitInquiryFields {
-    vertical: InquiryVertical;
-    contactName: string;
-    businessName: string;
-    email: string;
-    phone: string;
-    /** 자유 문의 내용 (선택). */
-    message?: string;
-    /** 상담 분야 라벨 등 부가 메타 (선택). */
-    consultationField?: string;
-    /** 현재 사이트 URL (선택). */
-    currentSiteUrl?: string;
-    /** 개인정보 수집·이용 동의 (필수 true). */
-    privacyConsent: boolean;
-    /** 의료 vertical 의 국외이전 동의 (medical 일 때 필수). */
-    overseasTransferConsent?: boolean;
-    /**
-     * "patient"(고객사 방문자 문의, 기본) | "sales"(RootTale 자체 B2B 영업 리드).
-     * sales 는 medical 국외이전 동의 게이트 면제.
-     */
-    leadKind?: "patient" | "sales";
-    /**
-     * 표준 필드 외에 폼이 받은 임의 항목(key→value)을 있는 그대로 전달. intake 가
-     * 암호화 보관하고 CRM 상세에서 노출한다. 예약 키(표준 필드)·`_` 접두 키는 무시.
-     * 주의: 개인정보가 담길 수 있으므로 폼의 동의 고지에 수집 항목을 반영할 것.
-     */
-    extras?: Record<string, string>;
-    /**
-     * 유입 first-touch 어트리뷰션 (ADR-0048 §2, 선택). 브라우저에서
-     * `readAttribution()`(`@roottale/cms-client/attribution`)으로 읽어 Server
-     * Action 인자로 넘긴 값을 그대로 전달하면 된다. CRM 에 "이 문의가 어느
-     * 글/링크/QR 에서 왔는지"가 표시된다. null/undefined 면 미동반 제출.
-     */
-    attribution?: InquiryAttribution | null;
-}
-interface SubmitInquiryOptions {
-    /** `rtlk_cust_*` API key — `fetchPosts` 와 동일한 키. Required. */
-    apiKey: string;
-    /** API base URL 오버라이드. 기본 `https://api.roottale.com`. */
-    baseUrl?: string;
-    fields: SubmitInquiryFields;
-    signal?: AbortSignal;
-}
-type SubmitInquiryResult = {
-    ok: true;
-} | {
-    ok: false;
-    code: string | null;
-    message: string;
-};
-/** `err` 코드를 사용자 메시지로 (미지의 코드는 generic). */
-declare function inquiryErrorMessage(code: string | null | undefined): string;
-/**
- * intake API 의 302 Location (`?ok=1` / `?err=*`) 을 구조화 결과로 파싱.
- * 외부 사이트가 ERROR_MESSAGES·파싱을 각자 재구현하지 않도록 공유.
- */
-declare function parseInquiryRedirect(location: string | null, base?: string): SubmitInquiryResult;
-declare function formatKoreanPhoneNumber(input: string): string;
-/**
- * 리드를 RootTale intake API 로 제출 (server-to-server, Bearer 인증).
- * 키의 tenant 로 라우팅되어 admin(mysite.roottale.com) /crm 에서 관리된다.
- */
-declare function submitInquiry(options: SubmitInquiryOptions): Promise<SubmitInquiryResult>;
-
 /**
  * `@roottale/cms-client/server` — RootTale CMS Public API server-side fetch client.
  *
@@ -243,6 +37,11 @@ interface CmsPostContent {
     siteId: string;
     /** WP post type. */
     type: CmsPostType;
+    /**
+     * ADR-0060 Amendment 1 — 글의 명시 섹션(content collection) key. 라우팅/스트림
+     * 판정에 카테고리 파생보다 우선. 구 서버/미설정이면 null.
+     */
+    collectionKey: string | null;
     /** Lowercase kebab-case slug (1-120 chars). */
     slug: string;
     title: string;
@@ -318,6 +117,12 @@ interface FetchPostOptions {
     siteId?: string;
     signal?: AbortSignal;
 }
+declare class CmsApiError extends Error {
+    readonly status: number;
+    readonly code: string;
+    constructor(message: string, status: number, code: string);
+}
+
 /**
  * 외부 사이트가 cms-renderer 에 주입할 RootTale 디자인 토큰.
  * admin /design (mysite.roottale.com) 에서 저장한 값과 동일한 shape.
@@ -390,6 +195,9 @@ interface FetchAnalyticsOptions {
  * 동의는 항상 fail-closed(런타임이 처리)이므로 키 노출 위험 없음(public id).
  */
 declare function fetchAnalyticsConfig(options: FetchAnalyticsOptions): Promise<SiteAnalyticsTags>;
+declare function fetchPosts(options: FetchPostsOptions): Promise<CmsPostContentPage>;
+declare function fetchPost(options: FetchPostOptions): Promise<CmsPostContent | null>;
+
 /**
  * 블로그 표시 설정 — admin /design 의 "블로그 표시" 에서 저장한 사이트 기본값.
  * renderer 가 prop 미지정 시 이 값을 기본으로 적용 (글별 override 는 post 의
@@ -430,8 +238,69 @@ interface FetchBlogSettingsOptions {
  * 호출자(renderer)가 안전 기본값으로 fallback.
  */
 declare function fetchBlogSettings(options: FetchBlogSettingsOptions): Promise<RootTaleBlogSettings>;
+/**
+ * 콘텐츠 스트림 1개 (camelCase). cms-core `RouteCollection` 과 구조 호환 —
+ * `createSitemap`/`createFeedRoute` 의 `collections` 에 그대로 넘길 수 있다.
+ */
+interface CmsRouteCollection {
+    key: string;
+    label: string;
+    basePath: string;
+    layout: string;
+    categories: string[];
+    feed: boolean;
+    archives: boolean;
+    og: boolean;
+    requireSubcategory: boolean;
+    pinning: boolean;
+    icon: string | null;
+}
+interface FetchCollectionsOptions {
+    apiKey: string;
+    baseUrl?: string;
+    siteId?: string;
+    signal?: AbortSignal;
+}
+/**
+ * 사이트의 콘텐츠 Collections (공지/블로그 등 스트림 분리)를 가져온다. 미설정이면
+ * 빈 배열(레거시 단일 /blog). 네트워크/서버 에러는 throw — 호출자가 빈 배열로
+ * fail-soft 하도록 한다(렌더가 collections 때문에 죽지 않는 것이 계약).
+ */
+declare function fetchCollections(options: FetchCollectionsOptions): Promise<CmsRouteCollection[]>;
+/**
+ * fetch 실패/미설정 시 안전 기본값 — 빈 배열(레거시 단일 /blog). 사이트가
+ * `fetchCollections().catch(() => fetchCollectionsSafeDefault())` 로 쓴다.
+ */
+declare const fetchCollectionsSafeDefault: CmsRouteCollection[];
 /** fetch 실패/미설정 시 사용할 안전 기본값 (기존 렌더러 동작). */
 declare const DEFAULT_BLOG_SETTINGS: RootTaleBlogSettings;
+interface ResolvedPostDisplay {
+    showTableOfContents: boolean;
+    showAuthor: boolean;
+    showDate: boolean;
+    showAuthorCard: boolean;
+    tocTitle: string;
+    authorCardEyebrow: string;
+    authorCardDescription: string | null;
+    authorProfileName: string | null;
+    authorProfileBio: string | null;
+    authorProfileImageUrl: string | null;
+    authorProfileImageRadius: "circle" | "rounded" | "square";
+    authorProfileImagePositionX: number;
+    authorProfileImagePositionY: number;
+}
+/**
+ * 글 1건의 실제 표시 여부 결정. 우선순위:
+ *   명시 prop > 글별 override(post.metaJson.display) > 사이트 기본값(settings).
+ * tocTitle: 명시 prop > settings.tocTitle > "목차".
+ */
+declare function resolvePostDisplay(post: {
+    metaJson?: Record<string, unknown> | null;
+}, settings: RootTaleBlogSettings, explicit?: {
+    showTableOfContents?: boolean;
+    tableOfContentsTitle?: string;
+}): ResolvedPostDisplay;
+
 /** Schema.org LocalBusiness 하위 타입 (admin "운영 > 비즈니스 프로필" 의 업종). */
 type BusinessType = "LocalBusiness" | "ProfessionalService" | "AccountingService" | "LegalService" | "MedicalClinic" | "Dentist" | "RealEstateAgent" | "Restaurant" | "BeautySalon";
 /** Schema.org openingHours 요일 약어. */
@@ -526,39 +395,7 @@ declare function businessProfileFromWire(json: BusinessProfileWire): RootTaleBus
  * `.catch(() => null)` 등으로 fallback.
  */
 declare function fetchBusinessProfile(options: FetchBusinessProfileOptions): Promise<RootTaleBusinessProfile | null>;
-interface ResolvedPostDisplay {
-    showTableOfContents: boolean;
-    showAuthor: boolean;
-    showDate: boolean;
-    showAuthorCard: boolean;
-    tocTitle: string;
-    authorCardEyebrow: string;
-    authorCardDescription: string | null;
-    authorProfileName: string | null;
-    authorProfileBio: string | null;
-    authorProfileImageUrl: string | null;
-    authorProfileImageRadius: "circle" | "rounded" | "square";
-    authorProfileImagePositionX: number;
-    authorProfileImagePositionY: number;
-}
-/**
- * 글 1건의 실제 표시 여부 결정. 우선순위:
- *   명시 prop > 글별 override(post.metaJson.display) > 사이트 기본값(settings).
- * tocTitle: 명시 prop > settings.tocTitle > "목차".
- */
-declare function resolvePostDisplay(post: {
-    metaJson?: Record<string, unknown> | null;
-}, settings: RootTaleBlogSettings, explicit?: {
-    showTableOfContents?: boolean;
-    tableOfContentsTitle?: string;
-}): ResolvedPostDisplay;
-declare class CmsApiError extends Error {
-    readonly status: number;
-    readonly code: string;
-    constructor(message: string, status: number, code: string);
-}
-declare function fetchPosts(options: FetchPostsOptions): Promise<CmsPostContentPage>;
-declare function fetchPost(options: FetchPostOptions): Promise<CmsPostContent | null>;
+
 interface SearchPostsOptions {
     apiKey: string;
     baseUrl?: string;
@@ -629,4 +466,210 @@ declare function fetchMenu(options: FetchMenuOptions): Promise<RootTaleMenu | nu
 /** 사이트의 네비게이션 메뉴 전체. 구 서버(라우트 미배포)는 404 — 빈 배열. */
 declare function fetchMenus(options: FetchMenusOptions): Promise<RootTaleMenu[]>;
 
-export { type AnalyticsTagConfig, type AnalyticsTagProvider, type ArticleSchemaInput, type BusinessDayCode, type BusinessOpeningHours, type BusinessType, CMS_CLIENT_VERSION, CmsApiError, type CmsPostContent, type CmsPostContentPage, type CmsPostType, type CmsSearchHit, type CmsTaxonomyKind, type CmsTermRef, DEFAULT_BLOG_SETTINGS, type FetchAnalyticsOptions, type FetchBlogSettingsOptions, type FetchBusinessProfileOptions, type FetchMenuOptions, type FetchMenusOptions, type FetchPostOptions, type FetchPostsOptions, type FetchThemeOptions, INQUIRY_ERROR_MESSAGES, InquiryAttribution, type InquiryVertical, type LocalBusinessProfileInput, type ResolvedPostDisplay, type RootTaleBlogSettings, type RootTaleBusinessProfile, type RootTaleMenu, type RootTaleMenuItem, type RootTaleTheme, type RssFeedInput, type RssItemInput, type SearchPostsOptions, type SiteAnalyticsTags, type SubmitInquiryFields, type SubmitInquiryOptions, type SubmitInquiryResult, articleSchema, breadcrumbSchema, businessProfileFromWire, faqSchema, fetchAnalyticsConfig, fetchBlogSettings, fetchBusinessProfile, fetchMenu, fetchMenus, fetchPost, fetchPosts, fetchTheme, formatKoreanPhoneNumber, generateRssXml, inquiryErrorMessage, jsonLdScript, localBusinessSchema, organizationSchema, parseInquiryRedirect, resolvePostDisplay, rssItemsFromPosts, searchPosts, submitInquiry, websiteSchema };
+interface RssItemInput {
+    title: string;
+    /** 글 절대 URL. */
+    link: string;
+    /** 고유 식별자. 미지정 시 link 사용. */
+    guid?: string;
+    description?: string | null;
+    /** 발행 시각. */
+    pubDate?: string | Date | null;
+}
+interface RssFeedInput {
+    /** 사이트/피드 제목. */
+    title: string;
+    /** 사이트 홈 URL. */
+    link: string;
+    /** 이 피드 자체의 URL (atom:self). */
+    feedUrl: string;
+    description?: string;
+    /** 기본 "ko-KR". */
+    language?: string;
+    items: RssItemInput[];
+}
+/** RSS 2.0 XML 문자열 생성. */
+declare function generateRssXml(input: RssFeedInput): string;
+/** CmsPostContent[] → RSS item[]. postUrl 로 글 절대 URL 생성. */
+declare function rssItemsFromPosts(posts: CmsPostContent[], opts: {
+    postUrl: (post: CmsPostContent) => string;
+}): RssItemInput[];
+type JsonLd = Record<string, unknown>;
+interface ArticleSchemaInput {
+    headline: string;
+    url: string;
+    description?: string | null;
+    image?: string | null;
+    datePublished?: string | Date | null;
+    dateModified?: string | Date | null;
+    authorName?: string | null;
+    publisherName?: string;
+    publisherLogo?: string;
+}
+declare function articleSchema(input: ArticleSchemaInput): JsonLd;
+declare function breadcrumbSchema(items: {
+    name: string;
+    url: string;
+}[]): JsonLd;
+declare function organizationSchema(input: {
+    name: string;
+    url: string;
+    logo?: string;
+    sameAs?: string[];
+}): JsonLd;
+/**
+ * `localBusinessSchema` 입력 — `fetchBusinessProfile` 의 반환값
+ * (RootTaleBusinessProfile) 을 그대로 받도록 느슨하게 정의 (null/undefined 모두
+ * 허용). 수동 구성도 가능.
+ */
+interface LocalBusinessProfileInput {
+    name: string;
+    legalName?: string | null;
+    /** Schema.org LocalBusiness 하위 타입. 미지정 시 "LocalBusiness". */
+    businessType?: string | null;
+    telephone?: string | null;
+    email?: string | null;
+    address?: {
+        streetAddress: string;
+        addressLocality: string;
+        addressRegion?: string | null;
+        postalCode?: string | null;
+    } | null;
+    geo?: {
+        latitude: number;
+        longitude: number;
+    } | null;
+    openingHours?: {
+        days: string[];
+        opens: string;
+        closes: string;
+    }[] | null;
+    priceRange?: string | null;
+    areaServed?: string[] | null;
+    /** 외부 프로필 URL — 값들이 sameAs 로 들어간다 (네이버플레이스·구글 등). */
+    profiles?: Record<string, string | null | undefined> | null;
+}
+/**
+ * LocalBusiness JSON-LD — admin "운영 > 비즈니스 프로필" 의
+ * `fetchBusinessProfile` 결과로 layout 에 1회 렌더한다 (로컬 SEO).
+ *
+ * - `@type` 은 `[businessType, "LocalBusiness"]` 중복 제거 배열.
+ * - `profiles` 의 URL 들은 `sameAs` 로 — 검색엔진이 네이버플레이스/구글
+ *   비즈니스 프로필과 동일 사업장임을 연결한다.
+ */
+declare function localBusinessSchema(profile: LocalBusinessProfileInput | RootTaleBusinessProfile, opts: {
+    url: string;
+    image?: string | null;
+}): JsonLd;
+declare function websiteSchema(input: {
+    name: string;
+    url: string;
+    searchUrl?: string;
+}): JsonLd;
+declare function faqSchema(qa: {
+    question: string;
+    answer: string;
+}[]): JsonLd;
+/** JSON-LD 객체 → `<script type="application/ld+json">` HTML 문자열 (XSS-safe). */
+declare function jsonLdScript(schema: JsonLd | JsonLd[]): string;
+
+/**
+ * `@roottale/cms-client` — 리드(문의) 접수 server-side 헬퍼.
+ *
+ * 외부 고객사 사이트가 *블로그 조회(`fetchPosts`)와 동일한 API key 하나* 로 리드도
+ * 접수하기 위한 SSR-only 클라이언트. 브라우저가 아니라 사이트 서버(Server Action /
+ * Route Handler)에서 호출해야 한다 — API key 는 절대 브라우저로 노출 금지
+ * (ADR-0023 §5.1 #15). 키가 tenant 를 권위 식별하므로 `tenant_slug` 불필요.
+ *
+ * 사용 예 (Next.js server action):
+ * ```ts
+ * "use server";
+ * import { submitInquiry } from "@roottale/cms-client/server";
+ *
+ * const result = await submitInquiry({
+ *   apiKey: process.env.ROOTTALE_API_KEY!,   // fetchPosts 와 같은 키
+ *   fields: {
+ *     vertical: "tax",
+ *     contactName: name,
+ *     businessName: company,
+ *     email,
+ *     phone,
+ *     message,
+ *     privacyConsent: true,
+ *   },
+ * });
+ * if (result.ok) showSuccess();   // 그 키의 tenant /crm 에 도착
+ * else showError(result.message);
+ * ```
+ *
+ * intake API 는 302 `?ok=1` / `?err=*` 로 응답 — 본 헬퍼가 파싱해 구조화 결과 반환.
+ */
+
+type InquiryVertical = "consulting" | "medical" | "tax" | "legal";
+/** intake API 의 `err` 코드 → 한국어 사용자 메시지. */
+declare const INQUIRY_ERROR_MESSAGES: Record<string, string>;
+interface SubmitInquiryFields {
+    vertical: InquiryVertical;
+    contactName: string;
+    businessName: string;
+    email: string;
+    phone: string;
+    /** 자유 문의 내용 (선택). */
+    message?: string;
+    /** 상담 분야 라벨 등 부가 메타 (선택). */
+    consultationField?: string;
+    /** 현재 사이트 URL (선택). */
+    currentSiteUrl?: string;
+    /** 개인정보 수집·이용 동의 (필수 true). */
+    privacyConsent: boolean;
+    /** 의료 vertical 의 국외이전 동의 (medical 일 때 필수). */
+    overseasTransferConsent?: boolean;
+    /**
+     * "patient"(고객사 방문자 문의, 기본) | "sales"(RootTale 자체 B2B 영업 리드).
+     * sales 는 medical 국외이전 동의 게이트 면제.
+     */
+    leadKind?: "patient" | "sales";
+    /**
+     * 표준 필드 외에 폼이 받은 임의 항목(key→value)을 있는 그대로 전달. intake 가
+     * 암호화 보관하고 CRM 상세에서 노출한다. 예약 키(표준 필드)·`_` 접두 키는 무시.
+     * 주의: 개인정보가 담길 수 있으므로 폼의 동의 고지에 수집 항목을 반영할 것.
+     */
+    extras?: Record<string, string>;
+    /**
+     * 유입 first-touch 어트리뷰션 (ADR-0048 §2, 선택). 브라우저에서
+     * `readAttribution()`(`@roottale/cms-client/attribution`)으로 읽어 Server
+     * Action 인자로 넘긴 값을 그대로 전달하면 된다. CRM 에 "이 문의가 어느
+     * 글/링크/QR 에서 왔는지"가 표시된다. null/undefined 면 미동반 제출.
+     */
+    attribution?: InquiryAttribution | null;
+}
+interface SubmitInquiryOptions {
+    /** `rtlk_cust_*` API key — `fetchPosts` 와 동일한 키. Required. */
+    apiKey: string;
+    /** API base URL 오버라이드. 기본 `https://api.roottale.com`. */
+    baseUrl?: string;
+    fields: SubmitInquiryFields;
+    signal?: AbortSignal;
+}
+type SubmitInquiryResult = {
+    ok: true;
+} | {
+    ok: false;
+    code: string | null;
+    message: string;
+};
+/** `err` 코드를 사용자 메시지로 (미지의 코드는 generic). */
+declare function inquiryErrorMessage(code: string | null | undefined): string;
+/**
+ * intake API 의 302 Location (`?ok=1` / `?err=*`) 을 구조화 결과로 파싱.
+ * 외부 사이트가 ERROR_MESSAGES·파싱을 각자 재구현하지 않도록 공유.
+ */
+declare function parseInquiryRedirect(location: string | null, base?: string): SubmitInquiryResult;
+declare function formatKoreanPhoneNumber(input: string): string;
+/**
+ * 리드를 RootTale intake API 로 제출 (server-to-server, Bearer 인증).
+ * 키의 tenant 로 라우팅되어 admin(mysite.roottale.com) /crm 에서 관리된다.
+ */
+declare function submitInquiry(options: SubmitInquiryOptions): Promise<SubmitInquiryResult>;
+
+export { type AnalyticsTagConfig, type AnalyticsTagProvider, type ArticleSchemaInput, type BusinessDayCode, type BusinessOpeningHours, type BusinessType, CMS_CLIENT_VERSION, CmsApiError, type CmsPostContent, type CmsPostContentPage, type CmsPostType, type CmsRouteCollection, type CmsSearchHit, type CmsTaxonomyKind, type CmsTermRef, DEFAULT_BLOG_SETTINGS, type FetchAnalyticsOptions, type FetchBlogSettingsOptions, type FetchBusinessProfileOptions, type FetchCollectionsOptions, type FetchMenuOptions, type FetchMenusOptions, type FetchPostOptions, type FetchPostsOptions, type FetchThemeOptions, INQUIRY_ERROR_MESSAGES, InquiryAttribution, type InquiryVertical, type LocalBusinessProfileInput, type ResolvedPostDisplay, type RootTaleBlogSettings, type RootTaleBusinessProfile, type RootTaleMenu, type RootTaleMenuItem, type RootTaleTheme, type RssFeedInput, type RssItemInput, type SearchPostsOptions, type SiteAnalyticsTags, type SubmitInquiryFields, type SubmitInquiryOptions, type SubmitInquiryResult, articleSchema, breadcrumbSchema, businessProfileFromWire, faqSchema, fetchAnalyticsConfig, fetchBlogSettings, fetchBusinessProfile, fetchCollections, fetchCollectionsSafeDefault, fetchMenu, fetchMenus, fetchPost, fetchPosts, fetchTheme, formatKoreanPhoneNumber, generateRssXml, inquiryErrorMessage, jsonLdScript, localBusinessSchema, organizationSchema, parseInquiryRedirect, resolvePostDisplay, rssItemsFromPosts, searchPosts, submitInquiry, websiteSchema };