@sonordev/site-kit 7.0.2 → 7.1.1

package/dist/slots/ManagedList.d.ts

@@ -0,0 +1,30 @@
+import * as React from 'react';
+import { type SlotListItem } from './contract';
+import type { SlotResolveOptions } from './server-api';
+export interface ManagedListProps extends Omit<SlotResolveOptions, 'fallback' | 'type' | 'fallbackValue'> {
+    /** Stable slot id, e.g. "home-services" or "gallery". */
+    id: string;
+    /** The static items: `{ title?, body?, href?, image?: { src, alt, width?, height? } }`. */
+    items: SlotListItem[];
+    /** Draw the items. Called with the managed items, or `items` when nothing's managed. */
+    children: (items: SlotListItem[]) => React.ReactNode;
+}
+/**
+ * ManagedList — a list the owner edits in Sonor: services, team, FAQs, a
+ * gallery. You keep the markup; Sonor manages the items. Each item has an
+ * optional title, plain-text body, link and image (https only).
+ *
+ * Server component, fallback-first and signature-verified like ManagedSlot.
+ *
+ * @example
+ * ```tsx
+ * <ManagedList id="home-services" items={SERVICES}>
+ *   {(items) => (
+ *     <ul className="grid">
+ *       {items.map((s) => <li key={s.title}><a href={s.href}>{s.title}</a><p>{s.body}</p></li>)}
+ *     </ul>
+ *   )}
+ * </ManagedList>
+ * ```
+ */
+export declare function ManagedList({ id, items, children, site, revalidate, page, }: ManagedListProps): Promise<React.ReactElement>;

package/dist/slots/ManagedRichText.d.ts

@@ -0,0 +1,31 @@
+import * as React from 'react';
+import type { SlotResolveOptions } from './server-api';
+export interface ManagedRichTextProps extends Omit<SlotResolveOptions, 'fallback' | 'type' | 'fallbackValue'> {
+    /** Stable slot id, lowercase, page-scoped by convention (e.g. "about-intro"). */
+    id: string;
+    /**
+     * The static content. A string is read as the rich-text subset (so the
+     * fallback and the managed copy render the same way); JSX renders as is.
+     */
+    children: React.ReactNode;
+}
+/**
+ * ManagedRichText — a Sonor-managed block of formatted copy: paragraphs,
+ * line breaks, bold, italic, links and lists. Renders a fragment of `<p>`,
+ * `<ul>`/`<ol>`, `<strong>`, `<em>`, `<a>` and `<br>`; wrap it in your own
+ * element for styling.
+ *
+ * Server component, fallback-first and signature-verified like ManagedSlot.
+ * Managed content is parsed by the contract's rich-text parser and rendered
+ * as elements, never as HTML.
+ *
+ * @example
+ * ```tsx
+ * <div className="prose">
+ *   <ManagedRichText id="about-intro" page="/about">
+ *     {`We've built homes in **Cincinnati** since 1998.\n\n- Custom builds\n- Remodels`}
+ *   </ManagedRichText>
+ * </div>
+ * ```
+ */
+export declare function ManagedRichText({ id, children, site, revalidate, page, }: ManagedRichTextProps): Promise<React.ReactElement>;

package/dist/slots/contract.js

@@ -1,2 +1,3 @@
-export { SLOTS_CONTRACT_VERSION, SLOT_CONTENT_MAX_LENGTH, SLOT_CONTENT_TYPES, SLOT_ID_PATTERN, isValidSlotId, signSlotContent, slotSigningPayload, verifySlotContent } from '../chunk-SS636UDN.js';
+export { SLOTS_CONTRACT_VERSION, SUPPORTED_SLOTS_CONTRACT_VERSIONS, canonicalJson, signSlotContent, slotSigningPayload, verifySlotContent } from '../chunk-VCJYLYJV.js';
+export { SLOT_CONTENT_MAX_LENGTH, SLOT_CONTENT_TYPES, SLOT_FIELD_MAX_LENGTH, SLOT_HREF_MAX_LENGTH, SLOT_ID_PATTERN, SLOT_LIST_MAX_ITEMS, SLOT_V1_CONTENT_TYPES, isSafeSlotHref, isSafeSlotImageSrc, isSlotContentType, isValidSlotId, normalizeSlotValue, parseSlotRichText, slotListPlainText } from '../chunk-LPH5FANE.js';
 import '../chunk-PKBMQBKP.js';

package/dist/slots/edit/locate.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Find managed copy on a rendered page by what it says.
+ *
+ * The slot components render plain text: no wrapper element, no attribute,
+ * so a site's markup and CSS are exactly what it wrote (a marker element would
+ * shift `:first-child`, `h2 + p` and Tailwind's `space-y-*` for every visitor
+ * to serve one editor). The edit overlay finds each slot the way a person
+ * would, by its visible text, using the needles from `slotNeedles`.
+ */
+import { type EditableSlot } from '../../contracts/site-edit';
+export interface LocatedSlot {
+    key: string;
+    /** The element to outline and click. */
+    element: HTMLElement;
+    /** For a text slot rendered as one text node: the node, so a preview can swap just it. */
+    textNode?: Text;
+}
+/**
+ * The deepest unclaimed element whose whole visible text is `needle`: first a
+ * single text node, then an element whose text is split across inline tags
+ * (`Fast <em>and</em> local`).
+ */
+export declare function findByText(root: Element, needle: string, claimed: Set<Element>): {
+    element: HTMLElement;
+    textNode?: Text;
+} | null;
+/** Locate one slot, or null when its text isn't on this page. */
+export declare function locateSlot(root: Element, slot: EditableSlot, claimed: Set<Element>): LocatedSlot | null;
+/** Locate every slot on the page; each element belongs to at most one slot. */
+export declare function locateSlots(root: Element, slots: EditableSlot[]): LocatedSlot[];

package/dist/slots/edit/overlay.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The edit overlay: what a site shows inside Sonor's "Edit on page".
+ *
+ * Loaded only when the page is framed cross-origin with `?sonor_edit`
+ * (`shared/edit-bridge.ts`), and it only acts for the Sonor dashboard
+ * (`isSonorAppOrigin`). It outlines the managed copy it can find, reports a
+ * click as a selection, shows a draft in place, and reloads on request. It
+ * never writes anything: the dashboard saves with the person's own session.
+ *
+ * Plain DOM, no React, so it adds nothing to a visitor's bundle; the bridge
+ * imports it on demand.
+ */
+/** The dashboard's origin, from the browser's own record of who framed us. */
+export declare function framingOrigin(win: Window): string | null;
+/** The same URL with the edit parameter, so the overlay starts again after a navigation. */
+export declare function withEditParam(href: string, base: string): string | null;
+/** Start the overlay. Returns a function that removes every trace of it. */
+export declare function startEditOverlay(win?: Window): () => void;

package/dist/slots/index.d.ts

@@ -1,14 +1,22 @@
 /**
- * @sonordev/site-kit/slots — Managed Slots (3.0 spine, Pillar 1)
+ * @sonordev/site-kit/website/slots — Managed Slots (3.0 spine, Pillar 1)
  *
- * Named, Sonor-managed text regions inside developer-owned markup.
+ * Named, Sonor-managed copy inside developer-owned markup: text, rich text,
+ * links and lists (the Website CMS; docs/WEBSITE-CMS.md).
  * Static-safe, fallback-first, signature-verified.
  * See docs/SITE-KIT-3.0-SPEC-SLOTS.md.
  */
 export { ManagedSlot, default } from './ManagedSlot';
 export type { ManagedSlotProps } from './ManagedSlot';
+export { ManagedRichText } from './ManagedRichText';
+export type { ManagedRichTextProps } from './ManagedRichText';
+export { ManagedLink } from './ManagedLink';
+export type { ManagedLinkProps } from './ManagedLink';
+export { ManagedList } from './ManagedList';
+export type { ManagedListProps } from './ManagedList';
+export { renderSlotRichText } from './rich';
 export { getSlot, resolveSlots } from './server-api';
 export type { SlotResolveOptions } from './server-api';
 export { createSlotsRevalidateHandler, SLOTS_CACHE_TAG } from './revalidate';
-export { SLOTS_CONTRACT_VERSION, SLOT_CONTENT_MAX_LENGTH, SLOT_CONTENT_TYPES, SLOT_ID_PATTERN, isValidSlotId, slotSigningPayload, signSlotContent, verifySlotContent, } from './contract';
-export type { SlotContent, SlotContentType, SlotsResolveRequest, SlotsResolveResponse, } from './contract';
+export { SLOTS_CONTRACT_VERSION, SLOT_CONTENT_MAX_LENGTH, SLOT_CONTENT_TYPES, SLOT_ID_PATTERN, SLOT_LIST_MAX_ITEMS, isSafeSlotHref, isValidSlotId, normalizeSlotValue, parseSlotRichText, slotSigningPayload, signSlotContent, verifySlotContent, } from './contract';
+export type { SlotContent, SlotContentType, SlotLinkValue, SlotListImage, SlotListItem, SlotListValue, SlotRichBlock, SlotRichInline, SlotValue, SlotsResolveRequest, SlotsResolveResponse, } from './contract';

package/dist/slots/index.js

@@ -1,5 +1,7 @@
-export { ManagedSlot, SLOTS_CACHE_TAG, createSlotsRevalidateHandler, ManagedSlot_default as default, getSlot, resolveSlots } from '../chunk-KPAZG65P.js';
-export { SLOTS_CONTRACT_VERSION, SLOT_CONTENT_MAX_LENGTH, SLOT_CONTENT_TYPES, SLOT_ID_PATTERN, isValidSlotId, signSlotContent, slotSigningPayload, verifySlotContent } from '../chunk-SS636UDN.js';
+export { ManagedLink, ManagedList, ManagedRichText, ManagedSlot, SLOTS_CACHE_TAG, createSlotsRevalidateHandler, ManagedSlot_default as default, getSlot, renderSlotRichText, resolveSlots } from '../chunk-CGWUXUYZ.js';
+export { SLOTS_CONTRACT_VERSION, signSlotContent, slotSigningPayload, verifySlotContent } from '../chunk-VCJYLYJV.js';
+export { SLOT_CONTENT_MAX_LENGTH, SLOT_CONTENT_TYPES, SLOT_ID_PATTERN, SLOT_LIST_MAX_ITEMS, isSafeSlotHref, isValidSlotId, normalizeSlotValue, parseSlotRichText } from '../chunk-LPH5FANE.js';
+import '../chunk-RYVDGXC2.js';
 import '../chunk-X6F6SO4S.js';
 import '../chunk-MH2DSGC6.js';
 import '../chunk-PKBMQBKP.js';

package/dist/slots/revalidate.d.ts

@@ -1,20 +1,25 @@
 /**
- * @sonordev/site-kit/slots — On-demand Revalidation
+ * @sonordev/site-kit/website/slots — On-demand Revalidation
  *
  * Sonor calls this when slot content changes (owner edit or approved Signal
  * proposal) so the change is live in seconds instead of at the next ISR
  * window. Mirrors the llms revalidation handler pattern.
  *
+ * Sonor sends slot edits to the site's one revalidation route
+ * (`@sonordev/site-kit/revalidate`), which expires this tag too. Use this
+ * handler only for a separate slots-only route.
+ *
  * @example
  * ```ts
  * // app/api/revalidate-slots/route.ts
- * import { createSlotsRevalidateHandler } from '@sonordev/site-kit/slots'
+ * import { createSlotsRevalidateHandler } from '@sonordev/site-kit/website/slots'
  *
  * export const POST = createSlotsRevalidateHandler(process.env.REVALIDATION_SECRET!)
  * ```
  */
 type RevalidateTagFn = (tag: string) => void;
-export declare const SLOTS_CACHE_TAG = "sonor-slots";
+/** The tag every slot fetch carries (SITE_CACHE_TAGS.slots, @sonordev/contracts/site-cache). */
+export declare const SLOTS_CACHE_TAG: "sonor-slots";
 /**
  * Create a POST handler that busts the slots data cache.
  * Protected by a shared secret. (POST handlers are never statically

package/dist/slots/rich.d.ts

@@ -0,0 +1,7 @@
+import * as React from 'react';
+/**
+ * Render the rich-text subset (see parseSlotRichText in the slots contract)
+ * as React elements. There's no HTML path: every node maps to one element,
+ * and text is React text, so managed rich content can't inject markup.
+ */
+export declare function renderSlotRichText(markdown: string): React.ReactNode;

package/dist/slots/server-api.d.ts

@@ -1,5 +1,5 @@
 /**
- * @sonordev/site-kit/slots — Server-Only Resolution
+ * @sonordev/site-kit/website/slots — Server-Only Resolution
  *
  * SECURITY: uses the private SONOR_API_KEY. Import only in server code
  * (RSC, route handlers, server actions).
@@ -12,7 +12,7 @@
  * - Signed: unsigned/tampered payloads are dropped with a warning.
  */
 import 'server-only';
-import { type SlotContent } from './contract';
+import { type SlotContent, type SlotContentType, type SlotValue } from './contract';
 export interface SlotResolveOptions {
     /** Multi-site sub-dimension: normalized lowercase host. */
     site?: string;
@@ -29,6 +29,10 @@ export interface SlotResolveOptions {
      * the Copy Evidence Loop's slot↔page mapping.
      */
     page?: string;
+    /** What this slot renders as (default 'text'). The component sets it. */
+    type?: SlotContentType;
+    /** The structured fallback (link or list), reported so the editor starts from it. */
+    fallbackValue?: SlotValue;
 }
 /** Resolve one slot. Null on any failure → caller renders fallback. */
 export declare function getSlot(id: string, options?: SlotResolveOptions): Promise<SlotContent | null>;

package/dist/sync/index.js

@@ -1,6 +1,6 @@
-export { BookingWidget } from '../chunk-GYY6ETGB.js';
-export { createBooking, createSlotHold, detectTimezone, fetchAvailability, fetchAvailableDates, fetchBookingTypeDetails, fetchBookingTypes, formatDate, formatDuration, formatTime, prepareMeeting, releaseSlotHold } from '../chunk-5FBY2ZIH.js';
-import '../chunk-RU2RMTGT.js';
-import '../chunk-OIETJKIL.js';
-import '../chunk-B6RZ2NRH.js';
+export { BookingWidget } from '../chunk-ZAWANWUS.js';
+export { createBooking, createSlotHold, detectTimezone, fetchAvailability, fetchAvailableDates, fetchBookingTypeDetails, fetchBookingTypes, formatDate, formatDuration, formatTime, prepareMeeting, releaseSlotHold } from '../chunk-EFPS56JA.js';
+import '../chunk-PXZ7LAOY.js';
+import '../chunk-OUNRFXDC.js';
+import '../chunk-6OL23QYD.js';
 import '../chunk-PKBMQBKP.js';

package/dist/website/images.js

@@ -1,6 +1,6 @@
-export { ManagedImage, assignImageToSlot, clearImageSlot, fetchManagedImage, fetchManagedImages, listImageFiles, uploadImage } from '../chunk-O52CH273.js';
+export { ManagedImage, assignImageToSlot, clearImageSlot, fetchManagedImage, fetchManagedImages, listImageFiles, uploadImage } from '../chunk-542MIHNP.js';
 export { ManagedFavicon, getManagedFaviconUrl } from '../chunk-GW7GSBO7.js';
-import '../chunk-RU2RMTGT.js';
-import '../chunk-OIETJKIL.js';
-import '../chunk-B6RZ2NRH.js';
+import '../chunk-PXZ7LAOY.js';
+import '../chunk-OUNRFXDC.js';
+import '../chunk-6OL23QYD.js';
 import '../chunk-PKBMQBKP.js';

package/dist/website/index.js

@@ -1,13 +1,13 @@
 'use client';
-export { SiteDesignReporter } from '../chunk-ZRE4ZYEG.js';
-export { SITE_DESIGN_PATH, cleanFontStack, colorToHex, getSiteDesignTokens, measureSiteDesign, readDeclaredDesign, sendSiteDesign } from '../chunk-DKTSGYLM.js';
+export { SiteDesignReporter } from '../chunk-ICFRH2ED.js';
+export { SITE_DESIGN_PATH, cleanFontStack, colorToHex, getSiteDesignTokens, measureSiteDesign, readDeclaredDesign, sendSiteDesign } from '../chunk-ODADQM6Z.js';
 export { DEFAULT_POPUP_TOKENS, PopupBlocks } from '../chunk-JSZN6LDZ.js';
 import '../chunk-IHG36STL.js';
 import '../chunk-YC7ELZS3.js';
 import '../chunk-S22FSH7C.js';
 import '../chunk-43OCZ3JA.js';
 import '../chunk-EKBEOXTH.js';
-import '../chunk-RU2RMTGT.js';
-import '../chunk-OIETJKIL.js';
-import '../chunk-B6RZ2NRH.js';
+import '../chunk-PXZ7LAOY.js';
+import '../chunk-OUNRFXDC.js';
+import '../chunk-6OL23QYD.js';
 import '../chunk-PKBMQBKP.js';

package/dist/website/popups.js

@@ -1,7 +1,7 @@
 'use client';
 export { DEFAULT_POPUP_TOKENS, PopupBlocks } from '../chunk-JSZN6LDZ.js';
 import '../chunk-IHG36STL.js';
-import { EngageWidget } from '../chunk-T4SY3FMN.js';
+import { EngageWidget } from '../chunk-B73QPZPH.js';
 import '../chunk-NDF4A5JM.js';
 import '../chunk-6T6CQVNL.js';
 import '../chunk-S22FSH7C.js';
@@ -9,9 +9,9 @@ import '../chunk-24QZEO3Q.js';
 import '../chunk-GJWI74ZZ.js';
 import '../chunk-43OCZ3JA.js';
 import '../chunk-EKBEOXTH.js';
-import '../chunk-RU2RMTGT.js';
-import '../chunk-OIETJKIL.js';
-import '../chunk-B6RZ2NRH.js';
+import '../chunk-PXZ7LAOY.js';
+import '../chunk-OUNRFXDC.js';
+import '../chunk-6OL23QYD.js';
 import '../chunk-PKBMQBKP.js';
 import { jsx } from 'react/jsx-runtime';
 

package/dist/website/slots/contract.js

@@ -1,2 +1,3 @@
-export { SLOTS_CONTRACT_VERSION, SLOT_CONTENT_MAX_LENGTH, SLOT_CONTENT_TYPES, SLOT_ID_PATTERN, isValidSlotId, signSlotContent, slotSigningPayload, verifySlotContent } from '../../chunk-SS636UDN.js';
+export { SLOTS_CONTRACT_VERSION, SUPPORTED_SLOTS_CONTRACT_VERSIONS, canonicalJson, signSlotContent, slotSigningPayload, verifySlotContent } from '../../chunk-VCJYLYJV.js';
+export { SLOT_CONTENT_MAX_LENGTH, SLOT_CONTENT_TYPES, SLOT_FIELD_MAX_LENGTH, SLOT_HREF_MAX_LENGTH, SLOT_ID_PATTERN, SLOT_LIST_MAX_ITEMS, SLOT_V1_CONTENT_TYPES, isSafeSlotHref, isSafeSlotImageSrc, isSlotContentType, isValidSlotId, normalizeSlotValue, parseSlotRichText, slotListPlainText } from '../../chunk-LPH5FANE.js';
 import '../../chunk-PKBMQBKP.js';

package/dist/website/slots.js

@@ -1,5 +1,7 @@
-export { ManagedSlot, SLOTS_CACHE_TAG, createSlotsRevalidateHandler, ManagedSlot_default as default, getSlot, resolveSlots } from '../chunk-KPAZG65P.js';
-export { SLOTS_CONTRACT_VERSION, SLOT_CONTENT_MAX_LENGTH, SLOT_CONTENT_TYPES, SLOT_ID_PATTERN, isValidSlotId, signSlotContent, slotSigningPayload, verifySlotContent } from '../chunk-SS636UDN.js';
+export { ManagedLink, ManagedList, ManagedRichText, ManagedSlot, SLOTS_CACHE_TAG, createSlotsRevalidateHandler, ManagedSlot_default as default, getSlot, renderSlotRichText, resolveSlots } from '../chunk-CGWUXUYZ.js';
+export { SLOTS_CONTRACT_VERSION, signSlotContent, slotSigningPayload, verifySlotContent } from '../chunk-VCJYLYJV.js';
+export { SLOT_CONTENT_MAX_LENGTH, SLOT_CONTENT_TYPES, SLOT_ID_PATTERN, SLOT_LIST_MAX_ITEMS, isSafeSlotHref, isValidSlotId, normalizeSlotValue, parseSlotRichText } from '../chunk-LPH5FANE.js';
+import '../chunk-RYVDGXC2.js';
 import '../chunk-X6F6SO4S.js';
 import '../chunk-MH2DSGC6.js';
 import '../chunk-PKBMQBKP.js';

package/dist/{writeLLMsTxt-UMHKGNRR.js → writeLLMsTxt-QR23OQUE.js}

@@ -1,4 +1,4 @@
-export { writeLLMsTxtToPublic } from './chunk-SSUQKA7L.js';
+export { writeLLMsTxtToPublic } from './chunk-J4D6ZXRW.js';
 import './chunk-GLHQ3LRO.js';
 import './chunk-L5UOHS6E.js';
 import './chunk-WMVK77ND.js';

package/docs.json

@@ -16,6 +16,7 @@
       "title": "Core",
       "pages": [
         { "slug": "layout", "title": "Layout", "file": "src/layout/README.md" },
+        { "slug": "live-updates", "title": "Live updates", "file": "src/revalidate/README.md" },
         { "slug": "seo", "title": "SEO", "file": "src/seo/README.md" },
         { "slug": "analytics", "title": "Analytics", "file": "src/analytics/README.md" },
         { "slug": "sitemap", "title": "Sitemap", "file": "src/sitemap/README.md" },
@@ -27,6 +28,7 @@
     {
       "title": "Content",
       "pages": [
+        { "slug": "copy", "title": "Managed copy", "file": "src/slots/README.md" },
         { "slug": "articles", "title": "Articles", "file": "src/articles/README.md" },
         { "slug": "images", "title": "Images", "file": "src/images/README.md" },
         { "slug": "reputation", "title": "Reputation", "file": "src/reputation/README.md" }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sonordev/site-kit",
-  "version": "7.0.2",
+  "version": "7.1.1",
   "type": "module",
   "packageManager": "pnpm@11.5.3",
   "description": "Complete client-side integration kit for Sonor - SEO, Analytics, Engage, Forms, Blog",
@@ -155,6 +155,10 @@
       "types": "./dist/slots/contract.d.ts",
       "default": "./dist/slots/contract.js"
     },
+    "./revalidate": {
+      "types": "./dist/revalidate/index.d.ts",
+      "default": "./dist/revalidate/index.js"
+    },
     "./sites/contract": {
       "types": "./dist/sites/contract.d.ts",
       "default": "./dist/sites/contract.js"
@@ -455,6 +459,7 @@
     "commander": "^15.0.0",
     "glob": "^13.0.6",
     "gsap": "^3.15.0",
+    "happy-dom": "^20.14.5",
     "inquirer": "^14.0.2",
     "next": "16.3.6",
     "open": "11.0.0",

package/src/revalidate/README.md

@@ -0,0 +1,82 @@
+# Live updates
+
+Your pages stay cached, and when someone changes content in Sonor, the pages
+that use it refresh within seconds. It takes one route file:
+
+```ts
+// app/api/seo-revalidate/route.ts
+export { POST } from '@sonordev/site-kit/revalidate'
+```
+
+`npx sonor-setup scaffold` writes it for you, and `npx sonor-setup doctor`
+tells you when it's missing.
+
+## How it works
+
+Everything site-kit fetches from Sonor is cached, and pages built from those
+fetches are served from your host's CDN. When content changes in Sonor
+(managed copy, a page's title or description, an article, a portfolio item),
+Sonor sends this route the paths and cache tags that changed. The route checks
+the call was signed with your project's API key, then expires only those
+pages and tags. The next visitor gets the new version, and every other page
+stays cached.
+
+It's the same `SONOR_API_KEY` the rest of site-kit reads, so there's no
+extra secret to set. Sonor finds the route on its own: the first sitemap sync
+after a deploy registers `https://your-domain/api/seo-revalidate` and checks
+that it answers.
+
+Without the route, nothing breaks. Edits still show up, but only once each
+cached fetch ages out: about five minutes for managed copy, up to a day for
+metadata.
+
+## Sites with a publication
+
+If your site publishes articles, tell the route where they live so the index
+and feeds refresh with each article:
+
+```ts
+// app/api/seo-revalidate/route.ts
+import { createRevalidateRoute } from '@sonordev/site-kit/revalidate'
+
+export const POST = createRevalidateRoute({ publicationBasePath: '/insights' })
+```
+
+| Option | What it does |
+|---|---|
+| `publicationBasePath` | Where your articles live, e.g. `/insights`. The index and its RSS and Atom feeds refresh on every call. |
+| `extraPaths` | Local paths to refresh on every call, e.g. a hub page like `/work`. |
+| `extendPayload` | Map extra fields Sonor sends to more paths or tags. The result is validated again, so it can't widen what a caller may refresh. |
+| `secret` | The key calls are signed with. Defaults to `SONOR_API_KEY`, read on every call. |
+
+## What Sonor sends
+
+A POST with `Authorization: Bearer <SONOR_API_KEY>` and a JSON body:
+
+```json
+{ "paths": ["/services/roofing"], "tags": ["sonor-slots"] }
+```
+
+| Field | Meaning |
+|---|---|
+| `paths` | Local paths to regenerate. `/sitemap.xml`, `/llms.txt` and `/llms-full.txt` are always refreshed too. |
+| `tags` | Cache tags to expire. The ones Sonor uses are `SITE_CACHE_TAGS`: `sonor-slots` (managed copy), `seo` (metadata, schema, FAQs), `blog` (articles), `editorial-taxonomy` and `portfolio`. |
+| `revalidateAll` | Regenerate every page. |
+| `ping` | `{ "ping": true }` on its own regenerates nothing and answers `{ "ok": true, "ping": true, "version": "…" }`. Sonor uses it to confirm the route is installed. |
+
+The route refuses a bad key (401), a body over 16 KB (413) and any path that
+isn't a plain local path or any malformed tag (400). A refused call refreshes
+nothing.
+
+## Checking it
+
+```bash
+curl -s -X POST https://your-domain/api/seo-revalidate \
+  -H "Authorization: Bearer $SONOR_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{"ping":true}'
+```
+
+`{"ok":true,"ping":true,...}` means Sonor's edits will go live in seconds. A
+404 means the route isn't deployed. A 401 means the key on the site doesn't
+match the project's key.

package/src/seo/README.md

@@ -219,26 +219,13 @@ Renders the internal links Sonor has for `path` at that position, or nothing whe
 
 `limit` defaults to 5. `renderLink(link)` replaces the default `<a>`, and `className` replaces the default `sk-internal-links sk-internal-links--{position}`. `site` pins the sub-site host (see [Multi-site projects](#multi-site-projects)).
 
-## Content blocks: `<ManagedContent>`
+## Content blocks: `<ManagedContent>` (deprecated)
 
-```tsx
-import { ManagedContent } from '@sonordev/site-kit/seo'
-
-<ManagedContent path="/services/plumbing" section="hero" fallback={<DefaultHero />} />
-```
-
-Renders the block Sonor has for that path and section, by its content type:
-
-- `html`: injected as-is
-- `markdown`: a basic conversion (headings, bold, italic, links, paragraphs). For anything richer, fetch the raw block with `getManagedContentData(path, section)` and use your own parser.
-- `json`: renders `title`, `subtitle`, `content` (as HTML) and `items`
-- `react`: `{ component, props }`, looked up by name in the `components` prop
-
-It renders `fallback` (or nothing) when there's no block. `injectEntityAnnotations` depends on the entity graph and changes nothing today. `site` pins the sub-site host, and `getManagedContentData(path, section, site?)` takes it too.
+Deprecated in 7.1 and removed in 8.0. Page copy is [managed copy](../slots/README.md) now: wrap the text in `<ManagedSlot>` or `<ManagedRichText>` and edit it in Sonor under Website → Content, with drafts, history and Edit on page. Sonor no longer creates content blocks, so `ManagedContent` renders its `fallback`.
 
 ## Multi-site projects
 
-One Sonor project can serve many domains (example.com plus its city microsites). Managed FAQs, internal links and content blocks can be project-wide (every host) or tagged with one host (that host only). `ManagedFAQ`, `ManagedInternalLinks` and `ManagedContent` send the site host with every read, so each microsite gets its own rows plus the project-wide ones, never a sibling's.
+One Sonor project can serve many domains (example.com plus its city microsites). Managed FAQs and internal links can be project-wide (every host) or tagged with one host (that host only). `ManagedFAQ` and `ManagedInternalLinks` send the site host with every read, so each microsite gets its own rows plus the project-wide ones, never a sibling's.
 
 The host resolves from `NEXT_PUBLIC_SITE_URL`, which every microsite already sets, so most sites change nothing. To pin one, pass `site`:
 
@@ -311,7 +298,7 @@ Every component above is built on these. They're server-only, take paths rather
 
 ## Entity graph and AI visibility
 
-`getEntities`, `getPrimaryEntity`, `getEntityEnhancedSchema`, `getVisibilityScore` and `getVisibilitySummary` are exported, but called from a site they currently return empty results (`[]` or `null`): the Signal endpoints behind them don't accept a site key yet. That's also why `ManagedSchema`'s `includeEntityGraph` and `ManagedContent`'s `injectEntityAnnotations` have no effect. Don't build on them until that changes.
+`getEntities`, `getPrimaryEntity`, `getEntityEnhancedSchema`, `getVisibilityScore` and `getVisibilitySummary` are exported, but called from a site they currently return empty results (`[]` or `null`): the Signal endpoints behind them don't accept a site key yet. That's also why `ManagedSchema`'s `includeEntityGraph` has no effect. Don't build on them until that changes.
 
 ## Caching