@tokenoftrust/storefront-runner 0.1.0

package/apps/storefront/src/lib/storyblok/content-model.ts

@@ -0,0 +1,289 @@
+/**
+ * Editorial content model (Storyblok seam).
+ *
+ * These are OUR types, decoupled from Storyblok's wire shape. The provider maps
+ * either source (Storyblok delivery API OR local JSON) into these, so pages
+ * never see a raw Storyblok story. The block schemas here mirror the component
+ * schemas that live in the Storyblok PARENT space (shared components); the
+ * pilot CHILD space holds the content instances. See DECISIONS.md for the
+ * parent/child + Shared Components plan.
+ */
+
+export type HomeBlock =
+  | HeroBlock
+  | PromoTilesBlock
+  | FeaturedCollectionsBlock
+  | FeaturedProductsBlock
+  | EditorialBlock
+  | NewsletterBlock;
+
+export interface PromoTilesBlock {
+  component: "promo_tiles";
+  title?: string;
+  /** A row of promotional tiles (e.g. "New Additions", "On Sale") that link to
+   * collections — captured from the merchant's homepage. */
+  tiles: { label: string; href: string; image?: string }[];
+}
+
+export interface HeroBlock {
+  component: "hero";
+  /** The "thesis" line — the most characteristic thing about the catalog. */
+  eyebrow?: string;
+  headline: string;
+  /** Split second line gets the signature oversized treatment. */
+  headlineAccent?: string;
+  subhead?: string;
+  ctaLabel?: string;
+  ctaHref?: string;
+  /** Optional handle of a product/collection to feature visually. */
+  featureCollection?: string;
+  /** Direct hero image URL (e.g. the merchant's own homepage hero slide). */
+  image?: string;
+  imageAlt?: string;
+}
+
+export interface FeaturedCollectionsBlock {
+  component: "featured_collections";
+  title?: string;
+  /** Collection handles to surface; empty = all. */
+  handles: string[];
+}
+
+export interface FeaturedProductsBlock {
+  component: "featured_products";
+  title?: string;
+  /** "featured" | "newest" | explicit handles. */
+  source: "featured" | "newest";
+  handles?: string[];
+  limit?: number;
+}
+
+export interface EditorialBlock {
+  component: "editorial";
+  eyebrow?: string;
+  title: string;
+  body_html: string;
+  imageSeed?: string;
+  align?: "left" | "right";
+  ctaLabel?: string;
+  ctaHref?: string;
+}
+
+export interface NewsletterBlock {
+  component: "newsletter";
+  title: string;
+  body?: string;
+  placeholder?: string;
+  ctaLabel?: string;
+}
+
+// ---------------------------------------------------------------------------
+// Marketing blocks (non-commerce tenants). These render WITHOUT catalog data —
+// a marketing tenant composes its pages entirely from these. They're
+// tenant-agnostic: every color/space comes from theme tokens, and the copy
+// lives in tenant content JSON. See components/marketing/*.
+// ---------------------------------------------------------------------------
+
+/** A call-to-action button. `variant` picks primary/secondary styling; an
+ * `external` href (starts with http) opens the app/help/etc. surfaces. */
+export interface MarketingCta {
+  label: string;
+  href: string;
+  variant?: "primary" | "secondary" | "ghost";
+}
+
+export interface MarketingHeroBlock {
+  component: "marketing_hero";
+  eyebrow?: string;
+  headline: string;
+  subhead?: string;
+  body?: string;
+  /** Short trust chips shown under the CTAs (e.g. "200+ countries"). */
+  trust?: string[];
+  ctas?: MarketingCta[];
+  /** Optional right-hand "product moment": a titled list of demo/log lines. */
+  panel?: { title?: string; lines: string[] };
+}
+
+/** A horizontal strip of short proof tokens (countries, standards, ratings). */
+export interface TrustBarBlock {
+  component: "trust_bar";
+  items: string[];
+}
+
+/** Before/after comparison — the "one platform vs a patchwork" section. */
+export interface SplitCompareBlock {
+  component: "split_compare";
+  eyebrow?: string;
+  title: string;
+  subhead?: string;
+  before: { title: string; items: string[] };
+  after: { title: string; items: string[] };
+}
+
+/** Numbered/emoji journey steps. */
+export interface StepsBlock {
+  component: "steps";
+  eyebrow?: string;
+  title: string;
+  subhead?: string;
+  steps: { icon?: string; label: string; detail?: string }[];
+}
+
+/** A grid of capability/industry cards. `variant` tunes density/label style. */
+export interface CardGridBlock {
+  component: "card_grid";
+  /** Optional anchor id so header nav can jump to this section (e.g. "platform"). */
+  anchor?: string;
+  eyebrow?: string;
+  title: string;
+  subhead?: string;
+  variant?: "capability" | "industry" | "feature";
+  cards: {
+    icon?: string;
+    title: string;
+    body?: string;
+    /** Small meta line (e.g. "Use case: account opening"). */
+    meta?: string;
+    href?: string;
+  }[];
+  /** Optional footnote of extra capabilities under the grid. */
+  footnote?: string;
+}
+
+/** A single fenced code sample. NEVER put secret keys here — server-only. */
+export interface CodeSample {
+  language?: string;
+  code: string;
+  /** Optional caption/warning shown above the block. */
+  caption?: string;
+}
+
+/** Integration story: platform logos/labels + an optional safe code sample. */
+export interface IntegrationsBlock {
+  component: "integrations";
+  eyebrow?: string;
+  title: string;
+  subhead?: string;
+  platforms: { label: string; href?: string }[];
+  points?: string[];
+  code?: CodeSample;
+}
+
+/** Privacy / trust proof strip (e.g. "We will never sell your data"). */
+export interface ProofStripBlock {
+  component: "proof_strip";
+  eyebrow?: string;
+  title: string;
+  body?: string;
+  items?: string[];
+}
+
+export interface TestimonialsBlock {
+  component: "testimonials";
+  eyebrow?: string;
+  title?: string;
+  quotes: { stat?: string; quote: string; attribution?: string }[];
+  ratings?: string[];
+}
+
+export interface FaqBlock {
+  component: "faq";
+  eyebrow?: string;
+  title: string;
+  items: { q: string; a: string }[];
+}
+
+/** Final conversion band. */
+export interface CtaBandBlock {
+  component: "cta_band";
+  title: string;
+  subhead?: string;
+  ctas?: MarketingCta[];
+}
+
+export type MarketingBlock =
+  | MarketingHeroBlock
+  | TrustBarBlock
+  | SplitCompareBlock
+  | StepsBlock
+  | CardGridBlock
+  | IntegrationsBlock
+  | ProofStripBlock
+  | TestimonialsBlock
+  | FaqBlock
+  | CtaBandBlock;
+
+/** Discriminators that identify a marketing block (vs a commerce HomeBlock). */
+export const MARKETING_COMPONENTS = new Set<MarketingBlock["component"]>([
+  "marketing_hero",
+  "trust_bar",
+  "split_compare",
+  "steps",
+  "card_grid",
+  "integrations",
+  "proof_strip",
+  "testimonials",
+  "faq",
+  "cta_band",
+]);
+
+export function isMarketingBlock(
+  block: { component: string },
+): block is MarketingBlock {
+  return MARKETING_COMPONENTS.has(block.component as MarketingBlock["component"]);
+}
+
+export interface HomeContent {
+  /** SEO + social. */
+  seoTitle?: string;
+  seoDescription?: string;
+  /** Commerce home blocks OR marketing blocks — the page branches on tenant
+   * siteType/features and renders the matching set. */
+  blocks: (HomeBlock | MarketingBlock)[];
+}
+
+export interface EditorialPage {
+  slug: string;
+  title: string;
+  seoTitle?: string;
+  seoDescription?: string;
+  /** Sanitized HTML body. */
+  body_html: string;
+  /** Optional hero eyebrow/intro. */
+  eyebrow?: string;
+  intro?: string;
+  /** When true, listed in the footer policy column. */
+  isPolicy?: boolean;
+}
+
+export interface SiteNavItem {
+  label: string;
+  href: string;
+  /** Mega-menu children, e.g. collection links grouped under a category. */
+  children?: { label: string; href: string }[];
+}
+
+export interface SiteChrome {
+  nav: SiteNavItem[];
+  /**
+   * Header conversion buttons (marketing tenants). Rendered in the header's
+   * right cluster in place of the commerce search/saved controls. Commerce
+   * tenants omit this and keep the search + saved affordances.
+   */
+  headerCtas?: MarketingCta[];
+  footer: {
+    columns: { title: string; links: { label: string; href: string }[] }[];
+    social: { label: string; href: string }[];
+    tagline?: string;
+    /** Bottom-bar legal/compliance line (marketing tenants). Plain text. */
+    legal?: string;
+  };
+  announcement?: string;
+  /** Default legal/safety disclaimer HTML (fallback for unknown categories). */
+  disclaimer?: string;
+  /** Per-product-category disclaimer HTML, keyed by product_type (or
+   * compliance.product_category) — the source store renders a different legal
+   * block per type (sub-ohm on salts, battery on devices). */
+  disclaimers?: Record<string, string>;
+}