@sonordev/site-kit 7.3.0 → 8.0.0

package/dist/reputation/types.d.ts

@@ -8,11 +8,31 @@ export interface Review {
     role?: string;
     rating: number;
     image?: string;
+    /** A business-supplied work/property photo. `image` remains the reviewer avatar. */
+    photo?: ReviewPhoto | null;
     date?: string;
     platform?: string;
     isFeatured?: boolean;
     serviceTags?: string[];
 }
+export interface ReviewPhoto {
+    fileId: string;
+    url: string;
+    altText: string;
+    caption: string;
+}
+export interface VisualReviewCardProps {
+    review: Review;
+    showRating?: boolean;
+    className?: string;
+}
+export interface VisualReviewGalleryProps {
+    reviews: Review[];
+    title?: string;
+    subtitle?: string;
+    showRating?: boolean;
+    className?: string;
+}
 export interface ReviewStats {
     total_reviews: number;
     average_rating: number;
@@ -30,6 +50,8 @@ export interface TestimonialSectionProps {
     autoplay?: boolean;
     autoplayInterval?: number;
     showRating?: boolean;
+    /** Show attached business photos above the quote. Defaults to true. */
+    showPhoto?: boolean;
     maxReviews?: number;
     featuredOnly?: boolean;
     service?: string;

package/dist/revalidate/index.js

@@ -1,7 +1,7 @@
-import { createSeoRevalidationHandler } from '../chunk-NI2XNEMR.js';
+import { createSeoRevalidationHandler } from '../chunk-7YEEOIWI.js';
 import '../chunk-XTRZGXB2.js';
-export { SITE_CACHE_TAGS, SITE_REVALIDATE_PATH, isSiteRevalidatePong } from '../chunk-RYVDGXC2.js';
-import '../chunk-56KNHB4U.js';
+export { SITE_CACHE_TAGS, SITE_REVALIDATE_PATH, isSiteRevalidatePong } from '../chunk-6KU7STM3.js';
+import '../chunk-5S2XDG5O.js';
 import '../chunk-PKBMQBKP.js';
 
 // src/revalidate/index.ts

package/dist/robots/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/runtime/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @sonordev/site-kit/runtime — how a package that builds on site-kit talks to
+ * Sonor from the browser, without carrying a transport of its own.
+ *
+ * `@sonordev/commerce-kit` is built on this entry, and any other kit should
+ * be: the credential lifecycle (short-lived site tokens, refreshed once on an
+ * authentication failure), retries with a timeout, the auth circuit breaker
+ * and the one reader of the API origin the layout publishes all live in
+ * site-kit, so a kit that goes through here gets every fix site-kit ships.
+ * The visitor's analytics ids come from here too (`readAnalyticsIdentity`),
+ * read-only, so a kit can attribute what it sends without knowing where
+ * site-kit keeps them.
+ *
+ * Deliberately NOT stamped `'use client'` and free of React, Next and
+ * `server-only`: it is imported from client components and server code alike
+ * (`getClientApiConfig` is built to run during server rendering), and a
+ * function exported from a stamped entry can't be called from a server
+ * component. `@sonordev/site-kit/client` is stamped, which is why this isn't
+ * part of it. src/shared/client-entry-boundary.test.ts and tsup.config.ts
+ * keep it that way (ISOMORPHIC_ENTRIES in src/shared/build-entries.ts).
+ *
+ * Stable public surface, covered by semver: runtime/index.test.ts pins the
+ * exact list of exports, so adding or removing one is a deliberate change.
+ * See README.md.
+ */
+export { sonorFetch } from '../shared/sonorFetch';
+export type { SonorFetchOptions } from '../shared/sonorFetch';
+export type { FetchRetryOptions } from '../shared/fetchWithRetry';
+export { getClientApiConfig, readPublishedApiConfig, DEFAULT_SONOR_API_URL } from '../shared/clientApiConfig';
+export type { ClientApiConfigOptions } from '../shared/clientApiConfig';
+export { readAnalyticsIdentity } from '../shared/identity-reader';
+export type { AnalyticsIdentity } from '../shared/identity-reader';

package/dist/runtime/index.js

@@ -0,0 +1,7 @@
+export { readAnalyticsIdentity } from '../chunk-5ROTTMBL.js';
+import '../chunk-5TM3WPCI.js';
+export { DEFAULT_SONOR_API_URL, getClientApiConfig, readPublishedApiConfig } from '../chunk-3G7YABRA.js';
+export { sonorFetch } from '../chunk-56VDS2RP.js';
+import '../chunk-ZLFGXKLG.js';
+import '../chunk-5S2XDG5O.js';
+import '../chunk-PKBMQBKP.js';

package/dist/seo/api.d.ts

@@ -32,10 +32,6 @@ export declare const getInternalLinks: (projectId: string, sourcePath: string, o
     position?: string;
     limit?: number;
 }) => Promise<any[]>;
-/**
- * Fetch content block - cached per request
- */
-export declare const getContentBlock: (projectId: string, path: string, section: string) => Promise<any>;
 /**
  * Fetch A/B test and determine variant - cached per request
  */

package/dist/seo/client.js

@@ -1,9 +1,10 @@
 'use client';
-export { SitemapSync } from '../chunk-T4DLETKR.js';
+export { SitemapSync } from '../chunk-K22OLAPC.js';
 import '../chunk-YVKRYQRG.js';
-import '../chunk-43OCZ3JA.js';
+import '../chunk-CAH4Y4PY.js';
 import '../chunk-EKBEOXTH.js';
-import '../chunk-BEBR4OJD.js';
-import '../chunk-WGG6GTKW.js';
-import '../chunk-56KNHB4U.js';
+import '../chunk-3G7YABRA.js';
+import '../chunk-56VDS2RP.js';
+import '../chunk-ZLFGXKLG.js';
+import '../chunk-5S2XDG5O.js';
 import '../chunk-PKBMQBKP.js';

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-T4DLETKR.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-BEBR4OJD.js';
-import '../chunk-WGG6GTKW.js';
-import '../chunk-56KNHB4U.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,19 +1,20 @@
-export { createLLMsFullTxtHandler, createLLMsTxtHandler, formatSourcedFactsSection, llmsResponseHeaders } from '../chunk-WDQB4OXY.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-NI2XNEMR.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-Z65DHMTW.js';
-export { getBusinessInfo, getFAQItems, getLLMsData, getOptimizedLLMsTxt, getPageSummaries, getServices } from '../chunk-6U3VLV2C.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-VX5CMNMM.js';
+import '../chunk-UAYAJPEP.js';
 export { LLMS_DISCLAIMER_MAX_LENGTH, LLMS_PUBLIC_SUMMARY_MAX_LENGTH, LLM_GEO_CONTRACT_VERSION, MANAGED_LLM_SCHEMA_KNOWN_KEYS, pickManagedLlmSchemaForJsonLd, sanitizeLlmsDisclaimerLine, sanitizeLlmsPublicSummary, sanitizePrimaryLanguageTag } from '../chunk-NZ4RXN3G.js';
 import '../chunk-4KZ6W3ZH.js';
 import '../chunk-MJP63SSS.js';
 import '../chunk-YVKRYQRG.js';
 import '../chunk-FESKKJAS.js';
 import '../chunk-A4CC4ZG3.js';
-import '../chunk-56KNHB4U.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-2NQVDGYI.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,10 +1,10 @@
-export { createSitemap, getPortfolioPaths, syncSitemapToPortal } from '../chunk-Y6LP36UW.js';
+export { createSitemap, getPortfolioPaths, syncSitemapToPortal } from '../chunk-OE3NXEOF.js';
+import '../chunk-TZ5RTANX.js';
+import '../chunk-JIH32RH2.js';
 import '../chunk-Z22QVHT4.js';
-import '../chunk-Z65DHMTW.js';
-import '../chunk-6U3VLV2C.js';
 import '../chunk-L5UOHS6E.js';
 import '../chunk-WMVK77ND.js';
-import '../chunk-VX5CMNMM.js';
+import '../chunk-UAYAJPEP.js';
 import '../chunk-NZ4RXN3G.js';
 import '../chunk-MJP63SSS.js';
 import '../chunk-ZEGVKVD5.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-DNPNYWVL.js';
-import '../chunk-VX5CMNMM.js';
-export { requireServerApiConfig, resolveApiOrigin, resolveServerApiConfig, serverApiFetch } from '../chunk-X6F6SO4S.js';
+export { resolveClientCredential } from '../chunk-BQ2CXKTQ.js';
+import '../chunk-UAYAJPEP.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-56KNHB4U.js';
+import '../chunk-5S2XDG5O.js';
 import '../chunk-PKBMQBKP.js';

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

@@ -39,17 +39,5 @@
  * realistic redeploy gap; marketing sites routinely go many months untouched.
  */
 import 'server-only';
-import { resolveFetch } from '../shared/fresh-fetch';
-export { resolveFetch };
-/**
- * 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 { resolveFetch } from '../shared/fresh-fetch';
 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';