@sonordev/site-kit 6.4.0 → 7.0.0

package/dist/chunk-G6WF4G3E.js

@@ -1,43 +0,0 @@
-'use client';
-'use strict';
-
-var react = require('react');
-
-// src/shared/visual-viewport-gap.ts
-var VISUAL_VIEWPORT_GAP_PROPERTY = "--sk-vv-layout-gap";
-function measureVisualViewportGap(win) {
-  const vv = win.visualViewport;
-  if (!vv) return 0;
-  return Math.max(0, Math.round(win.innerHeight - vv.offsetTop - vv.height));
-}
-function useVisualViewportGap() {
-  react.useEffect(() => {
-    const root = document.documentElement;
-    const vv = window.visualViewport;
-    const sync = () => {
-      const next = `${measureVisualViewportGap(window)}px`;
-      if (root.style.getPropertyValue(VISUAL_VIEWPORT_GAP_PROPERTY) === next) return;
-      root.style.setProperty(VISUAL_VIEWPORT_GAP_PROPERTY, next);
-    };
-    sync();
-    vv?.addEventListener("resize", sync);
-    vv?.addEventListener("scroll", sync);
-    window.addEventListener("resize", sync);
-    return () => {
-      vv?.removeEventListener("resize", sync);
-      vv?.removeEventListener("scroll", sync);
-      window.removeEventListener("resize", sync);
-      root.style.removeProperty(VISUAL_VIEWPORT_GAP_PROPERTY);
-    };
-  }, []);
-}
-function VisualViewportGap() {
-  useVisualViewportGap();
-  return null;
-}
-
-exports.VISUAL_VIEWPORT_GAP_PROPERTY = VISUAL_VIEWPORT_GAP_PROPERTY;
-exports.VisualViewportGap = VisualViewportGap;
-exports.useVisualViewportGap = useVisualViewportGap;
-//# sourceMappingURL=chunk-G6WF4G3E.js.map
-//# sourceMappingURL=chunk-G6WF4G3E.js.map

package/dist/chunk-G6WF4G3E.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/shared/visual-viewport-gap.ts"],"names":["useEffect"],"mappings":";;;;;AA+BO,IAAM,4BAAA,GAA+B;AAOrC,SAAS,yBACd,GAAA,EACQ;AACR,EAAA,MAAM,KAAK,GAAA,CAAI,cAAA;AACf,EAAA,IAAI,CAAC,IAAI,OAAO,CAAA;AAChB,EAAA,OAAO,IAAA,CAAK,GAAA,CAAI,CAAA,EAAG,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,WAAA,GAAc,EAAA,CAAG,SAAA,GAAY,EAAA,CAAG,MAAM,CAAC,CAAA;AAC3E;AAMO,SAAS,oBAAA,GAA6B;AAC3C,EAAAA,eAAA,CAAU,MAAM;AACd,IAAA,MAAM,OAAO,QAAA,CAAS,eAAA;AACtB,IAAA,MAAM,KAAK,MAAA,CAAO,cAAA;AAElB,IAAA,MAAM,OAAO,MAAM;AACjB,MAAA,MAAM,IAAA,GAAO,CAAA,EAAG,wBAAA,CAAyB,MAAM,CAAC,CAAA,EAAA,CAAA;AAMhD,MAAA,IAAI,IAAA,CAAK,KAAA,CAAM,gBAAA,CAAiB,4BAA4B,MAAM,IAAA,EAAM;AACxE,MAAA,IAAA,CAAK,KAAA,CAAM,WAAA,CAAY,4BAAA,EAA8B,IAAI,CAAA;AAAA,IAC3D,CAAA;AAEA,IAAA,IAAA,EAAK;AACL,IAAA,EAAA,EAAI,gBAAA,CAAiB,UAAU,IAAI,CAAA;AACnC,IAAA,EAAA,EAAI,gBAAA,CAAiB,UAAU,IAAI,CAAA;AACnC,IAAA,MAAA,CAAO,gBAAA,CAAiB,UAAU,IAAI,CAAA;AAEtC,IAAA,OAAO,MAAM;AACX,MAAA,EAAA,EAAI,mBAAA,CAAoB,UAAU,IAAI,CAAA;AACtC,MAAA,EAAA,EAAI,mBAAA,CAAoB,UAAU,IAAI,CAAA;AACtC,MAAA,MAAA,CAAO,mBAAA,CAAoB,UAAU,IAAI,CAAA;AACzC,MAAA,IAAA,CAAK,KAAA,CAAM,eAAe,4BAA4B,CAAA;AAAA,IACxD,CAAA;AAAA,EACF,CAAA,EAAG,EAAE,CAAA;AACP;AAcO,SAAS,iBAAA,GAA0B;AACxC,EAAA,oBAAA,EAAqB;AACrB,EAAA,OAAO,IAAA;AACT","file":"chunk-G6WF4G3E.js","sourcesContent":["/**\n * @sonordev/site-kit — visual viewport gap\n *\n * Single source of truth for measuring how far the layout viewport extends\n * below the visual viewport and publishing it as `--sk-vv-layout-gap` on\n * <html>. Moved into the kit from queencityriverboats.com and\n * destinyyachtcharters.com, which each carried a byte-identical copy.\n *\n * On a phone the two viewports can disagree (browser chrome, in-app browsers,\n * pinch zoom, an on-screen keyboard), and `position: fixed; bottom: …` is\n * measured against the LAYOUT viewport. The difference is how far a fixed\n * bottom element sits below what the visitor can actually see. Adding the\n * property to a `bottom` calc puts it back on screen:\n *\n *   bottom: calc(24px + env(safe-area-inset-bottom, 0px) + var(--sk-vv-layout-gap, 0px));\n *\n * The Echo launcher and chat popup already include it (see\n * engage/launcher-placement.ts), so mounting the tracker is all a site needs\n * for those; the property is also there for the site's own fixed UI.\n *\n * Opt-in on purpose. The gap also grows to the keyboard's height while a\n * field has focus, which lifts every element that reads it above the\n * keyboard. That is what the two sites above want; it is not a default to\n * impose on the fleet.\n */\n\n'use client'\n\nimport { useEffect } from 'react'\n\n/** The custom property the gap is published on, in px. Unset when no tracker is mounted. */\nexport const VISUAL_VIEWPORT_GAP_PROPERTY = '--sk-vv-layout-gap'\n\n/**\n * Whole pixels between the bottom of the visual viewport and the bottom of\n * the layout viewport. 0 when the browser has no VisualViewport API, and\n * never negative.\n */\nexport function measureVisualViewportGap(\n  win: Pick<Window, 'innerHeight' | 'visualViewport'>,\n): number {\n  const vv = win.visualViewport\n  if (!vv) return 0\n  return Math.max(0, Math.round(win.innerHeight - vv.offsetTop - vv.height))\n}\n\n/**\n * Keep `--sk-vv-layout-gap` on <html> current for as long as the calling\n * component is mounted, and remove it on unmount.\n */\nexport function useVisualViewportGap(): void {\n  useEffect(() => {\n    const root = document.documentElement\n    const vv = window.visualViewport\n\n    const sync = () => {\n      const next = `${measureVisualViewportGap(window)}px`\n      // A custom property on <html> invalidates style for the whole document,\n      // and visualViewport fires resize/scroll continuously during a pinch or\n      // a toolbar animation. Only write when the value actually moved.\n      // Compared against the live inline value rather than a cached copy, so\n      // anything else that wrote or removed it is corrected on the next event.\n      if (root.style.getPropertyValue(VISUAL_VIEWPORT_GAP_PROPERTY) === next) return\n      root.style.setProperty(VISUAL_VIEWPORT_GAP_PROPERTY, next)\n    }\n\n    sync()\n    vv?.addEventListener('resize', sync)\n    vv?.addEventListener('scroll', sync)\n    window.addEventListener('resize', sync)\n\n    return () => {\n      vv?.removeEventListener('resize', sync)\n      vv?.removeEventListener('scroll', sync)\n      window.removeEventListener('resize', sync)\n      root.style.removeProperty(VISUAL_VIEWPORT_GAP_PROPERTY)\n    }\n  }, [])\n}\n\n/**\n * Childless component form of `useVisualViewportGap`, for a server layout:\n *\n * ```tsx\n * import { VisualViewportGap } from '@sonordev/site-kit/client'\n *\n * <SiteKitLayout>\n *   <VisualViewportGap />\n *   {children}\n * </SiteKitLayout>\n * ```\n */\nexport function VisualViewportGap(): null {\n  useVisualViewportGap()\n  return null\n}\n"]}

package/dist/chunk-GCPPXUAI.js

@@ -1,72 +0,0 @@
-'use strict';
-
-var jsxRuntime = require('react/jsx-runtime');
-
-// src/images/ManagedFavicon.tsx
-function toAbsoluteFaviconUrl(url, apiBase) {
-  if (!url) return void 0;
-  if (url.startsWith("http://") || url.startsWith("https://")) return url;
-  const base = apiBase.replace(/\/$/, "");
-  return url.startsWith("/") ? `${base}${url}` : `${base}/${url}`;
-}
-async function fetchFaviconData(apiUrl, apiKey) {
-  try {
-    const res = await fetch(`${apiUrl}/public/images/slot/favicon`, {
-      headers: {
-        "Content-Type": "application/json",
-        "x-api-key": apiKey
-      },
-      next: { revalidate: 3600 }
-      // Cache 1hr – favicon rarely changes, allows static generation
-    });
-    if (!res.ok) {
-      console.warn("[ManagedFavicon] Failed to fetch:", res.status);
-      return null;
-    }
-    const data = await res.json();
-    if (data.image && !data.is_placeholder) {
-      const raw = data.image.public_url || data.image.external_url;
-      const public_url = toAbsoluteFaviconUrl(raw, apiUrl);
-      return {
-        public_url: public_url || void 0,
-        mime_type: data.image.file?.mime_type,
-        is_placeholder: false
-      };
-    }
-    return null;
-  } catch (err) {
-    console.error("[ManagedFavicon] Error fetching favicon:", err);
-    return null;
-  }
-}
-async function getManagedFaviconUrl(apiKey, apiUrl = process.env.SONOR_API_URL || "https://api.sonor.io") {
-  const key = apiKey ?? process.env.SONOR_API_KEY;
-  if (!key) return null;
-  const data = await fetchFaviconData(apiUrl, key);
-  return data?.public_url ?? null;
-}
-async function ManagedFavicon({
-  apiKey = process.env.SONOR_API_KEY,
-  apiUrl = process.env.SONOR_API_URL || "https://api.sonor.io",
-  fallback = "/favicon.ico",
-  themeColor = "#4bbf39"
-}) {
-  const faviconData = apiKey && apiUrl ? await fetchFaviconData(apiUrl, apiKey) : null;
-  const faviconUrl = faviconData?.public_url || fallback;
-  const mimeType = faviconData?.mime_type || "image/x-icon";
-  const isSvg = mimeType === "image/svg+xml" || faviconUrl.endsWith(".svg");
-  return /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
-    isSvg ? /* @__PURE__ */ jsxRuntime.jsx("link", { rel: "icon", type: "image/svg+xml", href: faviconUrl }) : /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
-      /* @__PURE__ */ jsxRuntime.jsx("link", { rel: "icon", type: "image/png", sizes: "32x32", href: faviconUrl }),
-      /* @__PURE__ */ jsxRuntime.jsx("link", { rel: "icon", type: "image/png", sizes: "16x16", href: faviconUrl })
-    ] }),
-    /* @__PURE__ */ jsxRuntime.jsx("link", { rel: "apple-touch-icon", sizes: "180x180", href: faviconUrl }),
-    /* @__PURE__ */ jsxRuntime.jsx("meta", { name: "theme-color", content: themeColor })
-  ] });
-}
-
-exports.ManagedFavicon = ManagedFavicon;
-exports.fetchFaviconData = fetchFaviconData;
-exports.getManagedFaviconUrl = getManagedFaviconUrl;
-//# sourceMappingURL=chunk-GCPPXUAI.js.map
-//# sourceMappingURL=chunk-GCPPXUAI.js.map

package/dist/chunk-GCPPXUAI.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/images/ManagedFavicon.tsx"],"names":["jsxs","Fragment","jsx"],"mappings":";;;;;AA+DA,SAAS,oBAAA,CAAqB,KAAyB,OAAA,EAAqC;AAC1F,EAAA,IAAI,CAAC,KAAK,OAAO,MAAA;AACjB,EAAA,IAAI,GAAA,CAAI,WAAW,SAAS,CAAA,IAAK,IAAI,UAAA,CAAW,UAAU,GAAG,OAAO,GAAA;AACpE,EAAA,MAAM,IAAA,GAAO,OAAA,CAAQ,OAAA,CAAQ,KAAA,EAAO,EAAE,CAAA;AACtC,EAAA,OAAO,GAAA,CAAI,UAAA,CAAW,GAAG,CAAA,GAAI,CAAA,EAAG,IAAI,CAAA,EAAG,GAAG,CAAA,CAAA,GAAK,CAAA,EAAG,IAAI,CAAA,CAAA,EAAI,GAAG,CAAA,CAAA;AAC/D;AAMA,eAAsB,gBAAA,CAAiB,QAAgB,MAAA,EAA6C;AAClG,EAAA,IAAI;AACF,IAAA,MAAM,GAAA,GAAM,MAAM,KAAA,CAAM,CAAA,EAAG,MAAM,CAAA,2BAAA,CAAA,EAA+B;AAAA,MAC9D,OAAA,EAAS;AAAA,QACP,cAAA,EAAgB,kBAAA;AAAA,QAChB,WAAA,EAAa;AAAA,OACf;AAAA,MACA,IAAA,EAAM,EAAE,UAAA,EAAY,IAAA;AAAK;AAAA,KAC1B,CAAA;AAED,IAAA,IAAI,CAAC,IAAI,EAAA,EAAI;AACX,MAAA,OAAA,CAAQ,IAAA,CAAK,mCAAA,EAAqC,GAAA,CAAI,MAAM,CAAA;AAC5D,MAAA,OAAO,IAAA;AAAA,IACT;AAEA,IAAA,MAAM,IAAA,GAAO,MAAM,GAAA,CAAI,IAAA,EAAK;AAC5B,IAAA,IAAI,IAAA,CAAK,KAAA,IAAS,CAAC,IAAA,CAAK,cAAA,EAAgB;AACtC,MAAA,MAAM,GAAA,GAAM,IAAA,CAAK,KAAA,CAAM,UAAA,IAAc,KAAK,KAAA,CAAM,YAAA;AAChD,MAAA,MAAM,UAAA,GAAa,oBAAA,CAAqB,GAAA,EAAK,MAAM,CAAA;AACnD,MAAA,OAAO;AAAA,QACL,YAAY,UAAA,IAAc,KAAA,CAAA;AAAA,QAC1B,SAAA,EAAW,IAAA,CAAK,KAAA,CAAM,IAAA,EAAM,SAAA;AAAA,QAC5B,cAAA,EAAgB;AAAA,OAClB;AAAA,IACF;AACA,IAAA,OAAO,IAAA;AAAA,EACT,SAAS,GAAA,EAAK;AACZ,IAAA,OAAA,CAAQ,KAAA,CAAM,4CAA4C,GAAG,CAAA;AAC7D,IAAA,OAAO,IAAA;AAAA,EACT;AACF;AAMA,eAAsB,qBACpB,MAAA,EACA,MAAA,GAAiB,OAAA,CAAQ,GAAA,CAAI,iBAAiB,sBAAA,EACtB;AACxB,EAAA,MAAM,GAAA,GAAM,MAAA,IAAU,OAAA,CAAQ,GAAA,CAAI,aAAA;AAClC,EAAA,IAAI,CAAC,KAAK,OAAO,IAAA;AACjB,EAAA,MAAM,IAAA,GAAO,MAAM,gBAAA,CAAiB,MAAA,EAAQ,GAAG,CAAA;AAC/C,EAAA,OAAO,MAAM,UAAA,IAAc,IAAA;AAC7B;AAEA,eAAsB,cAAA,CAAe;AAAA,EACnC,MAAA,GAAS,QAAQ,GAAA,CAAI,aAAA;AAAA,EACrB,MAAA,GAAS,OAAA,CAAQ,GAAA,CAAI,aAAA,IAAiB,sBAAA;AAAA,EACtC,QAAA,GAAW,cAAA;AAAA,EACX,UAAA,GAAa;AACf,CAAA,EAAwB;AAEtB,EAAA,MAAM,cAAc,MAAA,IAAU,MAAA,GAAS,MAAM,gBAAA,CAAiB,MAAA,EAAQ,MAAM,CAAA,GAAI,IAAA;AAEhF,EAAA,MAAM,UAAA,GAAa,aAAa,UAAA,IAAc,QAAA;AAC9C,EAAA,MAAM,QAAA,GAAW,aAAa,SAAA,IAAa,cAAA;AAC3C,EAAA,MAAM,KAAA,GAAQ,QAAA,KAAa,eAAA,IAAmB,UAAA,CAAW,SAAS,MAAM,CAAA;AAExE,EAAA,uBACEA,eAAA,CAAAC,mBAAA,EAAA,EAEG,QAAA,EAAA;AAAA,IAAA,KAAA,mBACCC,cAAA,CAAC,UAAK,GAAA,EAAI,MAAA,EAAO,MAAK,eAAA,EAAgB,IAAA,EAAM,UAAA,EAAY,CAAA,mBAExDF,eAAA,CAAAC,mBAAA,EAAA,EACE,QAAA,EAAA;AAAA,sBAAAC,cAAA,CAAC,MAAA,EAAA,EAAK,KAAI,MAAA,EAAO,IAAA,EAAK,aAAY,KAAA,EAAM,OAAA,EAAQ,MAAM,UAAA,EAAY,CAAA;AAAA,sBAClEA,cAAA,CAAC,UAAK,GAAA,EAAI,MAAA,EAAO,MAAK,WAAA,EAAY,KAAA,EAAM,OAAA,EAAQ,IAAA,EAAM,UAAA,EAAY;AAAA,KAAA,EACpE,CAAA;AAAA,mCAID,MAAA,EAAA,EAAK,GAAA,EAAI,oBAAmB,KAAA,EAAM,SAAA,EAAU,MAAM,UAAA,EAAY,CAAA;AAAA,oBAG/DA,cAAA,CAAC,MAAA,EAAA,EAAK,IAAA,EAAK,aAAA,EAAc,SAAS,UAAA,EAAY;AAAA,GAAA,EAChD,CAAA;AAEJ","file":"chunk-GCPPXUAI.js","sourcesContent":["/**\n * ManagedFavicon Component\n * \n * Server component that renders favicon link tags using the project's logo.\n * When a logo is uploaded in Project Settings, it's automatically synced\n * to the 'favicon' slot in site_managed_images.\n * \n * Usage:\n * ```tsx\n * import { ManagedFavicon } from '@sonordev/site-kit/images'\n * \n * export default function RootLayout({ children }) {\n *   return (\n *     <html>\n *       <head>\n *         <ManagedFavicon />\n *       </head>\n *       <body>{children}</body>\n *     </html>\n *   )\n * }\n * ```\n * \n * Supports:\n * - SVG favicons (best for modern browsers, scales perfectly)\n * - PNG favicons with multiple sizes\n * - Apple touch icons\n * - Theme color for mobile browsers\n */\n\nimport React from 'react'\n\nexport interface ManagedFaviconProps {\n  /**\n   * API key for Portal API authentication\n   * Defaults to SONOR_API_KEY env var\n   */\n  apiKey?: string\n  \n  /**\n   * API URL (defaults to https://api.sonor.io)\n   */\n  apiUrl?: string\n  \n  /**\n   * Fallback favicon URL if no managed favicon is set\n   */\n  fallback?: string\n  \n  /**\n   * Theme color for mobile browser chrome\n   * Defaults to #4bbf39 (Sonor brand primary)\n   */\n  themeColor?: string\n}\n\ninterface FaviconData {\n  public_url?: string\n  mime_type?: string\n  is_placeholder?: boolean\n}\n\n/** If url is relative (e.g. /uploads/... from API), resolve against base so production can load it. */\nfunction toAbsoluteFaviconUrl(url: string | undefined, apiBase: string): string | undefined {\n  if (!url) return undefined\n  if (url.startsWith('http://') || url.startsWith('https://')) return url\n  const base = apiBase.replace(/\\/$/, '')\n  return url.startsWith('/') ? `${base}${url}` : `${base}/${url}`\n}\n\n/**\n * Server-side fetch of favicon data.\n * Exported for use in generateMetadata (single source for favicon URL).\n */\nexport async function fetchFaviconData(apiUrl: string, apiKey: string): Promise<FaviconData | null> {\n  try {\n    const res = await fetch(`${apiUrl}/public/images/slot/favicon`, {\n      headers: {\n        'Content-Type': 'application/json',\n        'x-api-key': apiKey,\n      },\n      next: { revalidate: 3600 }, // Cache 1hr – favicon rarely changes, allows static generation\n    })\n\n    if (!res.ok) {\n      console.warn('[ManagedFavicon] Failed to fetch:', res.status)\n      return null\n    }\n\n    const data = await res.json()\n    if (data.image && !data.is_placeholder) {\n      const raw = data.image.public_url || data.image.external_url\n      const public_url = toAbsoluteFaviconUrl(raw, apiUrl)\n      return {\n        public_url: public_url || undefined,\n        mime_type: data.image.file?.mime_type,\n        is_placeholder: false,\n      }\n    }\n    return null\n  } catch (err) {\n    console.error('[ManagedFavicon] Error fetching favicon:', err)\n    return null\n  }\n}\n\n/**\n * Return the managed favicon URL for the project (from API key).\n * Use in generateMetadata to set metadata.icons so favicon is consistent across all sites.\n */\nexport async function getManagedFaviconUrl(\n  apiKey?: string,\n  apiUrl: string = process.env.SONOR_API_URL || 'https://api.sonor.io'\n): Promise<string | null> {\n  const key = apiKey ?? process.env.SONOR_API_KEY\n  if (!key) return null\n  const data = await fetchFaviconData(apiUrl, key)\n  return data?.public_url ?? null\n}\n\nexport async function ManagedFavicon({\n  apiKey = process.env.SONOR_API_KEY,\n  apiUrl = process.env.SONOR_API_URL || 'https://api.sonor.io',\n  fallback = '/favicon.ico',\n  themeColor = '#4bbf39',\n}: ManagedFaviconProps) {\n  // Fetch favicon data during SSR\n  const faviconData = apiKey && apiUrl ? await fetchFaviconData(apiUrl, apiKey) : null\n  \n  const faviconUrl = faviconData?.public_url || fallback\n  const mimeType = faviconData?.mime_type || 'image/x-icon'\n  const isSvg = mimeType === 'image/svg+xml' || faviconUrl.endsWith('.svg')\n\n  return (\n    <>\n      {/* Primary favicon */}\n      {isSvg ? (\n        <link rel=\"icon\" type=\"image/svg+xml\" href={faviconUrl} />\n      ) : (\n        <>\n          <link rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href={faviconUrl} />\n          <link rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href={faviconUrl} />\n        </>\n      )}\n      \n      {/* Apple touch icon (for iOS home screen) */}\n      <link rel=\"apple-touch-icon\" sizes=\"180x180\" href={faviconUrl} />\n      \n      {/* Theme color for mobile browsers */}\n      <meta name=\"theme-color\" content={themeColor} />\n    </>\n  )\n}"]}

package/dist/chunk-GFSQMK35.mjs

@@ -1,127 +0,0 @@
-import { resolvePublicationUrl, createPublicationRoutes } from './chunk-6C47333H.mjs';
-
-// src/articles/artwork.ts
-function resolveArticleArtwork(post, placement = "card") {
-  const editorial = placement === "article" && !!post.editorial_image;
-  const src = (editorial ? post.editorial_image : post.featured_image) || void 0;
-  const alt = editorial ? post.editorial_image_alt ?? "" : post.featured_image_alt ?? post.title ?? "";
-  let composed = false;
-  if (src) {
-    try {
-      composed = /\/Blog\/Cards\//i.test(new URL(src, "https://site-kit.invalid").pathname);
-    } catch {
-    }
-  }
-  return { src, alt, composed };
-}
-function articleArtworkImageStyle(artwork) {
-  return artwork.composed ? { display: "block", height: "auto", maxHeight: "none", objectFit: "contain", transform: "none" } : void 0;
-}
-
-// src/articles/author-schema.ts
-var ARTICLE_TYPES = /* @__PURE__ */ new Set(["Article", "BlogPosting", "NewsArticle", "TechArticle", "Report", "ScholarlyArticle"]);
-function isAbsoluteUrl(value) {
-  return /^https?:\/\//i.test(value);
-}
-function routedAuthorPageUrl(author, options) {
-  return resolvePublicationUrl(createPublicationRoutes(options).author(author.slug), options.siteUrl ?? "");
-}
-function authorProfileUrl(author, options) {
-  return author.author_page_url?.trim() || routedAuthorPageUrl(author, options);
-}
-function authorEntityId(author, profileUrl) {
-  const explicit = author.entity_id?.trim();
-  if (explicit) return explicit;
-  if (!profileUrl || !isAbsoluteUrl(profileUrl)) return void 0;
-  return `${profileUrl.replace(/#.*$/, "")}#person`;
-}
-function generateAuthorPersonSchema(author, options = {}) {
-  const { siteUrl, siteName } = options;
-  const sameAs = [...author.same_as || []];
-  if (author.linkedin_url) sameAs.push(author.linkedin_url);
-  if (author.twitter_url) sameAs.push(author.twitter_url);
-  if (author.website_url) sameAs.push(author.website_url);
-  if (author.social_links?.twitter) sameAs.push(`https://twitter.com/${author.social_links.twitter}`);
-  if (author.social_links?.linkedin) sameAs.push(author.social_links.linkedin);
-  if (author.social_links?.github) sameAs.push(`https://github.com/${author.social_links.github}`);
-  const uniqueSameAs = [...new Set(sameAs.filter(Boolean))];
-  const url = authorProfileUrl(author, options);
-  const id = authorEntityId(author, url);
-  const person = {
-    "@type": "Person",
-    ...id ? { "@id": id } : {},
-    name: author.name,
-    url
-  };
-  if (author.title) person.jobTitle = author.title;
-  if (author.company || siteName) {
-    person.worksFor = {
-      "@type": "Organization",
-      name: author.company || siteName,
-      ...siteUrl ? { url: siteUrl } : {}
-    };
-  }
-  if (author.bio || author.short_bio) person.description = author.short_bio || author.bio;
-  if (author.avatar_url) person.image = author.avatar_url;
-  if (uniqueSameAs.length > 0) person.sameAs = uniqueSameAs;
-  if (author.knows_about && author.knows_about.length > 0) person.knowsAbout = author.knows_about;
-  if (author.credentials && author.credentials.length > 0) {
-    person.hasCredential = author.credentials.map((c) => ({
-      "@type": "EducationalOccupationalCredential",
-      credentialCategory: c
-    }));
-  }
-  return person;
-}
-function generateAuthorSchema(author, options = {}) {
-  const pageUrl = routedAuthorPageUrl(author, options);
-  const schema = {
-    "@context": "https://schema.org",
-    "@type": "ProfilePage",
-    ...isAbsoluteUrl(pageUrl) ? { "@id": `${pageUrl}#profilepage` } : {},
-    url: pageUrl,
-    name: author.name,
-    mainEntity: generateAuthorPersonSchema(author, options)
-  };
-  if (author.created_at) schema.dateCreated = author.created_at;
-  if (author.updated_at) schema.dateModified = author.updated_at;
-  return schema;
-}
-function generateArticleAuthorNode(author, options = {}) {
-  if (!author) return void 0;
-  if (typeof author === "string") {
-    const name = author.trim();
-    return name ? { "@type": "Person", name } : void 0;
-  }
-  if (!author.name) return void 0;
-  const url = author.author_page_url?.trim() || (options.authorPages && author.slug ? routedAuthorPageUrl(author, options) : void 0);
-  const id = authorEntityId(author, url);
-  return {
-    "@type": "Person",
-    ...id ? { "@id": id } : {},
-    name: author.name,
-    ...url ? { url } : {}
-  };
-}
-function withArticleAuthorIdentity(node, author, options = {}) {
-  if (!node || typeof node !== "object" || Array.isArray(node)) return node;
-  const record = node;
-  const types = [].concat(record["@type"]);
-  if (!types.some((t) => typeof t === "string" && ARTICLE_TYPES.has(t))) return node;
-  const stored = record.author;
-  if (!stored || typeof stored !== "object" || Array.isArray(stored)) return node;
-  const byline = stored;
-  if (byline["@type"] !== "Person" || typeof byline.name !== "string") return node;
-  const identity = generateArticleAuthorNode(author, options);
-  if (!identity || typeof identity.name !== "string") return node;
-  if (identity.name.trim().toLowerCase() !== byline.name.trim().toLowerCase()) return node;
-  const additions = {};
-  if (!byline["@id"] && identity["@id"]) additions["@id"] = identity["@id"];
-  if (!byline.url && identity.url) additions.url = identity.url;
-  if (Object.keys(additions).length === 0) return node;
-  return { ...record, author: { ...byline, ...additions } };
-}
-
-export { articleArtworkImageStyle, authorEntityId, generateArticleAuthorNode, generateAuthorPersonSchema, generateAuthorSchema, resolveArticleArtwork, withArticleAuthorIdentity };
-//# sourceMappingURL=chunk-GFSQMK35.mjs.map
-//# sourceMappingURL=chunk-GFSQMK35.mjs.map

package/dist/chunk-GFSQMK35.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/articles/artwork.ts","../src/articles/author-schema.ts"],"names":[],"mappings":"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","file":"chunk-GFSQMK35.mjs","sourcesContent":["import type { CSSProperties } from 'react'\nimport type { Article } from './types'\n\nexport interface ArticleArtwork {\n  src: string | undefined\n  alt: string\n  composed: boolean\n}\n\ntype ArtworkSource = Pick<Article, 'title' | 'featured_image' | 'featured_image_alt' | 'editorial_image' | 'editorial_image_alt'>\n\n/** Single source of truth for article artwork versus complete promotional cards. */\nexport function resolveArticleArtwork(post: ArtworkSource, placement: 'article' | 'card' = 'card'): ArticleArtwork {\n  const editorial = placement === 'article' && !!post.editorial_image\n  const src = (editorial ? post.editorial_image : post.featured_image) || undefined\n  const alt = editorial\n    ? post.editorial_image_alt ?? ''\n    : post.featured_image_alt ?? post.title ?? ''\n  let composed = false\n  if (src) {\n    try {\n      // Inspect the path, not a query string that happens to mention a card.\n      // `Blog/Cards/` is the storage folder Sonor writes cards to (a path, not a name).\n      composed = /\\/Blog\\/Cards\\//i.test(new URL(src, 'https://site-kit.invalid').pathname)\n    } catch { /* An unrecognized source retains the normal photograph layout. */ }\n  }\n  return { src, alt, composed }\n}\n\n/** Preserve generated text and graphics across every stock card surface. */\nexport function articleArtworkImageStyle(artwork: ArticleArtwork): CSSProperties | undefined {\n  return artwork.composed\n    ? { display: 'block', height: 'auto', maxHeight: 'none', objectFit: 'contain', transform: 'none' }\n    : undefined\n}\n","/**\n * @sonordev/site-kit/articles — Author JSON-LD (pure)\n *\n * Split out of `./server-core` on purpose. Everything here is a pure function:\n * it maps an `ArticleAuthor` to schema objects and touches no env, no config,\n * and no network. It only ever lived in `server-core` because the other author\n * helpers there (`getAuthorBySlug`, `getAuthorPosts`) do fetch.\n *\n * `AuthorPage` is exported from the client-stamped `@sonordev/site-kit/articles`\n * barrel (see `./index.ts`), so importing these from `server-core` dragged that\n * whole server module — its `x-api-key` fetches included — into the browser\n * bundle. Keeping the pure half here means `AuthorPage` can stay in the barrel\n * without pulling a single line of server code with it.\n *\n * Anything added here must stay pure. If it needs an API key or a fetch, it\n * belongs in `./server-core`, not in this file.\n *\n * Identity model (single source of truth for every author node the kit emits):\n * - The author page is a `ProfilePage` whose `mainEntity` is the `Person`\n *   (Google's profile-page markup for author pages).\n * - The `Person` carries one `@id` everywhere it appears (`authorEntityId`):\n *   the row's `entity_id` when the person has a cross-site identity (e.g.\n *   https://ramseydeal.com/#person), else `<author profile URL>#person`.\n * - Article bylines (`generateArticleAuthorNode`) reference that same `@id`,\n *   so an article, its author page and the person's own site describe one\n *   person, which is what a Knowledge Panel is built from.\n */\n\nimport type { ArticleAuthor } from './types'\nimport { createPublicationRoutes, resolvePublicationUrl, type PublicationRoutingOptions } from './routes'\n\nexport type AuthorSchemaOptions = PublicationRoutingOptions & { siteUrl?: string; siteName?: string }\n\nconst ARTICLE_TYPES = new Set(['Article', 'BlogPosting', 'NewsArticle', 'TechArticle', 'Report', 'ScholarlyArticle'])\n\nfunction isAbsoluteUrl(value: string): boolean {\n  return /^https?:\\/\\//i.test(value)\n}\n\n/** This site's page for the author, the page `AuthorPage` renders. */\nfunction routedAuthorPageUrl(author: Pick<ArticleAuthor, 'slug'>, options: AuthorSchemaOptions): string {\n  return resolvePublicationUrl(createPublicationRoutes(options).author(author.slug), options.siteUrl ?? '')\n}\n\n/** Where the Person points `url`: the row's canonical author page, else this site's. */\nfunction authorProfileUrl(author: Pick<ArticleAuthor, 'slug' | 'author_page_url'>, options: AuthorSchemaOptions): string {\n  return author.author_page_url?.trim() || routedAuthorPageUrl(author, options)\n}\n\n/**\n * Single source of truth for an author's Person `@id`.\n *\n * The row's `entity_id` (one id shared by every site that describes the\n * person) wins. Otherwise the Person lives at `<profile URL>#person`. A\n * relative profile URL gives no `@id`: an id must be absolute to mean the\n * same thing on every page.\n */\nexport function authorEntityId(\n  author: Pick<ArticleAuthor, 'entity_id'>,\n  profileUrl?: string,\n): string | undefined {\n  const explicit = author.entity_id?.trim()\n  if (explicit) return explicit\n  if (!profileUrl || !isAbsoluteUrl(profileUrl)) return undefined\n  return `${profileUrl.replace(/#.*$/, '')}#person`\n}\n\n/**\n * The bare `Person` for an author, with no `@context`, for embedding in a\n * larger graph (an Organization's `founder`, an `@graph` array). Author pages\n * want `generateAuthorSchema`, which wraps this in a `ProfilePage`.\n */\nexport function generateAuthorPersonSchema(\n  author: ArticleAuthor,\n  options: AuthorSchemaOptions = {},\n): Record<string, unknown> {\n  const { siteUrl, siteName } = options\n\n  const sameAs: string[] = [...(author.same_as || [])]\n  if (author.linkedin_url) sameAs.push(author.linkedin_url)\n  if (author.twitter_url) sameAs.push(author.twitter_url)\n  if (author.website_url) sameAs.push(author.website_url)\n  if (author.social_links?.twitter) sameAs.push(`https://twitter.com/${author.social_links.twitter}`)\n  if (author.social_links?.linkedin) sameAs.push(author.social_links.linkedin)\n  if (author.social_links?.github) sameAs.push(`https://github.com/${author.social_links.github}`)\n\n  // Deduplicate\n  const uniqueSameAs = [...new Set(sameAs.filter(Boolean))]\n\n  const url = authorProfileUrl(author, options)\n  const id = authorEntityId(author, url)\n\n  const person: Record<string, any> = {\n    '@type': 'Person',\n    ...(id ? { '@id': id } : {}),\n    name: author.name,\n    url,\n  }\n\n  if (author.title) person.jobTitle = author.title\n  if (author.company || siteName) {\n    person.worksFor = {\n      '@type': 'Organization',\n      name: author.company || siteName,\n      ...(siteUrl ? { url: siteUrl } : {}),\n    }\n  }\n  if (author.bio || author.short_bio) person.description = author.short_bio || author.bio\n  if (author.avatar_url) person.image = author.avatar_url\n  if (uniqueSameAs.length > 0) person.sameAs = uniqueSameAs\n  if (author.knows_about && author.knows_about.length > 0) person.knowsAbout = author.knows_about\n  if (author.credentials && author.credentials.length > 0) {\n    person.hasCredential = author.credentials.map((c) => ({\n      '@type': 'EducationalOccupationalCredential',\n      credentialCategory: c,\n    }))\n  }\n\n  return person\n}\n\n/**\n * JSON-LD for an author page: a `ProfilePage` whose `mainEntity` is the\n * author's `Person`. Render it once per author page (`AuthorPage` does, unless\n * its `jsonLd` prop is false).\n */\nexport function generateAuthorSchema(\n  author: ArticleAuthor,\n  options: AuthorSchemaOptions = {},\n): object {\n  const pageUrl = routedAuthorPageUrl(author, options)\n\n  const schema: Record<string, any> = {\n    '@context': 'https://schema.org',\n    '@type': 'ProfilePage',\n    ...(isAbsoluteUrl(pageUrl) ? { '@id': `${pageUrl}#profilepage` } : {}),\n    url: pageUrl,\n    name: author.name,\n    mainEntity: generateAuthorPersonSchema(author, options),\n  }\n  if (author.created_at) schema.dateCreated = author.created_at\n  if (author.updated_at) schema.dateModified = author.updated_at\n\n  return schema\n}\n\n/**\n * The `author` node for article JSON-LD. Single source of truth for bylines:\n * generateArticleSchema, generateClusterArticleSchema and stored schema_json\n * (via withArticleAuthorIdentity) all route through here.\n *\n * Links to an author page only when one is known to exist: the row's\n * `author_page_url`, or the site declaring `authorPages` in its routing. A\n * bare string byline stays a named Person.\n */\nexport function generateArticleAuthorNode(\n  author: ArticleAuthor | string | null | undefined,\n  options: AuthorSchemaOptions = {},\n): Record<string, unknown> | undefined {\n  if (!author) return undefined\n  if (typeof author === 'string') {\n    const name = author.trim()\n    return name ? { '@type': 'Person', name } : undefined\n  }\n  if (!author.name) return undefined\n\n  const url =\n    author.author_page_url?.trim() ||\n    (options.authorPages && author.slug ? routedAuthorPageUrl(author, options) : undefined)\n  const id = authorEntityId(author, url)\n\n  return {\n    '@type': 'Person',\n    ...(id ? { '@id': id } : {}),\n    name: author.name,\n    ...(url ? { url } : {}),\n  }\n}\n\n/**\n * Attach the author's identity to an article node from stored schema_json\n * (built by Signal at publish time, frozen in the row). Adds `@id` and `url`\n * from generateArticleAuthorNode when the stored byline is a Person with the\n * same name and lacks them; stored values always win and nothing else in the\n * node changes. Non-article nodes pass through untouched.\n */\nexport function withArticleAuthorIdentity(\n  node: unknown,\n  author: ArticleAuthor | string | null | undefined,\n  options: AuthorSchemaOptions = {},\n): unknown {\n  if (!node || typeof node !== 'object' || Array.isArray(node)) return node\n  const record = node as Record<string, unknown>\n  const types = ([] as unknown[]).concat(record['@type'])\n  if (!types.some((t) => typeof t === 'string' && ARTICLE_TYPES.has(t))) return node\n\n  const stored = record.author\n  if (!stored || typeof stored !== 'object' || Array.isArray(stored)) return node\n  const byline = stored as Record<string, unknown>\n  if (byline['@type'] !== 'Person' || typeof byline.name !== 'string') return node\n\n  const identity = generateArticleAuthorNode(author, options)\n  if (!identity || typeof identity.name !== 'string') return node\n  if (identity.name.trim().toLowerCase() !== byline.name.trim().toLowerCase()) return node\n\n  const additions: Record<string, unknown> = {}\n  if (!byline['@id'] && identity['@id']) additions['@id'] = identity['@id']\n  if (!byline.url && identity.url) additions.url = identity.url\n  if (Object.keys(additions).length === 0) return node\n\n  return { ...record, author: { ...byline, ...additions } }\n}\n"]}