@sonordev/site-kit 7.4.0 → 8.0.0

package/dist/seo/getManagedMetadata.d.ts

@@ -1,4 +1,27 @@
+import type { Metadata } from 'next';
 import type { GetManagedMetadataOptions, ManagedMetadataResult, GetABVariantOptions, ABTestResult } from './types';
+/**
+ * The canonical every page gets when nobody says otherwise: itself.
+ *
+ * Relative on purpose. Next resolves './' against `metadataBase` AND the route
+ * being rendered, so one value is right in a page and also in a root layout,
+ * whose metadata every page beneath it inherits. An absolute canonical built
+ * from `path` is wrong in exactly that second case: a layout that asks for '/'
+ * stamps the homepage on every inner page, telling search engines each one is
+ * a copy of it. A site that sets nothing ships no canonical at all.
+ *
+ * Without a `metadataBase` Next emits the path alone ('/privacy'), which is
+ * still a valid canonical; with one it is absolute.
+ */
+export declare const SELF_CANONICAL = "./";
+type Alternates = NonNullable<Metadata['alternates']>;
+/**
+ * Merge alternates key by key, later parts winning, so a page that supplies
+ * only `languages` keeps its canonical and one that supplies a canonical (or
+ * `null`, to opt out) replaces the default. Next replaces the whole
+ * `alternates` object otherwise.
+ */
+export declare function mergeAlternates(...parts: Array<Metadata['alternates'] | undefined>): Alternates;
 /**
  * Get managed metadata for a page
  *
@@ -43,3 +66,4 @@ export declare function getABVariant(options: GetABVariantOptions): Promise<ABTe
 export declare function getManagedMetadataWithAB(options: GetManagedMetadataOptions & {
     sessionId?: string;
 }): Promise<ManagedMetadataResult>;
+export {};

package/dist/seo/index.d.ts

@@ -1,13 +1,12 @@
-export type { SonorSEOConfig, SEOPageData, GetManagedMetadataOptions, ManagedMetadataResult, SchemaMarkup, ManagedSchemaProps, FAQItem, ManagedFAQData, ManagedFAQProps, ManagedLink, ManagedInternalLinksProps, ManagedContentBlock, ManagedContentProps, ABTest, ABTestResult, GetABVariantOptions, ManagedRedirect, GetRedirectOptions, RedirectResult, ManagedScript, ManagedScriptsProps, RobotsDirective, GetRobotsOptions, SitemapEntry, GetSitemapEntriesOptions, } from './types';
+export type { SonorSEOConfig, SEOPageData, GetManagedMetadataOptions, ManagedMetadataResult, SchemaMarkup, ManagedSchemaProps, FAQItem, ManagedFAQData, ManagedFAQProps, ManagedLink, ManagedInternalLinksProps, ABTest, ABTestResult, GetABVariantOptions, ManagedRedirect, GetRedirectOptions, RedirectResult, ManagedScript, ManagedScriptsProps, RobotsDirective, GetRobotsOptions, SitemapEntry, GetSitemapEntriesOptions, } from './types';
 export type { EntityType, SEOEntity, PageSeoContext, } from './server-api';
 export { getManagedMetadata, getManagedMetadataWithAB, getABVariant, } from './getManagedMetadata';
 export { withManagedMetadata } from './withManagedMetadata';
 export { getRedirect, getRobotsDirective, generateSitemap, isIndexable, } from './routing';
-export { getSEOPageData, getSchemaMarkups, getFAQData, getInternalLinks, getContentBlock, getABTest, recordABImpression, getRedirectData, getManagedScripts, getRobotsData, getSitemapEntries, registerSitemap, getEntities, getPrimaryEntity, getEntityEnhancedSchema, getVisibilityScore, getVisibilitySummary, } from './server-api';
+export { getSEOPageData, getSchemaMarkups, getFAQData, getInternalLinks, getABTest, recordABImpression, getRedirectData, getManagedScripts, getRobotsData, getSitemapEntries, registerSitemap, getEntities, getPrimaryEntity, getEntityEnhancedSchema, getVisibilityScore, getVisibilitySummary, } from './server-api';
 export { ManagedSchema, LLMSchema, createSchema, createBreadcrumbSchema } from './ManagedSchema';
 export { createWebSiteOrganizationStub } from './groundingSchema';
 export { ManagedFAQ } from './ManagedFAQ';
 export { ManagedInternalLinks } from './ManagedInternalLinks';
-export { ManagedContent, getManagedContentData } from './ManagedContent';
 export { ManagedScripts, ManagedNoScripts } from './ManagedScripts';
 export { SitemapSync } from '../SitemapSync';

package/dist/seo/index.js

@@ -2,25 +2,26 @@ export { ManagedNoScripts, ManagedScripts } from '../chunk-MVLMXC44.js';
 import { pickManagedLlmSchemaForJsonLd } from '../chunk-NZ4RXN3G.js';
 import { safeJsonLd } from '../chunk-4KZ6W3ZH.js';
 import { withoutSchemaPlaceholders } from '../chunk-VWWITFWM.js';
-export { SitemapSync } from '../chunk-D2RGEWHS.js';
-import { getManagedMetadata } from '../chunk-4YTYGG2C.js';
-export { generateSitemap, getABVariant, getManagedMetadata, getManagedMetadataWithAB, getRedirect, getRobotsDirective, isIndexable } from '../chunk-4YTYGG2C.js';
-import { getContentBlock, getSchemaMarkups, getSEOPageData, getEntityEnhancedSchema, getFAQData, getInternalLinks, getEntities, pruneSchemaTypes } from '../chunk-662ILEZ6.js';
-export { getABTest, getContentBlock, getEntities, getEntityEnhancedSchema, getFAQData, getInternalLinks, getManagedScripts, getPrimaryEntity, getRedirectData, getRobotsData, getSEOPageData, getSchemaMarkups, getSitemapEntries, getVisibilityScore, getVisibilitySummary, recordABImpression, registerSitemap } from '../chunk-662ILEZ6.js';
+export { SitemapSync } from '../chunk-K22OLAPC.js';
+import { getManagedMetadata, mergeAlternates } from '../chunk-URJN75ZG.js';
+export { generateSitemap, getABVariant, getManagedMetadata, getManagedMetadataWithAB, getRedirect, getRobotsDirective, isIndexable } from '../chunk-URJN75ZG.js';
+import { getSchemaMarkups, getSEOPageData, getEntityEnhancedSchema, getFAQData, getInternalLinks, pruneSchemaTypes } from '../chunk-Y35BWW2C.js';
+export { getABTest, getEntities, getEntityEnhancedSchema, getFAQData, getInternalLinks, getManagedScripts, getPrimaryEntity, getRedirectData, getRobotsData, getSEOPageData, getSchemaMarkups, getSitemapEntries, getVisibilityScore, getVisibilitySummary, recordABImpression, registerSitemap } from '../chunk-Y35BWW2C.js';
 import '../chunk-BQR4IPBW.js';
-import '../chunk-RYVDGXC2.js';
 import '../chunk-MJP63SSS.js';
-import '../chunk-X6F6SO4S.js';
+import '../chunk-6KU7STM3.js';
+import '../chunk-C7TLGL3R.js';
 import '../chunk-MH2DSGC6.js';
 import '../chunk-YVKRYQRG.js';
 import '../chunk-DIKNRN34.js';
 import '../chunk-FESKKJAS.js';
 import '../chunk-A4CC4ZG3.js';
-import '../chunk-43OCZ3JA.js';
+import '../chunk-CAH4Y4PY.js';
 import '../chunk-EKBEOXTH.js';
-import '../chunk-3E3PPSNR.js';
-import '../chunk-GK7TV7EK.js';
-import '../chunk-KHQ5GD6T.js';
+import '../chunk-3G7YABRA.js';
+import '../chunk-56VDS2RP.js';
+import '../chunk-ZLFGXKLG.js';
+import '../chunk-5S2XDG5O.js';
 import '../chunk-PKBMQBKP.js';
 import { Suspense } from 'react';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
@@ -37,6 +38,7 @@ function withManagedMetadata(path, pageMetadata) {
     return {
       ...managed,
       ...pageSpecific,
+      alternates: mergeAlternates(managed.alternates, pageSpecific.alternates),
       openGraph: {
         ...managed.openGraph,
         ...pageSpecific.openGraph
@@ -475,125 +477,5 @@ async function ManagedInternalLinksAsync({
 function ManagedInternalLinks(props) {
   return /* @__PURE__ */ jsx(Suspense, { fallback: null, children: /* @__PURE__ */ jsx(ManagedInternalLinksAsync, { ...props }) });
 }
-function renderMarkdown(content) {
-  return content.replace(/^### (.*$)/gim, "<h3>$1</h3>").replace(/^## (.*$)/gim, "<h2>$1</h2>").replace(/^# (.*$)/gim, "<h1>$1</h1>").replace(/\*\*(.*)\*\*/gim, "<strong>$1</strong>").replace(/\*(.*)\*/gim, "<em>$1</em>").replace(/\[(.*?)\]\((.*?)\)/gim, '<a href="$2">$1</a>').replace(/\n\n/gim, "</p><p>").replace(/^(.+)$/gim, "<p>$1</p>");
-}
-function injectEntityAnnotations(html, entities) {
-  if (!entities.length) return html;
-  let annotatedHtml = html;
-  const sortedEntities = [...entities].sort((a, b) => b.name.length - a.name.length);
-  for (const entity of sortedEntities) {
-    if (entity.name.length < 3) continue;
-    const regex = new RegExp(
-      `(?<![\\w-])(?<!data-sonor-entity=")${escapeRegExp(entity.name)}(?![\\w-])`,
-      "gi"
-    );
-    const schemaType = getSchemaTypeForEntity(entity.entity_type);
-    annotatedHtml = annotatedHtml.replace(regex, (match) => {
-      return `<span class="aeo-entity aeo-entity-${entity.entity_type}" data-sonor-entity="${entity.id}" data-sonor-entity-type="${entity.entity_type}" data-sonor-entity-name="${entity.name}" itemscope itemtype="https://schema.org/${schemaType}"><span itemprop="name">${match}</span></span>`;
-    });
-  }
-  return annotatedHtml;
-}
-function escapeRegExp(string) {
-  return string.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-function getSchemaTypeForEntity(entityType) {
-  const typeMap = {
-    organization: "Organization",
-    person: "Person",
-    service: "Service",
-    product: "Product",
-    location: "Place",
-    concept: "Thing",
-    credential: "EducationalOccupationalCredential"
-  };
-  return typeMap[entityType] || "Thing";
-}
-async function ManagedContentAsync({
-  path,
-  section,
-  fallback,
-  className,
-  components = {},
-  injectEntityAnnotations: shouldInjectEntities = false,
-  site
-}) {
-  const block = await getContentBlock(path, section, site);
-  if (!block) {
-    if (fallback) {
-      return /* @__PURE__ */ jsx(Fragment, { children: fallback });
-    }
-    return null;
-  }
-  let entities = [];
-  if (shouldInjectEntities) {
-    try {
-      entities = await getEntities();
-    } catch (err) {
-      console.warn("@sonordev/seo: Failed to fetch entities for annotation:", err);
-    }
-  }
-  const containerClass = className || `sk-content sk-content--${section}`;
-  const processHtml = (html) => {
-    if (shouldInjectEntities && entities.length > 0) {
-      return injectEntityAnnotations(html, entities);
-    }
-    return html;
-  };
-  switch (block.content_type) {
-    case "html":
-      return /* @__PURE__ */ jsx(
-        "div",
-        {
-          className: containerClass,
-          dangerouslySetInnerHTML: { __html: processHtml(block.content) }
-        }
-      );
-    case "markdown":
-      const htmlContent = processHtml(renderMarkdown(block.content));
-      return /* @__PURE__ */ jsx(
-        "div",
-        {
-          className: containerClass,
-          dangerouslySetInnerHTML: { __html: htmlContent }
-        }
-      );
-    case "json":
-      const jsonData = typeof block.content === "string" ? JSON.parse(block.content) : block.content;
-      return /* @__PURE__ */ jsxs(
-        "div",
-        {
-          className: containerClass,
-          "data-content": JSON.stringify(jsonData),
-          children: [
-            jsonData.title && /* @__PURE__ */ jsx("h2", { children: jsonData.title }),
-            jsonData.subtitle && /* @__PURE__ */ jsx("p", { className: "subtitle", children: jsonData.subtitle }),
-            jsonData.content && /* @__PURE__ */ jsx("div", { dangerouslySetInnerHTML: { __html: jsonData.content } }),
-            jsonData.items && /* @__PURE__ */ jsx("ul", { children: jsonData.items.map((item, index) => /* @__PURE__ */ jsx("li", { children: typeof item === "string" ? item : item.text }, index)) })
-          ]
-        }
-      );
-    case "react":
-      const componentData = typeof block.content === "string" ? JSON.parse(block.content) : block.content;
-      const componentName = componentData.component;
-      const componentProps = componentData.props || {};
-      const Component = components[componentName];
-      if (!Component) {
-        console.warn(`@sonordev/seo: Component "${componentName}" not found in components map`);
-        return fallback ? /* @__PURE__ */ jsx(Fragment, { children: fallback }) : null;
-      }
-      return /* @__PURE__ */ jsx("div", { className: containerClass, children: /* @__PURE__ */ jsx(Component, { ...componentProps }) });
-    default:
-      console.warn(`@sonordev/seo: Unknown content type "${block.content_type}"`);
-      return fallback ? /* @__PURE__ */ jsx(Fragment, { children: fallback }) : null;
-  }
-}
-async function getManagedContentData(path, section, site) {
-  return getContentBlock(path, section, site);
-}
-function ManagedContent(props) {
-  return /* @__PURE__ */ jsx(Suspense, { fallback: null, children: /* @__PURE__ */ jsx(ManagedContentAsync, { ...props }) });
-}
 
-export { LLMSchema, ManagedContent, ManagedFAQ, ManagedInternalLinks, ManagedSchema, createBreadcrumbSchema, createSchema, createWebSiteOrganizationStub, getManagedContentData, withManagedMetadata };
+export { LLMSchema, ManagedFAQ, ManagedInternalLinks, ManagedSchema, createBreadcrumbSchema, createSchema, createWebSiteOrganizationStub, withManagedMetadata };

package/dist/seo/indexnow.js

@@ -1,4 +1,4 @@
-export { GET, INDEXNOW_KEY_PATH, createIndexNowKeyRoute, fetchIndexNowKey } from '../chunk-PXKIGZ2F.js';
-import '../chunk-X6F6SO4S.js';
+export { GET, INDEXNOW_KEY_PATH, createIndexNowKeyRoute, fetchIndexNowKey } from '../chunk-EATJPSTS.js';
+import '../chunk-C7TLGL3R.js';
 import '../chunk-MH2DSGC6.js';
 import '../chunk-PKBMQBKP.js';

package/dist/seo/llms.js

@@ -1,11 +1,11 @@
-export { createLLMsFullTxtHandler, createLLMsTxtHandler, formatSourcedFactsSection, llmsResponseHeaders } from '../chunk-5O62CER4.js';
+export { createLLMsFullTxtHandler, createLLMsTxtHandler, formatSourcedFactsSection, llmsResponseHeaders } from '../chunk-M62U7TJF.js';
 export { buildAiDiscoveryHeaders, wantsLlmsDiscoveryLink } from '../chunk-PO2TRJPY.js';
 export { AI_RETRIEVAL_CRAWLERS, AI_TRAINING_CRAWLERS, buildAiCrawlerRules, createRobotsTxtHandler } from '../chunk-QLTDFUJ7.js';
-export { LEGACY_PUBLICATION_PATH, SEO_REVALIDATION_MAX_BODY_BYTES, SEO_REVALIDATION_MAX_ITEMS, createLlmsRevalidateHandler, createSeoRevalidationHandler, parseSeoRevalidationPayload } from '../chunk-XA2BNW5M.js';
-import '../chunk-XTRZGXB2.js';
+export { LEGACY_PUBLICATION_PATH, SEO_REVALIDATION_MAX_BODY_BYTES, SEO_REVALIDATION_MAX_ITEMS, createLlmsRevalidateHandler, createSeoRevalidationHandler, parseSeoRevalidationPayload } from '../chunk-7YEEOIWI.js';
 export { AEOBlock, AEOCitedContent, AEOClaim, AEOComparison, AEODefinition, AEOEntity, AEOProvenanceList, AEOStep, AEOSteps, AEOSummary, DEFAULT_SPEAKABLE_SELECTORS, SpeakableSchema, createSpeakableSchema, getSpeakableSelectorsForPage } from '../chunk-PSAG45YF.js';
-export { AGENT_ACCESS_HEADING, appendAgentAccessSection, describesMcp, detectMcpServer, formatAgentAccessSection, generateLLMsFullTxt, generateLLMsTxt, writeLLMsTxtToPublic } from '../chunk-ZTLU3BSW.js';
-export { getBusinessInfo, getFAQItems, getLLMsData, getOptimizedLLMsTxt, getPageSummaries, getServices } from '../chunk-4BHRA7TI.js';
+import '../chunk-XTRZGXB2.js';
+export { AGENT_ACCESS_HEADING, appendAgentAccessSection, describesMcp, detectMcpServer, formatAgentAccessSection, generateLLMsFullTxt, generateLLMsTxt, writeLLMsTxtToPublic } from '../chunk-TZ5RTANX.js';
+export { getBusinessInfo, getFAQItems, getLLMsData, getOptimizedLLMsTxt, getPageSummaries, getServices } from '../chunk-JIH32RH2.js';
 import '../chunk-L5UOHS6E.js';
 import '../chunk-WMVK77ND.js';
 import '../chunk-UAYAJPEP.js';
@@ -15,5 +15,6 @@ import '../chunk-MJP63SSS.js';
 import '../chunk-YVKRYQRG.js';
 import '../chunk-FESKKJAS.js';
 import '../chunk-A4CC4ZG3.js';
-import '../chunk-KHQ5GD6T.js';
+import '../chunk-3G7YABRA.js';
+import '../chunk-5S2XDG5O.js';
 import '../chunk-PKBMQBKP.js';

package/dist/seo/register-sitemap-cli.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
+import { HEX_COLOR, colorLuminance, DARK_LUMINANCE } from '../chunk-S22FSH7C.js';
 import { findSitemapRoute, findAppDirForDiscovery, discoverNextJsRoutes } from '../chunk-ZEGVKVD5.js';
 import { inferPageType } from '../chunk-YVKRYQRG.js';
 import { resolveSyncSite, postRegisterSitemap } from '../chunk-DIKNRN34.js';
 import '../chunk-FESKKJAS.js';
 import '../chunk-A4CC4ZG3.js';
-import { HEX_COLOR, colorLuminance, DARK_LUMINANCE } from '../chunk-S22FSH7C.js';
 import '../chunk-PKBMQBKP.js';
 import fs, { existsSync, readFileSync } from 'fs';
 import path2 from 'path';
@@ -458,7 +458,7 @@ async function registerLocalSitemap(options) {
   }
   if (options.writeLlms && result.success) {
     try {
-      const { writeLLMsTxtToPublic } = await import('../writeLLMsTxt-OL4KQERZ.js');
+      const { writeLLMsTxtToPublic } = await import('../writeLLMsTxt-UZGN6IBU.js');
       const written = await writeLLMsTxtToPublic({
         // Resolved here too: the sync's own `site` is scoped to the branch that
         // posts, and this runs on the skip path as well.

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

@@ -61,12 +61,6 @@ export declare const getInternalLinks: (sourcePath: string, options?: {
     limit?: number;
     site?: string;
 }) => Promise<any[]>;
-/**
- * Fetch content block - cached per request
- * @param site Sub-site host override; resolves from NEXT_PUBLIC_SITE_URL when omitted
- * @server-only
- */
-export declare const getContentBlock: (path: string, section: string, site?: string) => Promise<any>;
 /**
  * Fetch A/B test and determine variant - cached per request
  * @server-only

package/dist/seo/server.d.ts

@@ -1,4 +1,4 @@
-export { getSEOPageData, getSchemaMarkups, getFAQData, getInternalLinks, getContentBlock, getABTest, recordABImpression, getRedirectData, getManagedScripts, getRobotsData, getSitemapEntries, registerSitemap, } from './server-api';
+export { getSEOPageData, getSchemaMarkups, getFAQData, getInternalLinks, getABTest, recordABImpression, getRedirectData, getManagedScripts, getRobotsData, getSitemapEntries, registerSitemap, } from './server-api';
 export { getManagedMetadata, getManagedMetadataWithAB, } from './getManagedMetadata';
 export { generateSitemap, registerLocalSitemap, } from './routing';
 export type * from './types';

package/dist/seo/server.js

@@ -1,9 +1,9 @@
-export { generateSitemap, getManagedMetadata, getManagedMetadataWithAB, registerLocalSitemap } from '../chunk-4YTYGG2C.js';
-export { getABTest, getContentBlock, getFAQData, getInternalLinks, getManagedScripts, getRedirectData, getRobotsData, getSEOPageData, getSchemaMarkups, getSitemapEntries, recordABImpression, registerSitemap } from '../chunk-662ILEZ6.js';
+export { generateSitemap, getManagedMetadata, getManagedMetadataWithAB, registerLocalSitemap } from '../chunk-URJN75ZG.js';
+export { getABTest, getFAQData, getInternalLinks, getManagedScripts, getRedirectData, getRobotsData, getSEOPageData, getSchemaMarkups, getSitemapEntries, recordABImpression, registerSitemap } from '../chunk-Y35BWW2C.js';
 import '../chunk-BQR4IPBW.js';
-import '../chunk-RYVDGXC2.js';
 import '../chunk-MJP63SSS.js';
-import '../chunk-X6F6SO4S.js';
+import '../chunk-6KU7STM3.js';
+import '../chunk-C7TLGL3R.js';
 import '../chunk-MH2DSGC6.js';
 import '../chunk-DIKNRN34.js';
 import '../chunk-FESKKJAS.js';

package/dist/seo/sitemap.js

@@ -1,7 +1,7 @@
-export { createSitemap, getPortfolioPaths, syncSitemapToPortal } from '../chunk-4DJMJ4V5.js';
+export { createSitemap, getPortfolioPaths, syncSitemapToPortal } from '../chunk-OE3NXEOF.js';
+import '../chunk-TZ5RTANX.js';
+import '../chunk-JIH32RH2.js';
 import '../chunk-Z22QVHT4.js';
-import '../chunk-ZTLU3BSW.js';
-import '../chunk-4BHRA7TI.js';
 import '../chunk-L5UOHS6E.js';
 import '../chunk-WMVK77ND.js';
 import '../chunk-UAYAJPEP.js';
@@ -12,4 +12,5 @@ import '../chunk-YVKRYQRG.js';
 import '../chunk-DIKNRN34.js';
 import '../chunk-FESKKJAS.js';
 import '../chunk-A4CC4ZG3.js';
+import '../chunk-3G7YABRA.js';
 import '../chunk-PKBMQBKP.js';

package/dist/seo/types.d.ts

@@ -43,6 +43,15 @@ export interface GetManagedMetadataOptions {
      * Default: 'metadata' (icons included from project logo_url).
      */
     favicon?: 'metadata' | 'component';
+    /**
+     * Where this call lives. 'page' (default): Sonor's managed canonical and
+     * hreflang for `path` apply. 'layout': pass this when calling from a root or
+     * shared layout, whose metadata every route beneath it inherits; the page
+     * then gets the self-referencing default canonical and nothing path-specific.
+     * Either way a page with no managed canonical gets `alternates.canonical: './'`
+     * (its own URL, resolved against `metadataBase`).
+     */
+    scope?: 'page' | 'layout';
 }
 export interface ManagedMetadataResult extends Metadata {
     _managed: boolean;
@@ -143,36 +152,6 @@ export interface ManagedInternalLinksProps {
      */
     site?: string;
 }
-export interface ManagedContentBlock {
-    id: string;
-    project_id: string;
-    path: string;
-    section: string;
-    content_type: 'html' | 'markdown' | 'json' | 'react';
-    content: string | Record<string, unknown>;
-    is_published: boolean;
-    published_at?: string;
-    updated_at: string;
-}
-export interface ManagedContentProps {
-    /** @deprecated Project is resolved from API key by the portal */
-    projectId?: string;
-    path: string;
-    section: string;
-    /** Fallback content if none found */
-    fallback?: React.ReactNode;
-    className?: string;
-    /** For 'react' type, map of component names to components */
-    components?: Record<string, React.ComponentType<unknown>>;
-    /** Inject entity annotations from knowledge graph (data-sonor-entity attributes) */
-    injectEntityAnnotations?: boolean;
-    /**
-     * Sub-site host for multi-site projects (e.g. `charlotte.example.com`): shows that
-     * host's block, falling back to a project-wide one. Omit to resolve from
-     * NEXT_PUBLIC_SITE_URL.
-     */
-    site?: string;
-}
 /**
  * Entity from the knowledge graph (for content annotation)
  */

package/dist/server/index.d.ts

@@ -8,7 +8,14 @@
  *
  * Server-only — see `./server-fetch`. Never import into a client component.
  */
-export { resolveServerApiConfig, requireServerApiConfig, resolveApiOrigin, serverApiFetch, } from './server-fetch';
+export { resolveServerApiConfig, requireServerApiConfig, resolveApiOrigin, serverApiFetch, isNextControlFlow, } from './server-fetch';
+/**
+ * The cache tags Sonor expires through the site's revalidation route. Tag a
+ * `serverApiFetch` with the one for your content (`tags: [SITE_CACHE_TAGS.commerce]`)
+ * and an edit in Sonor refreshes it. Never spell a tag as a string.
+ */
+export { SITE_CACHE_TAGS } from '../contracts/site-cache';
+export type { SiteCacheTag } from '../contracts/site-cache';
 export type { ServerApiConfig, ResolveServerApiConfigOptions, ServerFetchOptions, } from './server-fetch';
 /**
  * Mint a short-lived, project-scoped client token from the raw `SONOR_API_KEY`,

package/dist/server/index.js

@@ -1,6 +1,7 @@
-export { resolveClientCredential } from '../chunk-IE5SSOCN.js';
+export { resolveClientCredential } from '../chunk-BQ2CXKTQ.js';
 import '../chunk-UAYAJPEP.js';
-export { requireServerApiConfig, resolveApiOrigin, resolveServerApiConfig, serverApiFetch } from '../chunk-X6F6SO4S.js';
+export { SITE_CACHE_TAGS } from '../chunk-6KU7STM3.js';
+export { isNextControlFlow, requireServerApiConfig, resolveApiOrigin, resolveServerApiConfig, serverApiFetch } from '../chunk-C7TLGL3R.js';
 import '../chunk-MH2DSGC6.js';
-import '../chunk-KHQ5GD6T.js';
+import '../chunk-5S2XDG5O.js';
 import '../chunk-PKBMQBKP.js';

package/dist/server/mint-site-token.d.ts

@@ -40,15 +40,4 @@
  */
 import 'server-only';
 export { resolveFetch } from '../shared/fresh-fetch';
-/**
- * Next signals "this render must go dynamic" by THROWING (DynamicServerError,
- * static-gen bailout, redirect/notFound digests, React's postpone). Those are
- * the framework's control flow, not a mint failure. Swallowing one makes Next
- * believe the render succeeded statically — which is precisely how the raw key
- * ended up stranded in prerendered HTML with no error anywhere. Let them
- * propagate; only real network/HTTP failures fall back to the raw key.
- *
- * @internal Exported for unit tests; not part of the package's public API.
- */
-export declare function isFrameworkSignal(err: unknown): boolean;
 export declare function resolveClientCredential(rawKey: string, apiUrl: string): Promise<string>;

package/dist/server/server-fetch.d.ts

@@ -51,6 +51,22 @@ export declare function requireServerApiConfig(options?: ResolveServerApiConfigO
  * the origin-resolution logic lives in one place.
  */
 export declare function resolveApiOrigin(apiUrl?: string): string;
+/**
+ * True for an error Next throws to steer rendering rather than to report a
+ * failure: the dynamic-usage bailout an uncached fetch raises while a route
+ * is prerendered, `redirect()`, `notFound()` and the other `NEXT_*` signals,
+ * a postponed or interrupted prerender. Rethrow these. Caught, "render this
+ * route at request time" becomes "prerender it with no data", which reads
+ * as a failed fetch on every build and caches the empty page.
+ *
+ * Single source of truth for this check across site-kit and the kits built
+ * on it (serverApiFetch, the credential mint, commerce-kit). It mirrors
+ * Next's `unstable_rethrow` (including the `cause` chain), plus the
+ * static-generation bailout `dynamic = 'error'` raises, without importing
+ * Next into the data plane; server-fetch.test.ts checks it against the
+ * errors the installed Next throws.
+ */
+export declare function isNextControlFlow(error: unknown): boolean;
 export interface ServerFetchOptions {
     /** HTTP method. Defaults to 'GET'. */
     method?: string;
@@ -110,5 +126,8 @@ export interface ServerFetchOptions {
  * - Optional retry/backoff on transient failures (default on)
  * - Returns null on failure (or missing key, unless `requireKey`) instead of
  *   throwing, so a single bad fetch never crashes a render.
+ * - Lets Next's own control-flow errors through ({@link isNextControlFlow}),
+ *   so a route that turns dynamic renders at request time instead of
+ *   prerendering with nothing.
  */
 export declare function serverApiFetch<T>(path: string, options?: ServerFetchOptions): Promise<T | null>;

package/dist/server-api-EGOKC7Q3.js

@@ -0,0 +1,9 @@
+export { ensureMetadata, getABTest, getEntities, getEntityEnhancedSchema, getFAQData, getInternalLinks, getManagedScripts, getPrimaryEntity, getRedirectData, getRobotsData, getSEOPageData, getSchemaMarkups, getSitemapEntries, getVisibilityScore, getVisibilitySummary, recordABImpression, registerSitemap } from './chunk-Y35BWW2C.js';
+import './chunk-MJP63SSS.js';
+import './chunk-6KU7STM3.js';
+import './chunk-C7TLGL3R.js';
+import './chunk-MH2DSGC6.js';
+import './chunk-DIKNRN34.js';
+import './chunk-FESKKJAS.js';
+import './chunk-A4CC4ZG3.js';
+import './chunk-PKBMQBKP.js';

package/dist/shared/build-entries.d.ts

@@ -27,7 +27,6 @@ export declare const entry: {
     readonly 'seo/server': 'src/seo/server.ts';
     readonly 'seo/register-sitemap-cli': 'src/seo/register-sitemap-cli.ts';
     readonly 'analytics/index': 'src/analytics/index.ts';
-    readonly 'engage/index': 'src/engage/index.ts';
     readonly 'signal/index': 'src/signal/index.ts';
     readonly 'forms/index': 'src/forms/index.ts';
     /** Pure honeypot policy contract (src/contracts, also published as @sonordev/contracts) */
@@ -43,8 +42,6 @@ export declare const entry: {
     readonly 'articles/index': 'src/articles/index.ts';
     readonly 'articles/server': 'src/articles/server-core.ts';
     readonly 'articles/server-ui': 'src/articles/server-ui.ts';
-    readonly 'commerce/index': 'src/commerce/index.ts';
-    readonly 'commerce/server': 'src/commerce/server.ts';
     readonly 'admin-auth/index': 'src/admin-auth/index.ts';
     readonly 'sync/index': 'src/sync/index.ts';
     readonly 'sitemap/index': 'src/sitemap/index.ts';
@@ -90,7 +87,7 @@ export declare const entry: {
      * component as its own client entry makes it reachable from two entries,
      * so esbuild puts it in a shared chunk, which the build stamps. In 6.x
      * the root entry re-exported these two and hid the problem; 7.0's
-     * types-only root exposed it (BookingWidget on /tour, a QCR build).
+     * types-only root exposed it (BookingWidget on a tour page of a production build).
      * tsup.config.ts fails the build if any other entry is caught this way.
      */
     readonly '_client/booking-widget': 'src/sync/BookingWidget.tsx';
@@ -110,8 +107,6 @@ export declare const entry: {
     readonly 'website/images/server': 'src/website/images-server.ts';
     readonly 'website/slots': 'src/website/slots.ts';
     readonly 'website/slots/contract': 'src/website/slots-contract.ts';
-    readonly 'website/cms': 'src/website/cms.ts';
-    readonly 'website/cms/server': 'src/website/cms-server.ts';
     readonly 'website/landing': 'src/website/landing.ts';
     readonly 'website/landing/server': 'src/website/landing-server.ts';
     readonly 'website/cta-bar': 'src/website/cta-bar.ts';
@@ -152,11 +147,17 @@ export declare const entry: {
     readonly 'landing/server': 'src/landing/server.ts';
     readonly 'layout/client': 'src/layout/SiteKitClientProviders.tsx';
     readonly 'client/index': 'src/client/index.ts';
+    /**
+     * The browser transport and API-config reader, for packages that build on
+     * site-kit (@sonordev/commerce-kit): sonorFetch, getClientApiConfig. NOT
+     * stamped 'use client' — it's imported from server and client code alike —
+     * so it is listed in ISOMORPHIC_ENTRIES below, and the build fails if it
+     * ever reaches a stamped chunk.
+     */
+    readonly 'runtime/index': 'src/runtime/index.ts';
     readonly 'proxy/index': 'src/proxy/index.ts';
     readonly 'manifest/index': 'src/manifest/index.ts';
     readonly 'config/index': 'src/config/index.ts';
-    readonly 'cms/index': 'src/cms/index.ts';
-    readonly 'cms/server': 'src/cms/server.ts';
     readonly 'maps/index': 'src/maps/index.ts';
     /** Tier 0: zero-dep Reveal / Parallax / ScrollScene on the scroll engine */
     readonly 'motion/index': 'src/motion/index.ts';
@@ -182,7 +183,18 @@ export declare const entry: {
  * `server-only` module. Add new client entries HERE — that keeps the stamp and
  * the guard reading the same list.
  */
-export declare const CLIENT_ENTRIES: readonly ["_client/booking-widget", "_client/testimonial-section", "forms/index", "affiliates/index", "analytics/index", "seo/client", "engage/index", "signal/index", "commerce/index", "layout/client", "client/index", "fleet/index", "website/index", "website/popups", "chat/index", "articles/index", "maps/index", "mcp/client", "motion/index", "motion/gsap", "motion/three", "cta-bar/client"];
+export declare const CLIENT_ENTRIES: readonly ["_client/booking-widget", "_client/testimonial-section", "forms/index", "affiliates/index", "analytics/index", "seo/client", "signal/index", "layout/client", "client/index", "fleet/index", "website/index", "website/popups", "chat/index", "articles/index", "maps/index", "mcp/client", "motion/index", "motion/gsap", "motion/three", "cta-bar/client"];
+/**
+ * Entries that must run anywhere: imported by server components, route
+ * handlers and client components alike. So they are never stamped 'use client'
+ * (a function exported from a stamped module is a client reference on the
+ * server, and can't be called there), they import neither React nor Next nor
+ * `server-only`, and nothing they load eagerly may be a stamped chunk.
+ *
+ * `./client-entry-boundary.test.ts` checks the source graph and
+ * `tsup.config.ts` checks the built files, both from this list.
+ */
+export declare const ISOMORPHIC_ENTRIES: readonly ["runtime/index"];
 /**
  * CLI binaries are consumed via `bin`/`npx`, never imported as typed modules, so they
  * don't ship `.d.ts`. Everything else in `entry` gets declarations.

package/dist/shared/clientApiConfig.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Where browser code finds Sonor: the API origin and the site credential
+ * SiteKitLayout publishes on window (`__SITE_KIT_API_URL__`,
+ * `__SITE_KIT_API_KEY__`, the latter usually a short-lived site token; see
+ * publishCredential.ts and siteToken.ts, the only writers).
+ *
+ * SINGLE SOURCE OF TRUTH for reading them. Every client module goes through
+ * one of the two functions below; don't read the globals anywhere else.
+ *
+ *   readPublishedApiConfig()  exactly what the layout published, no
+ *                             fallbacks. For code that must stay silent on a
+ *                             page without SiteKitLayout (form tracking,
+ *                             article views, the analytics gate).
+ *   getClientApiConfig()      the same with fallbacks: the default API origin
+ *                             (or the server's SONOR_API_URL during SSR), and,
+ *                             only when asked, the server's SONOR_API_KEY
+ *                             during SSR.
+ *
+ * Never read a NEXT_PUBLIC_*KEY here: Next inlines NEXT_PUBLIC_ values into
+ * every bundle a module reaches (see client-entry-boundary.test.ts).
+ */
+export declare const DEFAULT_SONOR_API_URL = "https://api.sonor.io";
+/** The globals SiteKitLayout sets on window. */
+export interface SiteKitWindowGlobals {
+    __SITE_KIT_API_URL__?: string;
+    __SITE_KIT_API_KEY__?: string;
+    __SITE_KIT_SITE__?: string;
+    __SITE_KIT_SIGNAL_URL__?: string;
+}
+/**
+ * What SiteKitLayout published on this page, as is: either value is
+ * undefined when it wasn't published, and both are on the server.
+ */
+export declare function readPublishedApiConfig(): {
+    apiUrl?: string;
+    apiKey?: string;
+};
+export interface ClientApiConfigOptions {
+    /**
+     * During server rendering, use the server's SONOR_API_KEY. For modules
+     * whose fetchers also run on the server (maps, reputation, llms). It's
+     * never inlined into a browser bundle: it isn't a NEXT_PUBLIC_ value.
+     */
+    serverKey?: boolean;
+}
+/**
+ * The API origin and credential with fallbacks. In the browser: the
+ * published origin (else api.sonor.io) and the published credential. On the
+ * server: SONOR_API_URL / NEXT_PUBLIC_SONOR_API_URL (else api.sonor.io), so
+ * SSR-rendered absolute URLs follow a staging override, and no credential
+ * unless `serverKey` asks for it.
+ */
+export declare function getClientApiConfig(options?: ClientApiConfigOptions): {
+    apiUrl: string;
+    apiKey: string | undefined;
+};

package/dist/shared/identity-reader.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @sonordev/site-kit/shared — the read-only reader of the analytics identity.
+ *
+ * Forms, popups and `@sonordev/commerce-kit` (through `./runtime`) attach the
+ * visitor's ids to what they send, so Sonor can tie a lead or a sale to the
+ * visit; minting an id there would tie it to a visit analytics never saw.
+ * Creating the ids is identity.tsx's job; where they live is
+ * identity-storage.ts.
+ *
+ * React-free and not `'use client'`: the `./runtime` entry re-exports it, and
+ * that entry must stay isomorphic.
+ */
+/** The visitor's current analytics ids. Each is null when there isn't one. */
+export interface AnalyticsIdentity {
+    sessionId: string | null;
+    visitorId: string | null;
+}
+/**
+ * Read the visitor's analytics ids without creating them, so what a form,
+ * popup or checkout sends ties to the visit analytics recorded (and never to
+ * a fresh id analytics didn't see). Both are null during server rendering
+ * and before analytics has started a session in this tab. When the browser
+ * blocks storage, these are the in-memory ids analytics is using for this
+ * page load. Never throws.
+ */
+export declare function readAnalyticsIdentity(): AnalyticsIdentity;