npm - @brainerce/mcp-server - Versions diffs - 3.7.0 → 3.8.0 - Mend

@brainerce/mcp-server 3.7.0 → 3.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (7) hide show

package/dist/bin/stdio.js CHANGED Viewed

@@ -2200,9 +2200,12 @@ export async function generateMetadata({ params }: Props): Promise<Metadata> {
   const client = getServerClient();
   client.setLocale(locale);
   const product = await client.getProductBySlug(slug);
+  // NEVER feed raw HTML into <meta name="description"> \u2014 product.description
+  // is often rich-text HTML. Strip tags first, then truncate on a word
+  // boundary. See buildMetaDescription() in lib/seo.ts.
   return {
     title: product.seoTitle || product.name,
-    description: product.seoDescription || product.description?.slice(0, 160),
+    description: product.seoDescription || buildMetaDescription(product.description) || product.name,
   };
 }
 \`\`\`
@@ -2318,11 +2321,25 @@ Because the backend already overlays everything, UI code is just:
 ### RTL handling
-For RTL locales (\`he\`, \`ar\`), set \`<html dir="rtl">\` in the root layout and
-let flexbox reverse automatically. Do NOT add \`flex-row-reverse\` on top of
-\`dir="rtl"\` \u2014 that's a double-swap. DO swap directional icons (chevrons,
-arrows) manually. Use logical CSS properties (\`ms-*\`/\`me-*\`) instead of
-\`ml-*\`/\`mr-*\`.
+Resolve direction with \`client.getStoreDirection(locale)\` \u2014 it returns
+\`'ltr' | 'rtl'\` for any BCP-47 tag (Arabic, Hebrew, Persian, Urdu, Yiddish
+today; future RTL locales added by the platform are picked up automatically).
+Do NOT maintain your own RTL locale set.
+\`\`\`tsx
+// app/[locale]/layout.tsx
+const dir = client.getStoreDirection(locale);
+return <html lang={locale} dir={dir}>...</html>;
+\`\`\`
+For static rendering, \`storeInfo.i18n.defaultDirection\` carries the store's
+default direction, and each entry in \`storeInfo.i18n.supportedLocaleObjects\`
+includes its own \`direction\`.
+Let flexbox reverse automatically once \`<html dir="rtl">\` is set. Do NOT add
+\`flex-row-reverse\` on top \u2014 that's a double-swap. DO swap directional icons
+(chevrons, arrows) manually. Use logical CSS properties (\`ms-*\`/\`me-*\`)
+instead of \`ml-*\`/\`mr-*\`.
 ### Language switcher
@@ -2699,6 +2716,141 @@ and a \`newsletter\` form embedded in the footer), render each form from its
 own \`contactForms.get(key, locale)\` call. The \`formKey\` you pass to
 \`createInquiry\` must match.`;
 }
+function getContentSection() {
+  return `## Content \u2014 typed merchant content store
+Brainerce ships a typed content store so merchants can edit site chrome, FAQ,
+static pages, and inline rich-text blocks in the dashboard \u2014 without
+re-prompting the AI that built their storefront. Every row has a \`type\` +
+\`key\` + typed \`data\` payload + free-form \`customFields\`.
+**Six content types.** Each one has a fixed \`data\` shape; the SDK's TypeScript
+generics keep them in lockstep:
+| Type           | Use for                                | \`data\` shape (abbreviated) |
+| -------------- | -------------------------------------- | --------------------------- |
+| \`FAQ\`         | Q/A accordions                         | \`{ items: { question, answer }[] }\` |
+| \`FOOTER\`      | Site footer (chrome)                   | \`{ columns, copyright?, social? }\` |
+| \`HEADER\`      | Top nav + logo + CTA (chrome)          | \`{ logo?, navItems, cta? }\` |
+| \`ANNOUNCEMENT\`| Banners; time-bound by \`startsAt/endsAt\` | \`{ message, severity, dismissible, ... }\` |
+| \`RICH_TEXT\`   | Free-form HTML blocks embedded inline  | \`{ html }\` |
+| \`PAGE\`        | Static pages with slug + SEO           | \`{ slug, title, html, seo? }\` |
+Run \`get-type-definitions\` with \`domain: 'content'\` for the full interfaces.
+### Default key
+Every type has \`'main'\` as its universal default key. \`client.content.faq.get()\`
+with no arguments resolves to \`key='main'\`. Topical keys (\`'shipping'\`,
+\`'holiday-2026'\`, \`'about'\`) are merchant-named.
+### Reading content (any SDK mode)
+Public reads work in vibe-coded mode, storefront mode, and admin mode. They
+return \`null\` on 404 \u2014 render hard-coded fallbacks so the page never crashes
+when the merchant hasn't seeded yet.
+\`\`\`ts
+// Single entry, default key 'main', resolved to a locale
+const faq = await client.content.faq.get('main', locale);
+if (faq) {
+  faq.data.items.forEach(({ question, answer }) => {
+    // Render question + sanitize(answer)
+  });
+}
+// All entries of a type
+const allFaqs = await client.content.faq.list(locale);
+// Page by URL slug \u2014 for app/[slug]/page.tsx
+const page = await client.content.page.getBySlug(slug, locale);
+if (!page) notFound();
+\`\`\`
+### Security \u2014 sanitize HTML before rendering
+\`FAQ.items[i].answer\`, \`RICH_TEXT.html\`, and \`PAGE.html\` carry
+MERCHANT-AUTHORED HTML. The server does NOT pre-sanitize \u2014 some merchants
+embed iframes (e.g. YouTube) which strict sanitizers would strip. ALWAYS
+sanitize on the storefront before injecting:
+\`\`\`ts
+// Recommended: isomorphic-dompurify
+import DOMPurify from 'isomorphic-dompurify';
+const safe = DOMPurify.sanitize(rawHtml);
+<div dangerouslySetInnerHTML={{ __html: safe }} />;
+\`\`\`
+Skipping this is XSS.
+### Custom fields
+Every Content row carries a free-form \`customFields: Record<string, string>\`.
+Merchants add arbitrary key-value extras (\`helpEmail\`, \`phoneNumber\`,
+\`foundedYear\`) that you can opt into reading:
+\`\`\`ts
+const faq = await client.content.faq.get('shipping');
+<a href={\`mailto:\${faq.customFields.helpEmail}\`}>Need help?</a>
+\`\`\`
+The shape is whatever the merchant entered. Read keys you expect; ignore the rest.
+### Locale resolution
+All public reads accept a \`locale\` argument. The server resolves
+\`translations[locale]\` server-side and returns the resolved \`data\` payload \u2014
+the storefront does NOT need to do its own overlay. Empty / missing translations
+fall through to the default-locale value.
+### Cache
+Public reads carry \`Cache-Control: public, max-age=300, stale-while-revalidate=60\`.
+Merchant edits propagate within ~5 minutes. Don't layer extra client-side
+caching beyond Next.js's default fetch cache.
+### Admin writes (apiKey mode)
+\`\`\`ts
+const adminClient = new BrainerceClient({ apiKey: process.env.BRAINERCE_API_KEY });
+// Create \u2014 always starts in DRAFT
+const faq = await adminClient.content.faq.create({
+  key: 'shipping',
+  name: 'Shipping FAQ',
+  data: { items: [{ question: 'How long?', answer: 'Most orders ship in 2 days.' }] },
+});
+// Update (data replaces wholesale; last-write-wins on the data field)
+await adminClient.content.update(faq.id, {
+  data: { items: [{ question: 'How long?', answer: 'Updated answer.' }] },
+});
+// Publish / unpublish
+await adminClient.content.publish(faq.id);
+await adminClient.content.unpublish(faq.id);
+// Hard delete
+await adminClient.content.remove(faq.id);
+\`\`\`
+Write operations throw if called from vibe-coded or storefront mode.
+### Reserved key convention
+\`'main'\` is reserved as the universal default. Don't use it for topical
+entries \u2014 pick a descriptive slug (\`'shipping'\`, \`'returns'\`, \`'about'\`,
+\`'holiday-2026'\`). The validation rule is \`^[a-z][a-z0-9-]*$\`, max 64 chars.
+### See also
+- \`get-business-flows\` with \`flow: 'content-bootstrap'\` for the full
+  layout / FAQ / page recipe.
+- \`get-required-features\` lists each Content surface (\`site-header\`,
+  \`site-footer\`, \`announcement-bar\`, \`faq-page\`, \`static-pages\`).
+- \`get-type-definitions\` with \`domain: 'content'\` for the TypeScript
+  interfaces.`;
+}
 function getSectionByTopic(topic, connectionId, currency) {
   const cid = connectionId || "vc_YOUR_CONNECTION_ID";
   const cur = currency || "USD";
@@ -2745,6 +2897,8 @@ function getSectionByTopic(topic, connectionId, currency) {
       return getAdminApiSection();
     case "inquiries":
       return getContactInquiriesSection();
+    case "content":
+      return getContentSection();
     case "all":
       return [
         "# Brainerce SDK \u2014 full topic dump",
@@ -2833,10 +2987,14 @@ function getSectionByTopic(topic, connectionId, currency) {
         "",
         "---",
         "",
-        getContactInquiriesSection()
+        getContactInquiriesSection(),
+        "",
+        "---",
+        "",
+        getContentSection()
       ].join("\n");
     default:
-      return `Unknown topic: "${topic}". Available topics: setup, products, cart, checkout, checkout-custom-fields, payment, auth, order-confirmation, inventory, discounts, recommendations, product-customization-fields, tax, i18n, critical-rules, type-reference, admin, inquiries, all`;
+      return `Unknown topic: "${topic}". Available topics: setup, products, cart, checkout, checkout-custom-fields, payment, auth, order-confirmation, inventory, discounts, recommendations, product-customization-fields, tax, i18n, critical-rules, type-reference, admin, inquiries, content, all`;
   }
 }
@@ -2864,6 +3022,7 @@ var GET_SDK_DOCS_SCHEMA = {
     "i18n",
     "admin",
     "inquiries",
+    "content",
     "all"
   ]).describe("The SDK documentation topic to retrieve"),
   salesChannelId: import_zod.z.string().optional().describe("Sales channel ID (starts with vc_). Used to personalize setup code."),
@@ -3856,6 +4015,156 @@ export interface ModifierValidationError {
 // The cart line then carries:
 //   cart.items[i].modifiers      \u2014 CartItemModifierLine[]
 //   cart.items[i].modifiersTotal \u2014 decimal string of the paid (non-free) deltas`;
+var CONTENT_TYPES = `// ---- Content (typed merchant content store) ----
+// Brainerce ships a typed content store so merchants can edit FAQ, footer,
+// header, announcements, rich text, and static pages in the dashboard
+// without re-prompting the AI that built the storefront. Every row has a
+// 'type' + 'key' + typed 'data' payload + free-form 'customFields'.
+//
+// SECURITY (read carefully):
+//   RICH_TEXT.html, PAGE.html, and FAQ answers are MERCHANT-AUTHORED HTML.
+//   ALWAYS sanitize with isomorphic-dompurify (or equivalent) before
+//   injecting via dangerouslySetInnerHTML. The server does NOT pre-sanitize
+//   because some merchants embed iframes (e.g. YouTube) which strict
+//   sanitizers would strip; the storefront chooses the policy.
+//
+// 404 contract: client.content.<type>.get(key) returns null when no
+// PUBLISHED row exists. Always render a hard-coded fallback on null so
+// the page never crashes when the merchant hasn't seeded yet.
+//
+// Default key: every type has 'main' as its universal default. Pass no
+// argument to fetch the main entry; pass a custom key ('shipping',
+// 'holiday-2026', 'about') for topical entries.
+export type ContentType = 'FAQ' | 'FOOTER' | 'HEADER' | 'ANNOUNCEMENT' | 'RICH_TEXT' | 'PAGE';
+export type ContentStatus = 'DRAFT' | 'PUBLISHED';
+export interface FaqItem {
+  question: string;
+  /** Sanitized HTML \u2014 sanitize before rendering. */
+  answer: string;
+}
+export interface FaqContent { items: FaqItem[] }
+export interface FooterLink { label: string; url: string }
+export interface FooterColumn { title: string; links: FooterLink[] }
+export interface FooterSocialLink { platform: string; url: string } // 'instagram' | 'facebook' | 'x' | ...
+export interface FooterContent {
+  columns: FooterColumn[];
+  copyright?: string;
+  social?: FooterSocialLink[];
+}
+export interface HeaderLogo { src: string; alt: string }
+export interface HeaderNavItem { label: string; url: string }
+export interface HeaderCta { label: string; url: string }
+export interface HeaderContent {
+  logo?: HeaderLogo;
+  navItems: HeaderNavItem[];
+  cta?: HeaderCta;
+}
+export type AnnouncementSeverity = 'info' | 'warning' | 'success';
+export interface AnnouncementContent {
+  message: string;
+  severity: AnnouncementSeverity;
+  dismissible: boolean;
+  /** ISO 8601 \u2014 filter client-side. */
+  startsAt?: string;
+  endsAt?: string;
+  ctaLabel?: string;
+  ctaHref?: string;
+}
+export interface RichTextContent {
+  /** Raw HTML \u2014 sanitize before rendering. */
+  html: string;
+}
+export interface PageSeo {
+  title?: string;
+  description?: string;
+  ogImage?: string;
+}
+export interface PageContent {
+  /** URL slug, lower-kebab. */
+  slug: string;
+  title: string;
+  /** Raw HTML \u2014 sanitize before rendering. */
+  html: string;
+  seo?: PageSeo;
+}
+export interface ContentSummary {
+  id: string;
+  type: ContentType;
+  key: string;
+  name: string;
+  status: ContentStatus;
+  position: number;
+  updatedAt: string;
+}
+export interface Content<T extends ContentType = ContentType> extends ContentSummary {
+  type: T;
+  data: T extends 'FAQ' ? FaqContent
+      : T extends 'FOOTER' ? FooterContent
+      : T extends 'HEADER' ? HeaderContent
+      : T extends 'ANNOUNCEMENT' ? AnnouncementContent
+      : T extends 'RICH_TEXT' ? RichTextContent
+      : T extends 'PAGE' ? PageContent
+      : never;
+  /** Free-form merchant-defined extras. Read keys the merchant told you to expect. */
+  customFields: Record<string, string>;
+  salesChannelIds: string[];
+}
+// ---- SDK usage examples ----
+//
+// FAQ \u2014 render an accordion from the main FAQ (or a topical one):
+//   const faq = await client.content.faq.get('main', locale);  // 'shipping', 'returns', ...
+//   if (faq) {
+//     faq.data.items.forEach(({ question, answer }) => {
+//       // Render question + sanitize(answer) \u2014 never inject raw HTML.
+//     });
+//   }
+//
+// Footer \u2014 server component in root layout:
+//   const footer = await client.content.footer.get('main', locale);
+//   if (!footer) return <Fallback />;
+//   // Render footer.data.columns, footer.data.social, footer.data.copyright
+//
+// Header \u2014 same pattern as footer:
+//   const header = await client.content.header.get('main', locale);
+//
+// Announcement \u2014 multiple may be active; filter by date client-side:
+//   const announcements = await client.content.announcement.list(locale);
+//   const now = Date.now();
+//   const active = announcements.filter((a) => {
+//     const startOk = !a.data.startsAt || new Date(a.data.startsAt).getTime() <= now;
+//     const endOk = !a.data.endsAt || new Date(a.data.endsAt).getTime() >= now;
+//     return startOk && endOk;
+//   });
+//
+// Rich text \u2014 inline block anywhere on a page:
+//   const block = await client.content.richText.get('about-intro', locale);
+//   <div dangerouslySetInnerHTML={{ __html: sanitize(block.data.html) }} />
+//
+// Page \u2014 catch-all route by slug (e.g. /about, /terms, /privacy):
+//   // app/[slug]/page.tsx
+//   const page = await client.content.page.getBySlug(params.slug, locale);
+//   if (!page) notFound();
+//   // page.data.title, page.data.html, page.data.seo
+//   return <article dangerouslySetInnerHTML={{ __html: sanitize(page.data.html) }} />;
+//
+// Custom fields \u2014 every Content row carries a free-form Record<string, string>:
+//   const faq = await client.content.faq.get('shipping');
+//   <a href={\`mailto:\${faq.customFields.helpEmail}\`}>Need help?</a>
+//
+// Cache \u2014 public reads carry Cache-Control: public, max-age=300,
+// stale-while-revalidate=60. Storefront changes propagate within ~5 min
+// of the merchant publishing. Do not add extra client-side caching
+// beyond Next.js's default fetch cache.`;
 var TYPES_BY_DOMAIN = {
   products: PRODUCTS_TYPES,
   cart: CART_TYPES,
@@ -3866,7 +4175,8 @@ var TYPES_BY_DOMAIN = {
   helpers: HELPERS_TYPES,
   inquiries: INQUIRIES_TYPES,
   reviews: REVIEWS_TYPES,
-  "modifier-groups": MODIFIER_GROUPS_TYPES
+  "modifier-groups": MODIFIER_GROUPS_TYPES,
+  content: CONTENT_TYPES
 };
 function getTypesByDomain(domain) {
   if (domain === "all") {
@@ -3897,9 +4207,10 @@ var GET_TYPE_DEFINITIONS_SCHEMA = {
     "helpers",
     "inquiries",
     "reviews",
+    "content",
     "all"
   ]).describe(
-    'The domain of types to retrieve. Use "helpers" for helper function signatures and common types like StoreInfo, PaginatedResponse.'
+    'The domain of types to retrieve. Use "helpers" for helper function signatures and common types like StoreInfo, PaginatedResponse. Use "content" for FAQ / Footer / Header / Announcement / RichText / Page.'
   )
 };
 async function handleGetTypeDefinitions(args) {
@@ -4446,8 +4757,10 @@ client.setLocale(locale);
 // order bumps, search suggestions, discount banners, nudges,
 // badges, order history.
-// For RTL locales (he, ar), set the document direction.
-// Framework-neutral: document.documentElement.setAttribute('dir', 'rtl');`,
+// For RTL direction, do not hardcode the locale list. Ask the SDK:
+//   const dir = client.getStoreDirection(currentLocale); // 'ltr' | 'rtl'
+//   document.documentElement.setAttribute('dir', dir);
+// (Or in React: <html dir={dir}>...</html>.)`,
   "order-history-full": `// Full "My Orders" account page. Render every piece of data the server
 // already returns \u2014 not just order number / total / status.
 //
@@ -5539,7 +5852,7 @@ var RULES = {
     body: `- NEVER hardcode currency, locale, or language strings. Read them from \`get-store-info\` / \`get-store-capabilities\` and use the configured values.
 - NEVER format prices with \`toFixed(2)\` or custom logic. Use \`formatPrice()\` from the SDK \u2014 it honors the store's currency and locale.
 - When the store has i18n enabled (\`capabilities.store.i18n.enabled === true\`), you MUST call \`client.setLocale(locale)\` at app init and include a language switcher. All SDK reads will then return localized content automatically.
-- For RTL locales (\`he\`, \`ar\`), set the document direction to RTL. Do not manually reverse flex layouts \u2014 the platform's CSS reversal handles it.`
+- For RTL direction, do NOT maintain a local list of RTL locales. Call \`client.getStoreDirection(locale)\` \u2014 it returns \`'ltr' | 'rtl'\` for any BCP-47 tag (covers Arabic, Hebrew, Persian, Urdu, Yiddish, and any future RTL locales the platform adds). Set \`<html dir={...}>\` from this value. The platform's CSS reversal handles flex layouts \u2014 do not manually swap them.`
   },
   types: {
     title: "Type safety",
@@ -5587,6 +5900,7 @@ var GET_BUSINESS_FLOWS_SCHEMA = {
     "cart-persistence",
     "inventory-reservation",
     "product-customization",
+    "content-bootstrap",
     "all"
   ]).describe('Which flow to retrieve. Use "all" to get every flow.')
 };
@@ -5777,6 +6091,76 @@ Server-side guardrails that WILL reject bad requests (so validate client-side to
 - More than 10 uploads per IP per minute \u2192 429.
 Never render customization fields without also wiring the upload + metadata flow \u2014 a form that submits nothing is worse than no form at all.`
+  },
+  "content-bootstrap": {
+    title: "Content Bootstrap \u2014 site chrome & static content",
+    body: `Every Brainerce storefront should render merchant-defined site chrome (header, footer, announcements, FAQ, static pages) from the Content API. The merchant edits these in the Brainerce dashboard; storefronts pick up changes within ~5 minutes (public reads carry \`Cache-Control: public, max-age=300, stale-while-revalidate=60\`).
+1. **Fetch chrome at the root layout** (server component if Next.js). All three return \`null\` on 404 \u2014 render hard-coded fallbacks so the page never crashes when the merchant hasn't seeded yet.
+   \`\`\`ts
+   const [header, footer, announcements] = await Promise.all([
+     client.content.header.get('main', locale),
+     client.content.footer.get('main', locale),
+     client.content.announcement.list(locale),
+   ]);
+   \`\`\`
+2. **FAQ \u2014 fetch lazily on the FAQ page.** Default key is \`'main'\`; pass a topical key (\`'shipping'\`, \`'returns'\`) for sub-FAQs.
+   \`\`\`ts
+   const faq = await client.content.faq.get('main', locale);
+   if (faq) {
+     faq.data.items.forEach(({ question, answer }) => {
+       // sanitize(answer) \u2014 see step 4
+     });
+   }
+   \`\`\`
+3. **Static pages \u2014 catch-all route by slug:**
+   \`\`\`tsx
+   // app/[slug]/page.tsx
+   export default async function Page({ params }) {
+     const page = await client.content.page.getBySlug(params.slug, locale);
+     if (!page) notFound();
+     return (
+       <article dangerouslySetInnerHTML={{ __html: sanitize(page.data.html) }} />
+     );
+   }
+   \`\`\`
+4. **SECURITY \u2014 sanitize HTML before rendering.** \`FAQ.items[i].answer\`, \`PAGE.html\`, and \`RICH_TEXT.html\` are merchant-authored HTML. The server does NOT pre-sanitize because some merchants embed iframes (e.g. YouTube). Always sanitize at the edge of your render:
+   \`\`\`ts
+   import DOMPurify from 'isomorphic-dompurify';
+   const safe = DOMPurify.sanitize(rawHtml);
+   <div dangerouslySetInnerHTML={{ __html: safe }} />;
+   \`\`\`
+   Skipping this is XSS.
+5. **Announcements \u2014 multiple may be active; filter by date client-side:**
+   \`\`\`ts
+   const now = Date.now();
+   const visible = announcements.filter((a) => {
+     const startOk = !a.data.startsAt || new Date(a.data.startsAt).getTime() <= now;
+     const endOk = !a.data.endsAt || new Date(a.data.endsAt).getTime() >= now;
+     return startOk && endOk;
+   });
+   \`\`\`
+6. **RTL direction \u2014 call \`client.getStoreDirection(locale)\`:**
+   \`\`\`tsx
+   const dir = client.getStoreDirection(locale);
+   <html lang={locale} dir={dir}>...</html>
+   \`\`\`
+   Do NOT maintain a local RTL locale set \u2014 the SDK helper covers Arabic / Hebrew / Persian / Urdu / Yiddish today and picks up any future RTL locale automatically.
+7. **Custom fields \u2014 every Content row has free-form \`customFields: Record<string, string>\`.** Read keys the merchant told you to expect:
+   \`\`\`ts
+   const faq = await client.content.faq.get('shipping');
+   <a href={\`mailto:\${faq.customFields.helpEmail}\`}>Need help?</a>
+   \`\`\`
+8. **Cache:** public reads carry \`Cache-Control: public, max-age=300, stale-while-revalidate=60\`. Don't add extra client-side caching beyond Next.js's default fetch cache \u2014 merchants expect their edits to appear within ~5 minutes.
+**Translations.** All public reads accept a \`locale\` argument; the server resolves \`translations[locale]\` server-side. Empty / missing overlays fall through to the default-locale value. The storefront does NOT need to do its own per-field overlay \u2014 call with the active locale and render what comes back.`
   }
 };
 var FLOW_ORDER = [
@@ -5788,7 +6172,8 @@ var FLOW_ORDER = [
   "order-confirmation",
   "cart-persistence",
   "inventory-reservation",
-  "product-customization"
+  "product-customization",
+  "content-bootstrap"
 ];
 async function handleGetBusinessFlows(args) {
   const header = "# Brainerce Business Flows\n\nThese sequences are framework-neutral and non-negotiable. Your framework and file layout are your choice \u2014 the order of SDK calls and the error handling is not.";
@@ -6000,11 +6385,57 @@ var FEATURES = [
   {
     id: "i18n",
     title: "Serve multiple languages with a language switcher",
-    description: "When i18n is enabled, the experience routes by locale, sets the SDK locale (client.setLocale), includes a language switcher in the header, and renders RTL locales (he, ar) with the correct document direction.",
-    sdk: "client.setLocale(locale). Read supported locales from get-store-capabilities.store.i18n.",
+    description: "When i18n is enabled, the experience routes by locale, sets the SDK locale (client.setLocale), includes a language switcher in the header, and renders the correct document direction by reading client.getStoreDirection(locale) \u2014 do not hardcode an RTL locale set.",
+    sdk: "client.setLocale(locale). client.getStoreDirection(locale) for <html dir>. Read supported locales from get-store-capabilities.store.i18n.",
     mandatory: "conditional",
     capabilityFlag: "i18n",
     whenDisabledNote: "This store is single-language. Do not build the language switcher."
+  },
+  {
+    id: "site-header",
+    title: "Site header from merchant content (logo + nav + CTA)",
+    description: 'Fetch client.content.header.get("main", locale) in the root layout. Returns null when the merchant has not seeded yet \u2014 render a hard-coded fallback so the page never crashes. Renders header.data.logo, header.data.navItems[], header.data.cta if present.',
+    sdk: 'client.content.header.get("main", locale)',
+    flowRef: "content-bootstrap",
+    mandatory: "mandatory"
+  },
+  {
+    id: "site-footer",
+    title: "Site footer from merchant content (columns + social + copyright)",
+    description: 'Fetch client.content.footer.get("main", locale) in the root layout. Returns null when unseeded \u2014 render a hard-coded fallback. Render footer.data.columns[].links, footer.data.social[], footer.data.copyright.',
+    sdk: 'client.content.footer.get("main", locale)',
+    flowRef: "content-bootstrap",
+    mandatory: "mandatory"
+  },
+  {
+    id: "announcement-bar",
+    title: "Announcement bar at the top of every page",
+    description: "Fetch client.content.announcement.list(locale) in the root layout. Filter by data.startsAt / data.endsAt client-side. Render a dismissible bar when data.dismissible=true. Build the UI anyway \u2014 it auto-hides when no announcements exist.",
+    sdk: "client.content.announcement.list(locale)",
+    flowRef: "content-bootstrap",
+    mandatory: "conditional",
+    capabilityFlag: "hasContent",
+    whenDisabledNote: "Store has no published Content rows yet. Build the announcement bar anyway \u2014 it auto-hides on empty."
+  },
+  {
+    id: "faq-page",
+    title: "FAQ page rendered from merchant content",
+    description: 'Build /faq as an accordion fed by client.content.faq.get("main", locale). For topical FAQs, use a key parameter (shipping, returns, ...). Always sanitize answer HTML before injecting via dangerouslySetInnerHTML. Build the page anyway \u2014 it auto-hides or 404s when no FAQ rows exist.',
+    sdk: 'client.content.faq.get("main", locale), client.content.faq.list(locale)',
+    flowRef: "content-bootstrap",
+    mandatory: "conditional",
+    capabilityFlag: "hasContent",
+    whenDisabledNote: "No FAQ content yet. Build /faq anyway \u2014 it auto-hides on empty."
+  },
+  {
+    id: "static-pages",
+    title: "Static pages from merchant content (About, Terms, Privacy, \u2026)",
+    description: "Mount a catch-all app/[slug]/page.tsx route. Inside, call client.content.page.getBySlug(params.slug, locale). On null \u2192 notFound(). On hit, sanitize page.data.html before injecting via dangerouslySetInnerHTML. Generate <Metadata> from page.data.seo. Build the route anyway \u2014 it 404s on unknown slugs.",
+    sdk: "client.content.page.getBySlug(slug, locale), client.content.page.list(locale)",
+    flowRef: "content-bootstrap",
+    mandatory: "conditional",
+    capabilityFlag: "hasContent",
+    whenDisabledNote: "No static pages yet. Build the catch-all route anyway \u2014 it 404s on unknown slugs."
   }
 ];
 function isFeatureActive(feature, caps) {
@@ -6055,6 +6486,7 @@ function renderCapabilitiesSummary(caps) {
   );
   lines.push(`- Downloadable products: ${caps.features.hasDownloadableProducts ? "yes" : "no"}`);
   lines.push(`- Checkout custom fields: ${caps.features.hasCheckoutCustomFields ? "yes" : "no"}`);
+  lines.push(`- Content (FAQ/footer/header/announcements/pages): ${caps.features.hasContent ? "seeded" : "none \u2014 build chrome UI with fallbacks"}`);
   lines.push(
     `- Email verification: ${caps.connection.requireEmailVerification ? "required" : "not required (still build the verify-email flow)"}`
   );

package/dist/index.d.mts CHANGED Viewed

@@ -76,6 +76,8 @@ interface StoreCapabilities {
         hasDownloadableProducts: boolean;
         hasCoupons: boolean;
         hasCheckoutCustomFields: boolean;
+        /** True when at least one PUBLISHED Content row exists for the store. */
+        hasContent?: boolean;
     };
 }
 declare function fetchStoreCapabilities(connectionId: string, baseUrl?: string): Promise<StoreCapabilities>;

package/dist/index.d.ts CHANGED Viewed

@@ -76,6 +76,8 @@ interface StoreCapabilities {
         hasDownloadableProducts: boolean;
         hasCoupons: boolean;
         hasCheckoutCustomFields: boolean;
+        /** True when at least one PUBLISHED Content row exists for the store. */
+        hasContent?: boolean;
     };
 }
 declare function fetchStoreCapabilities(connectionId: string, baseUrl?: string): Promise<StoreCapabilities>;