@sonordev/site-kit 5.8.3 → 6.0.1

package/dist/llms/generateLLMsTxt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generateLLMsTxt.d.ts","sourceRoot":"","sources":["../../src/llms/generateLLMsTxt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EACV,sBAAsB,EACtB,cAAc,EAQf,MAAM,SAAS,CAAA;AAoEhB;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,cAAc,CAAC,CAoUzB;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,cAAc,CAAC,CAezB;eAkVc,eAAe"}
+{"version":3,"file":"generateLLMsTxt.d.ts","sourceRoot":"","sources":["../../src/llms/generateLLMsTxt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EACV,sBAAsB,EACtB,cAAc,EAQf,MAAM,SAAS,CAAA;AAqEhB;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,cAAc,CAAC,CAqUzB;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,cAAc,CAAC,CAezB;eAkVc,eAAe"}

package/dist/llms/index.js

@@ -2,15 +2,16 @@
 
 var chunkWS7MH3GD_js = require('../chunk-WS7MH3GD.js');
 var chunkNRBITVDK_js = require('../chunk-NRBITVDK.js');
-var chunkXEB77DQS_js = require('../chunk-XEB77DQS.js');
-var chunk7TC3GRXQ_js = require('../chunk-7TC3GRXQ.js');
-require('../chunk-K4TCEAUX.js');
+var chunkTBXWJJGT_js = require('../chunk-TBXWJJGT.js');
+var chunkG3L26XQ7_js = require('../chunk-G3L26XQ7.js');
+require('../chunk-KR7ATPAN.js');
+require('../chunk-ZR43XFUM.js');
 require('../chunk-LVGSOW2F.js');
 var chunkH6AU3WKF_js = require('../chunk-H6AU3WKF.js');
 require('../chunk-J7QI3GDX.js');
-require('../chunk-YN7QHLWF.js');
-require('../chunk-R7GHP3FY.js');
-require('../chunk-H5NBFNND.js');
+require('../chunk-BBBJHYPH.js');
+require('../chunk-JONWE26J.js');
+require('../chunk-UZKXOZHR.js');
 require('../chunk-SWIKKSKL.js');
 require('../chunk-SNAQBZPT.js');
 var crypto = require('crypto');
@@ -46,7 +47,7 @@ function createLLMsTxtHandler(options = {}) {
           });
         }
       }
-      const { markdown, metadata } = await chunk7TC3GRXQ_js.generateLLMsTxt(generateOptions);
+      const { markdown, metadata } = await chunkG3L26XQ7_js.generateLLMsTxt(generateOptions);
       return new Response(markdown, {
         status: 200,
         headers: llmsResponseHeaders(markdown, {
@@ -82,7 +83,7 @@ function createLLMsFullTxtHandler(options = {}) {
           });
         }
       }
-      const { markdown, metadata } = await chunk7TC3GRXQ_js.generateLLMsFullTxt(generateOptions);
+      const { markdown, metadata } = await chunkG3L26XQ7_js.generateLLMsFullTxt(generateOptions);
       return new Response(markdown, {
         status: 200,
         headers: llmsResponseHeaders(markdown, {
@@ -201,95 +202,95 @@ Object.defineProperty(exports, "formatContentSignals", {
 });
 Object.defineProperty(exports, "AEOBlock", {
   enumerable: true,
-  get: function () { return chunkXEB77DQS_js.AEOBlock; }
+  get: function () { return chunkTBXWJJGT_js.AEOBlock; }
 });
 Object.defineProperty(exports, "AEOCitedContent", {
   enumerable: true,
-  get: function () { return chunkXEB77DQS_js.AEOCitedContent; }
+  get: function () { return chunkTBXWJJGT_js.AEOCitedContent; }
 });
 Object.defineProperty(exports, "AEOClaim", {
   enumerable: true,
-  get: function () { return chunkXEB77DQS_js.AEOClaim; }
+  get: function () { return chunkTBXWJJGT_js.AEOClaim; }
 });
 Object.defineProperty(exports, "AEOComparison", {
   enumerable: true,
-  get: function () { return chunkXEB77DQS_js.AEOComparison; }
+  get: function () { return chunkTBXWJJGT_js.AEOComparison; }
 });
 Object.defineProperty(exports, "AEODefinition", {
   enumerable: true,
-  get: function () { return chunkXEB77DQS_js.AEODefinition; }
+  get: function () { return chunkTBXWJJGT_js.AEODefinition; }
 });
 Object.defineProperty(exports, "AEOEntity", {
   enumerable: true,
-  get: function () { return chunkXEB77DQS_js.AEOEntity; }
+  get: function () { return chunkTBXWJJGT_js.AEOEntity; }
 });
 Object.defineProperty(exports, "AEOProvenanceList", {
   enumerable: true,
-  get: function () { return chunkXEB77DQS_js.AEOProvenanceList; }
+  get: function () { return chunkTBXWJJGT_js.AEOProvenanceList; }
 });
 Object.defineProperty(exports, "AEOStep", {
   enumerable: true,
-  get: function () { return chunkXEB77DQS_js.AEOStep; }
+  get: function () { return chunkTBXWJJGT_js.AEOStep; }
 });
 Object.defineProperty(exports, "AEOSteps", {
   enumerable: true,
-  get: function () { return chunkXEB77DQS_js.AEOSteps; }
+  get: function () { return chunkTBXWJJGT_js.AEOSteps; }
 });
 Object.defineProperty(exports, "AEOSummary", {
   enumerable: true,
-  get: function () { return chunkXEB77DQS_js.AEOSummary; }
+  get: function () { return chunkTBXWJJGT_js.AEOSummary; }
 });
 Object.defineProperty(exports, "DEFAULT_SPEAKABLE_SELECTORS", {
   enumerable: true,
-  get: function () { return chunkXEB77DQS_js.DEFAULT_SPEAKABLE_SELECTORS; }
+  get: function () { return chunkTBXWJJGT_js.DEFAULT_SPEAKABLE_SELECTORS; }
 });
 Object.defineProperty(exports, "SpeakableSchema", {
   enumerable: true,
-  get: function () { return chunkXEB77DQS_js.SpeakableSchema; }
+  get: function () { return chunkTBXWJJGT_js.SpeakableSchema; }
 });
 Object.defineProperty(exports, "createSpeakableSchema", {
   enumerable: true,
-  get: function () { return chunkXEB77DQS_js.createSpeakableSchema; }
+  get: function () { return chunkTBXWJJGT_js.createSpeakableSchema; }
 });
 Object.defineProperty(exports, "getSpeakableSelectorsForPage", {
   enumerable: true,
-  get: function () { return chunkXEB77DQS_js.getSpeakableSelectorsForPage; }
+  get: function () { return chunkTBXWJJGT_js.getSpeakableSelectorsForPage; }
 });
 Object.defineProperty(exports, "generateLLMsFullTxt", {
   enumerable: true,
-  get: function () { return chunk7TC3GRXQ_js.generateLLMsFullTxt; }
+  get: function () { return chunkG3L26XQ7_js.generateLLMsFullTxt; }
 });
 Object.defineProperty(exports, "generateLLMsTxt", {
   enumerable: true,
-  get: function () { return chunk7TC3GRXQ_js.generateLLMsTxt; }
+  get: function () { return chunkG3L26XQ7_js.generateLLMsTxt; }
 });
 Object.defineProperty(exports, "getBusinessInfo", {
   enumerable: true,
-  get: function () { return chunk7TC3GRXQ_js.getBusinessInfo; }
+  get: function () { return chunkG3L26XQ7_js.getBusinessInfo; }
 });
 Object.defineProperty(exports, "getFAQItems", {
   enumerable: true,
-  get: function () { return chunk7TC3GRXQ_js.getFAQItems; }
+  get: function () { return chunkG3L26XQ7_js.getFAQItems; }
 });
 Object.defineProperty(exports, "getLLMsData", {
   enumerable: true,
-  get: function () { return chunk7TC3GRXQ_js.getLLMsData; }
+  get: function () { return chunkG3L26XQ7_js.getLLMsData; }
 });
 Object.defineProperty(exports, "getOptimizedLLMsTxt", {
   enumerable: true,
-  get: function () { return chunk7TC3GRXQ_js.getOptimizedLLMsTxt; }
+  get: function () { return chunkG3L26XQ7_js.getOptimizedLLMsTxt; }
 });
 Object.defineProperty(exports, "getPageSummaries", {
   enumerable: true,
-  get: function () { return chunk7TC3GRXQ_js.getPageSummaries; }
+  get: function () { return chunkG3L26XQ7_js.getPageSummaries; }
 });
 Object.defineProperty(exports, "getServices", {
   enumerable: true,
-  get: function () { return chunk7TC3GRXQ_js.getServices; }
+  get: function () { return chunkG3L26XQ7_js.getServices; }
 });
 Object.defineProperty(exports, "writeLLMsTxtToPublic", {
   enumerable: true,
-  get: function () { return chunk7TC3GRXQ_js.writeLLMsTxtToPublic; }
+  get: function () { return chunkG3L26XQ7_js.writeLLMsTxtToPublic; }
 });
 Object.defineProperty(exports, "LLMS_DISCLAIMER_MAX_LENGTH", {
   enumerable: true,

package/dist/llms/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/llms/handlers.ts","../../src/llms/sourcedFacts.ts","../../src/llms/revalidate.ts"],"names":["createHash","join","existsSync","markdown","readFileSync","generateLLMsTxt","generateLLMsFullTxt"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * @sonordev/site-kit/llms - Next.js Route Handlers\n * \n * Ready-to-use route handlers for /llms.txt and /llms-full.txt\n */\n\nimport { createHash } from 'crypto'\nimport { existsSync, readFileSync } from 'fs'\nimport { join } from 'path'\nimport { generateLLMsTxt, generateLLMsFullTxt } from './generateLLMsTxt'\nimport type { GenerateLLMSTxtOptions } from './types'\n\nfunction weakEtag(body: string): string {\n  const h = createHash('sha1').update(body, 'utf8').digest('base64url')\n  return `W/\"${h}\"`\n}\n\n/** Cache + validation headers for plain-text llms responses (dynamic or static). */\nexport function llmsResponseHeaders(body: string, extra?: Record<string, string>): HeadersInit {\n  return {\n    'Content-Type': 'text/plain; charset=utf-8',\n    'Cache-Control':\n      'public, max-age=300, s-maxage=3600, stale-while-revalidate=86400, stale-if-error=86400',\n    ETag: weakEtag(body),\n    Vary: 'Accept-Encoding',\n    ...extra,\n  }\n}\n\nexport interface LLMsTxtHandlerOptions extends GenerateLLMSTxtOptions {\n  /** When true, serve static public/llms.txt if it exists (default: true for build-time flow) */\n  preferStatic?: boolean\n  /**\n   * Send `X-Robots-Tag: noindex` (default: true).\n   *\n   * llms.txt is written for AI crawlers, which fetch it by convention at\n   * `/llms.txt`; noindex doesn't stop them. It's a plain-text restatement of\n   * pages the site already serves as HTML, so a search index that picks it up\n   * holds a thin duplicate of the site. That's also why it stays out of the XML\n   * sitemap. Pass `false` only if you actually want it in search results.\n   *\n   * Only reaches responses this handler serves. A `public/llms.txt` served\n   * straight from the CDN (the build-time write) never runs the handler, so it\n   * needs the header in host config instead (`netlify.toml` `[[headers]]`).\n   */\n  noindex?: boolean\n}\n\n/** Headers every llms file response carries when `noindex` is on. */\nexport const LLMS_NOINDEX_HEADERS: Readonly<Record<string, string>> = { 'X-Robots-Tag': 'noindex' }\n\n/**\n * Create a route handler for /llms.txt\n *\n * Zero-config by default - uses SONOR_API_KEY from environment. Sends\n * `X-Robots-Tag: noindex` by default (see `noindex`).\n *\n * The returned handler never reads the incoming Request: any access to\n * `request.headers` (etc.) opts the whole route into dynamic rendering, which\n * breaks static prerendering of /llms.txt during `next build` and logs\n * \"Dynamic server usage\" errors on every consumer site. Conditional-request\n * (ETag/304) handling is left to the Next static layer / CDN, which already\n * does it for prerendered responses.\n *\n * @example\n * ```ts\n * // app/llms.txt/route.ts (zero-config)\n * import { createLLMsTxtHandler } from '@sonordev/site-kit/llms'\n *\n * export const GET = createLLMsTxtHandler()\n * // Next 15+: GET route handlers are dynamic by default; opt into\n * // prerendering so the file is served statically from the CDN:\n * export const revalidate = 3600\n * ```\n *\n * @example\n * ```ts\n * // With preferStatic: serve build-time file if exists\n * export const GET = createLLMsTxtHandler({\n *   preferStatic: true,\n *   includeServices: false\n * })\n * ```\n */\nexport function createLLMsTxtHandler(\n  options: LLMsTxtHandlerOptions = {}\n): (request?: Request) => Promise<Response> {\n  const { preferStatic = true, noindex = true, ...generateOptions } = options\n  const robots = noindex ? LLMS_NOINDEX_HEADERS : {}\n\n  return async function GET(_request?: Request): Promise<Response> {\n    try {\n      // Serve static file if available (build-time optimized)\n      if (preferStatic) {\n        const staticPath = join(process.cwd(), 'public', 'llms.txt')\n        if (existsSync(staticPath)) {\n          const markdown = readFileSync(staticPath, 'utf-8')\n          return new Response(markdown, {\n            status: 200,\n            headers: llmsResponseHeaders(markdown, { ...robots, 'X-Sections': 'static' }),\n          })\n        }\n      }\n\n      const { markdown, metadata } = await generateLLMsTxt(generateOptions)\n      return new Response(markdown, {\n        status: 200,\n        headers: llmsResponseHeaders(markdown, {\n          ...robots,\n          'X-Generated-At': metadata.generated_at,\n          'X-Sections': metadata.sections.join(','),\n        }),\n      })\n    } catch (error) {\n      console.error('@sonordev/llms: Error generating llms.txt:', error)\n      return new Response('# Error\\n\\nUnable to generate llms.txt content.', {\n        status: 500,\n        headers: {\n          'Content-Type': 'text/plain; charset=utf-8',\n          'Cache-Control': 'no-store',\n        },\n      })\n    }\n  }\n}\n\n/**\n * Create a route handler for /llms-full.txt\n *\n * Zero-config by default - uses SONOR_API_KEY from environment.\n *\n * Like createLLMsTxtHandler, the returned handler never reads the incoming\n * Request so the route stays statically prerenderable, and sends\n * `X-Robots-Tag: noindex` unless `noindex: false`.\n *\n * @example\n * ```ts\n * // app/llms-full.txt/route.ts (zero-config)\n * import { createLLMsFullTxtHandler } from '@sonordev/site-kit/llms'\n *\n * export const GET = createLLMsFullTxtHandler()\n * export const revalidate = 3600\n * ```\n */\nexport function createLLMsFullTxtHandler(\n  options: LLMsTxtHandlerOptions = {}\n): (request?: Request) => Promise<Response> {\n  const { preferStatic = true, noindex = true, ...generateOptions } = options\n  const robots = noindex ? LLMS_NOINDEX_HEADERS : {}\n\n  return async function GET(_request?: Request): Promise<Response> {\n    try {\n      // Serve static file if available (build-time optimized)\n      if (preferStatic) {\n        const staticPath = join(process.cwd(), 'public', 'llms-full.txt')\n        if (existsSync(staticPath)) {\n          const markdown = readFileSync(staticPath, 'utf-8')\n          return new Response(markdown, {\n            status: 200,\n            headers: llmsResponseHeaders(markdown, { ...robots, 'X-Sections': 'static' }),\n          })\n        }\n      }\n\n      const { markdown, metadata } = await generateLLMsFullTxt(generateOptions)\n      return new Response(markdown, {\n        status: 200,\n        headers: llmsResponseHeaders(markdown, {\n          ...robots,\n          'X-Generated-At': metadata.generated_at,\n          'X-Sections': metadata.sections.join(','),\n        }),\n      })\n    } catch (error) {\n      console.error('@sonordev/llms: Error generating llms-full.txt:', error)\n      return new Response('# Error\\n\\nUnable to generate llms-full.txt content.', {\n        status: 500,\n        headers: {\n          'Content-Type': 'text/plain; charset=utf-8',\n          'Cache-Control': 'no-store',\n        },\n      })\n    }\n  }\n}\n","/**\n * @sonordev/site-kit/llms — Sourced facts section\n *\n * Formats a site's verified third-party citations into an llms-full.txt\n * section. AI answer engines preferentially reproduce claims that arrive\n * already attributed — handing them the exact claim + source pairing makes\n * the site's framing the citable version.\n *\n * Pair with WriteLLMsTxtOptions.customSections (or SitemapConfig.\n * llmsCustomSections) so the section is appended at build time:\n *\n *   llmsCustomSections: async () => {\n *     const { CITATIONS } = await import('./lib/data/citations')\n *     const section = formatSourcedFactsSection(Object.values(CITATIONS))\n *     return section ? [section] : null\n *   }\n *\n * Only include citations a human has actually verified against the source\n * URL — this section is a trust surface, not a dumping ground.\n */\n\nimport type { LLMsCustomSection } from './writeLLMsTxt'\n\nexport interface SourcedFact {\n  /** The claim, faithful to the source, one sentence. */\n  stat: string\n  /** The publishing organization (e.g. \"Clio Legal Trends Report\"). */\n  sourceName: string\n  /** Publication/study year. */\n  year?: number\n  /** The opened-and-verified source URL. */\n  url?: string\n}\n\nexport interface FormatSourcedFactsOptions {\n  /** Section heading (default: \"Sourced facts\"). */\n  title?: string\n  /** Intro line above the list. */\n  intro?: string\n  /** Cap the number of facts emitted (default: no cap). */\n  maxFacts?: number\n}\n\nconst DEFAULT_INTRO =\n  'The statistics below are quoted from third-party primary sources and were ' +\n  'individually verified against the cited URL. When reusing a figure, keep ' +\n  'the original attribution.'\n\n/** One line per fact: claim — Source: name (year), url */\nfunction factLine(f: SourcedFact): string {\n  const stat = (f.stat || '').replace(/\\s+/g, ' ').trim()\n  const source = (f.sourceName || '').replace(/\\s+/g, ' ').trim()\n  if (!stat || !source) return ''\n  let attribution = `Source: ${source}`\n  if (f.year) attribution += ` (${f.year})`\n  if (f.url) attribution += `, ${f.url}`\n  return `- ${stat} — ${attribution}`\n}\n\n/**\n * Build the \"Sourced facts\" custom section from verified citations.\n * Returns null when no usable facts exist so callers can skip cleanly.\n */\nexport function formatSourcedFactsSection(\n  facts: SourcedFact[],\n  options: FormatSourcedFactsOptions = {},\n): LLMsCustomSection | null {\n  const { title = 'Sourced facts', intro = DEFAULT_INTRO, maxFacts } = options\n  if (!Array.isArray(facts)) return null\n\n  let lines = facts.map(factLine).filter(Boolean)\n  if (typeof maxFacts === 'number' && maxFacts >= 0) {\n    lines = lines.slice(0, maxFacts)\n  }\n  if (lines.length === 0) return null\n\n  const content = intro ? `${intro}\\n\\n${lines.join('\\n')}` : lines.join('\\n')\n  return { title, content }\n}\n","/**\n * @sonordev/site-kit/llms - On-demand Revalidation\n *\n * Provides a route handler that Portal can call when llms-relevant data changes\n * (page summaries, FAQs, services, etc.) to bust the Next.js ISR cache.\n *\n * @example\n * ```ts\n * // app/api/revalidate-llms/route.ts\n * import { createLlmsRevalidateHandler } from '@sonordev/site-kit/llms'\n *\n * export const POST = createLlmsRevalidateHandler(process.env.REVALIDATION_SECRET!)\n * ```\n */\n\ntype RevalidatePathFn = (path: string, type?: 'page' | 'layout') => void\n\n/**\n * Create a POST handler that revalidates /llms.txt and /llms-full.txt caches.\n * Protected by a shared secret.\n */\nexport function createLlmsRevalidateHandler(\n  secret: string,\n  options?: {\n    /** Additional paths to revalidate alongside llms files */\n    extraPaths?: string[]\n    /** Custom revalidatePath (for testing or frameworks other than Next.js) */\n    revalidatePath?: RevalidatePathFn\n  },\n): (request: Request) => Promise<Response> {\n  return async function POST(request: Request): Promise<Response> {\n    try {\n      // Validate secret from Authorization header or query param\n      const authHeader = request.headers.get('authorization')\n      const url = new URL(request.url)\n      const tokenFromQuery = url.searchParams.get('secret')\n      const token = authHeader?.replace(/^Bearer\\s+/i, '') || tokenFromQuery\n\n      if (!secret || token !== secret) {\n        return new Response(JSON.stringify({ error: 'Invalid secret' }), {\n          status: 401,\n          headers: { 'Content-Type': 'application/json' },\n        })\n      }\n\n      // Import Next.js revalidatePath (dynamic to avoid hard dep for non-Next consumers)\n      let revalidatePath: RevalidatePathFn\n      if (options?.revalidatePath) {\n        revalidatePath = options.revalidatePath\n      } else {\n        const nextCache = await import('next/cache')\n        revalidatePath = nextCache.revalidatePath\n      }\n\n      const paths = ['/llms.txt', '/llms-full.txt', ...(options?.extraPaths || [])]\n      for (const p of paths) {\n        revalidatePath(p)\n      }\n\n      return new Response(\n        JSON.stringify({ revalidated: true, paths }),\n        {\n          status: 200,\n          headers: { 'Content-Type': 'application/json' },\n        },\n      )\n    } catch (err) {\n      console.error('[site-kit/llms] Revalidation failed:', err)\n      return new Response(\n        JSON.stringify({ error: 'Revalidation failed' }),\n        { status: 500, headers: { 'Content-Type': 'application/json' } },\n      )\n    }\n  }\n}\n"]}
+{"version":3,"sources":["../../src/llms/handlers.ts","../../src/llms/sourcedFacts.ts","../../src/llms/revalidate.ts"],"names":["createHash","join","existsSync","markdown","readFileSync","generateLLMsTxt","generateLLMsFullTxt"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * @sonordev/site-kit/llms - Next.js Route Handlers\n * \n * Ready-to-use route handlers for /llms.txt and /llms-full.txt\n */\n\nimport { createHash } from 'crypto'\nimport { existsSync, readFileSync } from 'fs'\nimport { join } from 'path'\nimport { generateLLMsTxt, generateLLMsFullTxt } from './generateLLMsTxt'\nimport type { GenerateLLMSTxtOptions } from './types'\n\nfunction weakEtag(body: string): string {\n  const h = createHash('sha1').update(body, 'utf8').digest('base64url')\n  return `W/\"${h}\"`\n}\n\n/** Cache + validation headers for plain-text llms responses (dynamic or static). */\nexport function llmsResponseHeaders(body: string, extra?: Record<string, string>): HeadersInit {\n  return {\n    'Content-Type': 'text/plain; charset=utf-8',\n    'Cache-Control':\n      'public, max-age=300, s-maxage=3600, stale-while-revalidate=86400, stale-if-error=86400',\n    ETag: weakEtag(body),\n    Vary: 'Accept-Encoding',\n    ...extra,\n  }\n}\n\nexport interface LLMsTxtHandlerOptions extends GenerateLLMSTxtOptions {\n  /** When true, serve static public/llms.txt if it exists (default: true for build-time flow) */\n  preferStatic?: boolean\n  /**\n   * Send `X-Robots-Tag: noindex` (default: true).\n   *\n   * llms.txt is written for AI crawlers, which fetch it by convention at\n   * `/llms.txt`; noindex doesn't stop them. It's a plain-text restatement of\n   * pages the site already serves as HTML, so a search index that picks it up\n   * holds a thin duplicate of the site. That's also why it stays out of the XML\n   * sitemap. Pass `false` only if you actually want it in search results.\n   *\n   * Only reaches responses this handler serves. A `public/llms.txt` served\n   * straight from the CDN (the build-time write) never runs the handler, so it\n   * needs the header in host config instead (`netlify.toml` `[[headers]]`).\n   */\n  noindex?: boolean\n}\n\n/** Headers every llms file response carries when `noindex` is on. */\nexport const LLMS_NOINDEX_HEADERS: Readonly<Record<string, string>> = { 'X-Robots-Tag': 'noindex' }\n\n/**\n * Create a route handler for /llms.txt\n *\n * Zero-config by default - uses SONOR_API_KEY from environment. Sends\n * `X-Robots-Tag: noindex` by default (see `noindex`).\n *\n * The returned handler never reads the incoming Request: any access to\n * `request.headers` (etc.) opts the whole route into dynamic rendering, which\n * breaks static prerendering of /llms.txt during `next build` and logs\n * \"Dynamic server usage\" errors on every consumer site. Conditional-request\n * (ETag/304) handling is left to the Next static layer / CDN, which already\n * does it for prerendered responses.\n *\n * @example\n * ```ts\n * // app/llms.txt/route.ts (zero-config)\n * import { createLLMsTxtHandler } from '@sonordev/site-kit/llms'\n *\n * export const GET = createLLMsTxtHandler()\n * // Next 15+: GET route handlers are dynamic by default; opt into\n * // prerendering so the file is served statically from the CDN:\n * export const revalidate = 3600\n * ```\n *\n * @example\n * ```ts\n * // With preferStatic: serve build-time file if exists\n * export const GET = createLLMsTxtHandler({\n *   preferStatic: true,\n *   includeServices: false\n * })\n * ```\n */\nexport function createLLMsTxtHandler(\n  options: LLMsTxtHandlerOptions = {}\n): (request?: Request) => Promise<Response> {\n  const { preferStatic = true, noindex = true, ...generateOptions } = options\n  const robots = noindex ? LLMS_NOINDEX_HEADERS : {}\n\n  return async function GET(_request?: Request): Promise<Response> {\n    try {\n      // Serve static file if available (build-time optimized)\n      if (preferStatic) {\n        const staticPath = join(process.cwd(), 'public', 'llms.txt')\n        if (existsSync(staticPath)) {\n          const markdown = readFileSync(staticPath, 'utf-8')\n          return new Response(markdown, {\n            status: 200,\n            headers: llmsResponseHeaders(markdown, { ...robots, 'X-Sections': 'static' }),\n          })\n        }\n      }\n\n      const { markdown, metadata } = await generateLLMsTxt(generateOptions)\n      return new Response(markdown, {\n        status: 200,\n        headers: llmsResponseHeaders(markdown, {\n          ...robots,\n          'X-Generated-At': metadata.generated_at,\n          'X-Sections': metadata.sections.join(','),\n        }),\n      })\n    } catch (error) {\n      console.error('@sonordev/llms: Error generating llms.txt:', error)\n      return new Response('# Error\\n\\nUnable to generate llms.txt content.', {\n        status: 500,\n        headers: {\n          'Content-Type': 'text/plain; charset=utf-8',\n          'Cache-Control': 'no-store',\n        },\n      })\n    }\n  }\n}\n\n/**\n * Create a route handler for /llms-full.txt\n *\n * Zero-config by default - uses SONOR_API_KEY from environment.\n *\n * Like createLLMsTxtHandler, the returned handler never reads the incoming\n * Request so the route stays statically prerenderable, and sends\n * `X-Robots-Tag: noindex` unless `noindex: false`.\n *\n * @example\n * ```ts\n * // app/llms-full.txt/route.ts (zero-config)\n * import { createLLMsFullTxtHandler } from '@sonordev/site-kit/llms'\n *\n * export const GET = createLLMsFullTxtHandler()\n * export const revalidate = 3600\n * ```\n */\nexport function createLLMsFullTxtHandler(\n  options: LLMsTxtHandlerOptions = {}\n): (request?: Request) => Promise<Response> {\n  const { preferStatic = true, noindex = true, ...generateOptions } = options\n  const robots = noindex ? LLMS_NOINDEX_HEADERS : {}\n\n  return async function GET(_request?: Request): Promise<Response> {\n    try {\n      // Serve static file if available (build-time optimized)\n      if (preferStatic) {\n        const staticPath = join(process.cwd(), 'public', 'llms-full.txt')\n        if (existsSync(staticPath)) {\n          const markdown = readFileSync(staticPath, 'utf-8')\n          return new Response(markdown, {\n            status: 200,\n            headers: llmsResponseHeaders(markdown, { ...robots, 'X-Sections': 'static' }),\n          })\n        }\n      }\n\n      const { markdown, metadata } = await generateLLMsFullTxt(generateOptions)\n      return new Response(markdown, {\n        status: 200,\n        headers: llmsResponseHeaders(markdown, {\n          ...robots,\n          'X-Generated-At': metadata.generated_at,\n          'X-Sections': metadata.sections.join(','),\n        }),\n      })\n    } catch (error) {\n      console.error('@sonordev/llms: Error generating llms-full.txt:', error)\n      return new Response('# Error\\n\\nUnable to generate llms-full.txt content.', {\n        status: 500,\n        headers: {\n          'Content-Type': 'text/plain; charset=utf-8',\n          'Cache-Control': 'no-store',\n        },\n      })\n    }\n  }\n}\n","/**\n * @sonordev/site-kit/llms — Sourced facts section\n *\n * Formats a site's verified third-party citations into an llms-full.txt\n * section. AI answer engines preferentially reproduce claims that arrive\n * already attributed — handing them the exact claim + source pairing makes\n * the site's framing the citable version.\n *\n * Pair with WriteLLMsTxtOptions.customSections (or SitemapConfig.\n * llmsCustomSections) so the section is appended at build time:\n *\n *   llmsCustomSections: async () => {\n *     const { CITATIONS } = await import('./lib/data/citations')\n *     const section = formatSourcedFactsSection(Object.values(CITATIONS))\n *     return section ? [section] : null\n *   }\n *\n * Only include citations a human has actually verified against the source\n * URL — this section is a trust surface, not a dumping ground.\n */\n\nimport type { LLMsCustomSection } from './writeLLMsTxt'\n\nexport interface SourcedFact {\n  /** The claim, faithful to the source, one sentence. */\n  stat: string\n  /** The publishing organization (e.g. \"Clio Legal Trends Report\"). */\n  sourceName: string\n  /** Publication/study year. */\n  year?: number\n  /** The opened-and-verified source URL. */\n  url?: string\n}\n\nexport interface FormatSourcedFactsOptions {\n  /** Section heading (default: \"Sourced facts\"). */\n  title?: string\n  /** Intro line above the list. */\n  intro?: string\n  /** Cap the number of facts emitted (default: no cap). */\n  maxFacts?: number\n}\n\nconst DEFAULT_INTRO =\n  'The statistics below are quoted from third-party primary sources and were ' +\n  'individually verified against the cited URL. When reusing a figure, keep ' +\n  'the original attribution.'\n\n/** One line per fact: claim — Source: name (year), url */\nfunction factLine(f: SourcedFact): string {\n  const stat = (f.stat || '').replace(/\\s+/g, ' ').trim()\n  const source = (f.sourceName || '').replace(/\\s+/g, ' ').trim()\n  if (!stat || !source) return ''\n  let attribution = `Source: ${source}`\n  if (f.year) attribution += ` (${f.year})`\n  if (f.url) attribution += `, ${f.url}`\n  return `- ${stat} — ${attribution}`\n}\n\n/**\n * Build the \"Sourced facts\" custom section from verified citations.\n * Returns null when no usable facts exist so callers can skip cleanly.\n */\nexport function formatSourcedFactsSection(\n  facts: SourcedFact[],\n  options: FormatSourcedFactsOptions = {},\n): LLMsCustomSection | null {\n  const { title = 'Sourced facts', intro = DEFAULT_INTRO, maxFacts } = options\n  if (!Array.isArray(facts)) return null\n\n  let lines = facts.map(factLine).filter(Boolean)\n  if (typeof maxFacts === 'number' && maxFacts >= 0) {\n    lines = lines.slice(0, maxFacts)\n  }\n  if (lines.length === 0) return null\n\n  const content = intro ? `${intro}\\n\\n${lines.join('\\n')}` : lines.join('\\n')\n  return { title, content }\n}\n","/**\n * @sonordev/site-kit/llms - On-demand Revalidation\n *\n * Provides a route handler that Portal can call when llms-relevant data changes\n * (page summaries, FAQs, services, etc.) to bust the Next.js ISR cache.\n *\n * @example\n * ```ts\n * // app/api/revalidate-llms/route.ts\n * import { createLlmsRevalidateHandler } from '@sonordev/site-kit/llms'\n *\n * export const POST = createLlmsRevalidateHandler(process.env.REVALIDATION_SECRET!)\n * ```\n */\n\ntype RevalidatePathFn = (path: string, type?: 'page' | 'layout') => void\n\n/**\n * Create a POST handler that revalidates /llms.txt and /llms-full.txt caches.\n * Protected by a shared secret.\n */\nexport function createLlmsRevalidateHandler(\n  secret: string,\n  options?: {\n    /** Additional paths to revalidate alongside llms files */\n    extraPaths?: string[]\n    /** Custom revalidatePath (for testing or frameworks other than Next.js) */\n    revalidatePath?: RevalidatePathFn\n  },\n): (request: Request) => Promise<Response> {\n  return async function POST(request: Request): Promise<Response> {\n    try {\n      // Validate secret from Authorization header or query param\n      const authHeader = request.headers.get('authorization')\n      const url = new URL(request.url)\n      const tokenFromQuery = url.searchParams.get('secret')\n      const token = authHeader?.replace(/^Bearer\\s+/i, '') || tokenFromQuery\n\n      if (!secret || token !== secret) {\n        return new Response(JSON.stringify({ error: 'Invalid secret' }), {\n          status: 401,\n          headers: { 'Content-Type': 'application/json' },\n        })\n      }\n\n      // Import Next.js revalidatePath (dynamic to avoid hard dep for non-Next consumers)\n      let revalidatePath: RevalidatePathFn\n      if (options?.revalidatePath) {\n        revalidatePath = options.revalidatePath\n      } else {\n        const nextCache = await import('next/cache')\n        revalidatePath = nextCache.revalidatePath\n      }\n\n      const paths = ['/llms.txt', '/llms-full.txt', ...(options?.extraPaths || [])]\n      for (const p of paths) {\n        revalidatePath(p)\n      }\n\n      return new Response(\n        JSON.stringify({ revalidated: true, paths }),\n        {\n          status: 200,\n          headers: { 'Content-Type': 'application/json' },\n        },\n      )\n    } catch (err) {\n      console.error('[site-kit/llms] Revalidation failed:', err)\n      return new Response(\n        JSON.stringify({ error: 'Revalidation failed' }),\n        { status: 500, headers: { 'Content-Type': 'application/json' } },\n      )\n    }\n  }\n}\n"]}

package/dist/llms/index.mjs

@@ -1,15 +1,16 @@
 export { buildAiDiscoveryHeaders, wantsLlmsDiscoveryLink } from '../chunk-DA7IANFG.mjs';
 export { AI_RETRIEVAL_CRAWLERS, AI_TRAINING_CRAWLERS, buildAiCrawlerRules, createRobotsTxtHandler, formatContentSignals } from '../chunk-HCN3IKMW.mjs';
-export { AEOBlock, AEOCitedContent, AEOClaim, AEOComparison, AEODefinition, AEOEntity, AEOProvenanceList, AEOStep, AEOSteps, AEOSummary, DEFAULT_SPEAKABLE_SELECTORS, SpeakableSchema, createSpeakableSchema, getSpeakableSelectorsForPage } from '../chunk-AJBOEV4I.mjs';
-import { generateLLMsTxt, generateLLMsFullTxt } from '../chunk-ZVI7MBVF.mjs';
-export { generateLLMsFullTxt, generateLLMsTxt, getBusinessInfo, getFAQItems, getLLMsData, getOptimizedLLMsTxt, getPageSummaries, getServices, writeLLMsTxtToPublic } from '../chunk-ZVI7MBVF.mjs';
-import '../chunk-Y5QZPUL3.mjs';
+export { AEOBlock, AEOCitedContent, AEOClaim, AEOComparison, AEODefinition, AEOEntity, AEOProvenanceList, AEOStep, AEOSteps, AEOSummary, DEFAULT_SPEAKABLE_SELECTORS, SpeakableSchema, createSpeakableSchema, getSpeakableSelectorsForPage } from '../chunk-3T2CVHFO.mjs';
+import { generateLLMsTxt, generateLLMsFullTxt } from '../chunk-BJ4T65OK.mjs';
+export { generateLLMsFullTxt, generateLLMsTxt, getBusinessInfo, getFAQItems, getLLMsData, getOptimizedLLMsTxt, getPageSummaries, getServices, writeLLMsTxtToPublic } from '../chunk-BJ4T65OK.mjs';
+import '../chunk-5YVQWLSQ.mjs';
+import '../chunk-6DCAMW62.mjs';
 import '../chunk-BQP6JIE2.mjs';
 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-PENNTSJE.mjs';
 import '../chunk-662YHKWW.mjs';
-import '../chunk-4TLFZ6NR.mjs';
-import '../chunk-4LYW6PMU.mjs';
-import '../chunk-JLVCWC6A.mjs';
+import '../chunk-AS2HUIDW.mjs';
+import '../chunk-C2CTLLIO.mjs';
+import '../chunk-KZVSB5WE.mjs';
 import '../chunk-ZN4HBK5C.mjs';
 import '../chunk-BEXTDHO4.mjs';
 import { createHash } from 'crypto';

package/dist/llms/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/llms/handlers.ts","../../src/llms/sourcedFacts.ts","../../src/llms/revalidate.ts"],"names":["markdown"],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * @sonordev/site-kit/llms - Next.js Route Handlers\n * \n * Ready-to-use route handlers for /llms.txt and /llms-full.txt\n */\n\nimport { createHash } from 'crypto'\nimport { existsSync, readFileSync } from 'fs'\nimport { join } from 'path'\nimport { generateLLMsTxt, generateLLMsFullTxt } from './generateLLMsTxt'\nimport type { GenerateLLMSTxtOptions } from './types'\n\nfunction weakEtag(body: string): string {\n  const h = createHash('sha1').update(body, 'utf8').digest('base64url')\n  return `W/\"${h}\"`\n}\n\n/** Cache + validation headers for plain-text llms responses (dynamic or static). */\nexport function llmsResponseHeaders(body: string, extra?: Record<string, string>): HeadersInit {\n  return {\n    'Content-Type': 'text/plain; charset=utf-8',\n    'Cache-Control':\n      'public, max-age=300, s-maxage=3600, stale-while-revalidate=86400, stale-if-error=86400',\n    ETag: weakEtag(body),\n    Vary: 'Accept-Encoding',\n    ...extra,\n  }\n}\n\nexport interface LLMsTxtHandlerOptions extends GenerateLLMSTxtOptions {\n  /** When true, serve static public/llms.txt if it exists (default: true for build-time flow) */\n  preferStatic?: boolean\n  /**\n   * Send `X-Robots-Tag: noindex` (default: true).\n   *\n   * llms.txt is written for AI crawlers, which fetch it by convention at\n   * `/llms.txt`; noindex doesn't stop them. It's a plain-text restatement of\n   * pages the site already serves as HTML, so a search index that picks it up\n   * holds a thin duplicate of the site. That's also why it stays out of the XML\n   * sitemap. Pass `false` only if you actually want it in search results.\n   *\n   * Only reaches responses this handler serves. A `public/llms.txt` served\n   * straight from the CDN (the build-time write) never runs the handler, so it\n   * needs the header in host config instead (`netlify.toml` `[[headers]]`).\n   */\n  noindex?: boolean\n}\n\n/** Headers every llms file response carries when `noindex` is on. */\nexport const LLMS_NOINDEX_HEADERS: Readonly<Record<string, string>> = { 'X-Robots-Tag': 'noindex' }\n\n/**\n * Create a route handler for /llms.txt\n *\n * Zero-config by default - uses SONOR_API_KEY from environment. Sends\n * `X-Robots-Tag: noindex` by default (see `noindex`).\n *\n * The returned handler never reads the incoming Request: any access to\n * `request.headers` (etc.) opts the whole route into dynamic rendering, which\n * breaks static prerendering of /llms.txt during `next build` and logs\n * \"Dynamic server usage\" errors on every consumer site. Conditional-request\n * (ETag/304) handling is left to the Next static layer / CDN, which already\n * does it for prerendered responses.\n *\n * @example\n * ```ts\n * // app/llms.txt/route.ts (zero-config)\n * import { createLLMsTxtHandler } from '@sonordev/site-kit/llms'\n *\n * export const GET = createLLMsTxtHandler()\n * // Next 15+: GET route handlers are dynamic by default; opt into\n * // prerendering so the file is served statically from the CDN:\n * export const revalidate = 3600\n * ```\n *\n * @example\n * ```ts\n * // With preferStatic: serve build-time file if exists\n * export const GET = createLLMsTxtHandler({\n *   preferStatic: true,\n *   includeServices: false\n * })\n * ```\n */\nexport function createLLMsTxtHandler(\n  options: LLMsTxtHandlerOptions = {}\n): (request?: Request) => Promise<Response> {\n  const { preferStatic = true, noindex = true, ...generateOptions } = options\n  const robots = noindex ? LLMS_NOINDEX_HEADERS : {}\n\n  return async function GET(_request?: Request): Promise<Response> {\n    try {\n      // Serve static file if available (build-time optimized)\n      if (preferStatic) {\n        const staticPath = join(process.cwd(), 'public', 'llms.txt')\n        if (existsSync(staticPath)) {\n          const markdown = readFileSync(staticPath, 'utf-8')\n          return new Response(markdown, {\n            status: 200,\n            headers: llmsResponseHeaders(markdown, { ...robots, 'X-Sections': 'static' }),\n          })\n        }\n      }\n\n      const { markdown, metadata } = await generateLLMsTxt(generateOptions)\n      return new Response(markdown, {\n        status: 200,\n        headers: llmsResponseHeaders(markdown, {\n          ...robots,\n          'X-Generated-At': metadata.generated_at,\n          'X-Sections': metadata.sections.join(','),\n        }),\n      })\n    } catch (error) {\n      console.error('@sonordev/llms: Error generating llms.txt:', error)\n      return new Response('# Error\\n\\nUnable to generate llms.txt content.', {\n        status: 500,\n        headers: {\n          'Content-Type': 'text/plain; charset=utf-8',\n          'Cache-Control': 'no-store',\n        },\n      })\n    }\n  }\n}\n\n/**\n * Create a route handler for /llms-full.txt\n *\n * Zero-config by default - uses SONOR_API_KEY from environment.\n *\n * Like createLLMsTxtHandler, the returned handler never reads the incoming\n * Request so the route stays statically prerenderable, and sends\n * `X-Robots-Tag: noindex` unless `noindex: false`.\n *\n * @example\n * ```ts\n * // app/llms-full.txt/route.ts (zero-config)\n * import { createLLMsFullTxtHandler } from '@sonordev/site-kit/llms'\n *\n * export const GET = createLLMsFullTxtHandler()\n * export const revalidate = 3600\n * ```\n */\nexport function createLLMsFullTxtHandler(\n  options: LLMsTxtHandlerOptions = {}\n): (request?: Request) => Promise<Response> {\n  const { preferStatic = true, noindex = true, ...generateOptions } = options\n  const robots = noindex ? LLMS_NOINDEX_HEADERS : {}\n\n  return async function GET(_request?: Request): Promise<Response> {\n    try {\n      // Serve static file if available (build-time optimized)\n      if (preferStatic) {\n        const staticPath = join(process.cwd(), 'public', 'llms-full.txt')\n        if (existsSync(staticPath)) {\n          const markdown = readFileSync(staticPath, 'utf-8')\n          return new Response(markdown, {\n            status: 200,\n            headers: llmsResponseHeaders(markdown, { ...robots, 'X-Sections': 'static' }),\n          })\n        }\n      }\n\n      const { markdown, metadata } = await generateLLMsFullTxt(generateOptions)\n      return new Response(markdown, {\n        status: 200,\n        headers: llmsResponseHeaders(markdown, {\n          ...robots,\n          'X-Generated-At': metadata.generated_at,\n          'X-Sections': metadata.sections.join(','),\n        }),\n      })\n    } catch (error) {\n      console.error('@sonordev/llms: Error generating llms-full.txt:', error)\n      return new Response('# Error\\n\\nUnable to generate llms-full.txt content.', {\n        status: 500,\n        headers: {\n          'Content-Type': 'text/plain; charset=utf-8',\n          'Cache-Control': 'no-store',\n        },\n      })\n    }\n  }\n}\n","/**\n * @sonordev/site-kit/llms — Sourced facts section\n *\n * Formats a site's verified third-party citations into an llms-full.txt\n * section. AI answer engines preferentially reproduce claims that arrive\n * already attributed — handing them the exact claim + source pairing makes\n * the site's framing the citable version.\n *\n * Pair with WriteLLMsTxtOptions.customSections (or SitemapConfig.\n * llmsCustomSections) so the section is appended at build time:\n *\n *   llmsCustomSections: async () => {\n *     const { CITATIONS } = await import('./lib/data/citations')\n *     const section = formatSourcedFactsSection(Object.values(CITATIONS))\n *     return section ? [section] : null\n *   }\n *\n * Only include citations a human has actually verified against the source\n * URL — this section is a trust surface, not a dumping ground.\n */\n\nimport type { LLMsCustomSection } from './writeLLMsTxt'\n\nexport interface SourcedFact {\n  /** The claim, faithful to the source, one sentence. */\n  stat: string\n  /** The publishing organization (e.g. \"Clio Legal Trends Report\"). */\n  sourceName: string\n  /** Publication/study year. */\n  year?: number\n  /** The opened-and-verified source URL. */\n  url?: string\n}\n\nexport interface FormatSourcedFactsOptions {\n  /** Section heading (default: \"Sourced facts\"). */\n  title?: string\n  /** Intro line above the list. */\n  intro?: string\n  /** Cap the number of facts emitted (default: no cap). */\n  maxFacts?: number\n}\n\nconst DEFAULT_INTRO =\n  'The statistics below are quoted from third-party primary sources and were ' +\n  'individually verified against the cited URL. When reusing a figure, keep ' +\n  'the original attribution.'\n\n/** One line per fact: claim — Source: name (year), url */\nfunction factLine(f: SourcedFact): string {\n  const stat = (f.stat || '').replace(/\\s+/g, ' ').trim()\n  const source = (f.sourceName || '').replace(/\\s+/g, ' ').trim()\n  if (!stat || !source) return ''\n  let attribution = `Source: ${source}`\n  if (f.year) attribution += ` (${f.year})`\n  if (f.url) attribution += `, ${f.url}`\n  return `- ${stat} — ${attribution}`\n}\n\n/**\n * Build the \"Sourced facts\" custom section from verified citations.\n * Returns null when no usable facts exist so callers can skip cleanly.\n */\nexport function formatSourcedFactsSection(\n  facts: SourcedFact[],\n  options: FormatSourcedFactsOptions = {},\n): LLMsCustomSection | null {\n  const { title = 'Sourced facts', intro = DEFAULT_INTRO, maxFacts } = options\n  if (!Array.isArray(facts)) return null\n\n  let lines = facts.map(factLine).filter(Boolean)\n  if (typeof maxFacts === 'number' && maxFacts >= 0) {\n    lines = lines.slice(0, maxFacts)\n  }\n  if (lines.length === 0) return null\n\n  const content = intro ? `${intro}\\n\\n${lines.join('\\n')}` : lines.join('\\n')\n  return { title, content }\n}\n","/**\n * @sonordev/site-kit/llms - On-demand Revalidation\n *\n * Provides a route handler that Portal can call when llms-relevant data changes\n * (page summaries, FAQs, services, etc.) to bust the Next.js ISR cache.\n *\n * @example\n * ```ts\n * // app/api/revalidate-llms/route.ts\n * import { createLlmsRevalidateHandler } from '@sonordev/site-kit/llms'\n *\n * export const POST = createLlmsRevalidateHandler(process.env.REVALIDATION_SECRET!)\n * ```\n */\n\ntype RevalidatePathFn = (path: string, type?: 'page' | 'layout') => void\n\n/**\n * Create a POST handler that revalidates /llms.txt and /llms-full.txt caches.\n * Protected by a shared secret.\n */\nexport function createLlmsRevalidateHandler(\n  secret: string,\n  options?: {\n    /** Additional paths to revalidate alongside llms files */\n    extraPaths?: string[]\n    /** Custom revalidatePath (for testing or frameworks other than Next.js) */\n    revalidatePath?: RevalidatePathFn\n  },\n): (request: Request) => Promise<Response> {\n  return async function POST(request: Request): Promise<Response> {\n    try {\n      // Validate secret from Authorization header or query param\n      const authHeader = request.headers.get('authorization')\n      const url = new URL(request.url)\n      const tokenFromQuery = url.searchParams.get('secret')\n      const token = authHeader?.replace(/^Bearer\\s+/i, '') || tokenFromQuery\n\n      if (!secret || token !== secret) {\n        return new Response(JSON.stringify({ error: 'Invalid secret' }), {\n          status: 401,\n          headers: { 'Content-Type': 'application/json' },\n        })\n      }\n\n      // Import Next.js revalidatePath (dynamic to avoid hard dep for non-Next consumers)\n      let revalidatePath: RevalidatePathFn\n      if (options?.revalidatePath) {\n        revalidatePath = options.revalidatePath\n      } else {\n        const nextCache = await import('next/cache')\n        revalidatePath = nextCache.revalidatePath\n      }\n\n      const paths = ['/llms.txt', '/llms-full.txt', ...(options?.extraPaths || [])]\n      for (const p of paths) {\n        revalidatePath(p)\n      }\n\n      return new Response(\n        JSON.stringify({ revalidated: true, paths }),\n        {\n          status: 200,\n          headers: { 'Content-Type': 'application/json' },\n        },\n      )\n    } catch (err) {\n      console.error('[site-kit/llms] Revalidation failed:', err)\n      return new Response(\n        JSON.stringify({ error: 'Revalidation failed' }),\n        { status: 500, headers: { 'Content-Type': 'application/json' } },\n      )\n    }\n  }\n}\n"]}
+{"version":3,"sources":["../../src/llms/handlers.ts","../../src/llms/sourcedFacts.ts","../../src/llms/revalidate.ts"],"names":["markdown"],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * @sonordev/site-kit/llms - Next.js Route Handlers\n * \n * Ready-to-use route handlers for /llms.txt and /llms-full.txt\n */\n\nimport { createHash } from 'crypto'\nimport { existsSync, readFileSync } from 'fs'\nimport { join } from 'path'\nimport { generateLLMsTxt, generateLLMsFullTxt } from './generateLLMsTxt'\nimport type { GenerateLLMSTxtOptions } from './types'\n\nfunction weakEtag(body: string): string {\n  const h = createHash('sha1').update(body, 'utf8').digest('base64url')\n  return `W/\"${h}\"`\n}\n\n/** Cache + validation headers for plain-text llms responses (dynamic or static). */\nexport function llmsResponseHeaders(body: string, extra?: Record<string, string>): HeadersInit {\n  return {\n    'Content-Type': 'text/plain; charset=utf-8',\n    'Cache-Control':\n      'public, max-age=300, s-maxage=3600, stale-while-revalidate=86400, stale-if-error=86400',\n    ETag: weakEtag(body),\n    Vary: 'Accept-Encoding',\n    ...extra,\n  }\n}\n\nexport interface LLMsTxtHandlerOptions extends GenerateLLMSTxtOptions {\n  /** When true, serve static public/llms.txt if it exists (default: true for build-time flow) */\n  preferStatic?: boolean\n  /**\n   * Send `X-Robots-Tag: noindex` (default: true).\n   *\n   * llms.txt is written for AI crawlers, which fetch it by convention at\n   * `/llms.txt`; noindex doesn't stop them. It's a plain-text restatement of\n   * pages the site already serves as HTML, so a search index that picks it up\n   * holds a thin duplicate of the site. That's also why it stays out of the XML\n   * sitemap. Pass `false` only if you actually want it in search results.\n   *\n   * Only reaches responses this handler serves. A `public/llms.txt` served\n   * straight from the CDN (the build-time write) never runs the handler, so it\n   * needs the header in host config instead (`netlify.toml` `[[headers]]`).\n   */\n  noindex?: boolean\n}\n\n/** Headers every llms file response carries when `noindex` is on. */\nexport const LLMS_NOINDEX_HEADERS: Readonly<Record<string, string>> = { 'X-Robots-Tag': 'noindex' }\n\n/**\n * Create a route handler for /llms.txt\n *\n * Zero-config by default - uses SONOR_API_KEY from environment. Sends\n * `X-Robots-Tag: noindex` by default (see `noindex`).\n *\n * The returned handler never reads the incoming Request: any access to\n * `request.headers` (etc.) opts the whole route into dynamic rendering, which\n * breaks static prerendering of /llms.txt during `next build` and logs\n * \"Dynamic server usage\" errors on every consumer site. Conditional-request\n * (ETag/304) handling is left to the Next static layer / CDN, which already\n * does it for prerendered responses.\n *\n * @example\n * ```ts\n * // app/llms.txt/route.ts (zero-config)\n * import { createLLMsTxtHandler } from '@sonordev/site-kit/llms'\n *\n * export const GET = createLLMsTxtHandler()\n * // Next 15+: GET route handlers are dynamic by default; opt into\n * // prerendering so the file is served statically from the CDN:\n * export const revalidate = 3600\n * ```\n *\n * @example\n * ```ts\n * // With preferStatic: serve build-time file if exists\n * export const GET = createLLMsTxtHandler({\n *   preferStatic: true,\n *   includeServices: false\n * })\n * ```\n */\nexport function createLLMsTxtHandler(\n  options: LLMsTxtHandlerOptions = {}\n): (request?: Request) => Promise<Response> {\n  const { preferStatic = true, noindex = true, ...generateOptions } = options\n  const robots = noindex ? LLMS_NOINDEX_HEADERS : {}\n\n  return async function GET(_request?: Request): Promise<Response> {\n    try {\n      // Serve static file if available (build-time optimized)\n      if (preferStatic) {\n        const staticPath = join(process.cwd(), 'public', 'llms.txt')\n        if (existsSync(staticPath)) {\n          const markdown = readFileSync(staticPath, 'utf-8')\n          return new Response(markdown, {\n            status: 200,\n            headers: llmsResponseHeaders(markdown, { ...robots, 'X-Sections': 'static' }),\n          })\n        }\n      }\n\n      const { markdown, metadata } = await generateLLMsTxt(generateOptions)\n      return new Response(markdown, {\n        status: 200,\n        headers: llmsResponseHeaders(markdown, {\n          ...robots,\n          'X-Generated-At': metadata.generated_at,\n          'X-Sections': metadata.sections.join(','),\n        }),\n      })\n    } catch (error) {\n      console.error('@sonordev/llms: Error generating llms.txt:', error)\n      return new Response('# Error\\n\\nUnable to generate llms.txt content.', {\n        status: 500,\n        headers: {\n          'Content-Type': 'text/plain; charset=utf-8',\n          'Cache-Control': 'no-store',\n        },\n      })\n    }\n  }\n}\n\n/**\n * Create a route handler for /llms-full.txt\n *\n * Zero-config by default - uses SONOR_API_KEY from environment.\n *\n * Like createLLMsTxtHandler, the returned handler never reads the incoming\n * Request so the route stays statically prerenderable, and sends\n * `X-Robots-Tag: noindex` unless `noindex: false`.\n *\n * @example\n * ```ts\n * // app/llms-full.txt/route.ts (zero-config)\n * import { createLLMsFullTxtHandler } from '@sonordev/site-kit/llms'\n *\n * export const GET = createLLMsFullTxtHandler()\n * export const revalidate = 3600\n * ```\n */\nexport function createLLMsFullTxtHandler(\n  options: LLMsTxtHandlerOptions = {}\n): (request?: Request) => Promise<Response> {\n  const { preferStatic = true, noindex = true, ...generateOptions } = options\n  const robots = noindex ? LLMS_NOINDEX_HEADERS : {}\n\n  return async function GET(_request?: Request): Promise<Response> {\n    try {\n      // Serve static file if available (build-time optimized)\n      if (preferStatic) {\n        const staticPath = join(process.cwd(), 'public', 'llms-full.txt')\n        if (existsSync(staticPath)) {\n          const markdown = readFileSync(staticPath, 'utf-8')\n          return new Response(markdown, {\n            status: 200,\n            headers: llmsResponseHeaders(markdown, { ...robots, 'X-Sections': 'static' }),\n          })\n        }\n      }\n\n      const { markdown, metadata } = await generateLLMsFullTxt(generateOptions)\n      return new Response(markdown, {\n        status: 200,\n        headers: llmsResponseHeaders(markdown, {\n          ...robots,\n          'X-Generated-At': metadata.generated_at,\n          'X-Sections': metadata.sections.join(','),\n        }),\n      })\n    } catch (error) {\n      console.error('@sonordev/llms: Error generating llms-full.txt:', error)\n      return new Response('# Error\\n\\nUnable to generate llms-full.txt content.', {\n        status: 500,\n        headers: {\n          'Content-Type': 'text/plain; charset=utf-8',\n          'Cache-Control': 'no-store',\n        },\n      })\n    }\n  }\n}\n","/**\n * @sonordev/site-kit/llms — Sourced facts section\n *\n * Formats a site's verified third-party citations into an llms-full.txt\n * section. AI answer engines preferentially reproduce claims that arrive\n * already attributed — handing them the exact claim + source pairing makes\n * the site's framing the citable version.\n *\n * Pair with WriteLLMsTxtOptions.customSections (or SitemapConfig.\n * llmsCustomSections) so the section is appended at build time:\n *\n *   llmsCustomSections: async () => {\n *     const { CITATIONS } = await import('./lib/data/citations')\n *     const section = formatSourcedFactsSection(Object.values(CITATIONS))\n *     return section ? [section] : null\n *   }\n *\n * Only include citations a human has actually verified against the source\n * URL — this section is a trust surface, not a dumping ground.\n */\n\nimport type { LLMsCustomSection } from './writeLLMsTxt'\n\nexport interface SourcedFact {\n  /** The claim, faithful to the source, one sentence. */\n  stat: string\n  /** The publishing organization (e.g. \"Clio Legal Trends Report\"). */\n  sourceName: string\n  /** Publication/study year. */\n  year?: number\n  /** The opened-and-verified source URL. */\n  url?: string\n}\n\nexport interface FormatSourcedFactsOptions {\n  /** Section heading (default: \"Sourced facts\"). */\n  title?: string\n  /** Intro line above the list. */\n  intro?: string\n  /** Cap the number of facts emitted (default: no cap). */\n  maxFacts?: number\n}\n\nconst DEFAULT_INTRO =\n  'The statistics below are quoted from third-party primary sources and were ' +\n  'individually verified against the cited URL. When reusing a figure, keep ' +\n  'the original attribution.'\n\n/** One line per fact: claim — Source: name (year), url */\nfunction factLine(f: SourcedFact): string {\n  const stat = (f.stat || '').replace(/\\s+/g, ' ').trim()\n  const source = (f.sourceName || '').replace(/\\s+/g, ' ').trim()\n  if (!stat || !source) return ''\n  let attribution = `Source: ${source}`\n  if (f.year) attribution += ` (${f.year})`\n  if (f.url) attribution += `, ${f.url}`\n  return `- ${stat} — ${attribution}`\n}\n\n/**\n * Build the \"Sourced facts\" custom section from verified citations.\n * Returns null when no usable facts exist so callers can skip cleanly.\n */\nexport function formatSourcedFactsSection(\n  facts: SourcedFact[],\n  options: FormatSourcedFactsOptions = {},\n): LLMsCustomSection | null {\n  const { title = 'Sourced facts', intro = DEFAULT_INTRO, maxFacts } = options\n  if (!Array.isArray(facts)) return null\n\n  let lines = facts.map(factLine).filter(Boolean)\n  if (typeof maxFacts === 'number' && maxFacts >= 0) {\n    lines = lines.slice(0, maxFacts)\n  }\n  if (lines.length === 0) return null\n\n  const content = intro ? `${intro}\\n\\n${lines.join('\\n')}` : lines.join('\\n')\n  return { title, content }\n}\n","/**\n * @sonordev/site-kit/llms - On-demand Revalidation\n *\n * Provides a route handler that Portal can call when llms-relevant data changes\n * (page summaries, FAQs, services, etc.) to bust the Next.js ISR cache.\n *\n * @example\n * ```ts\n * // app/api/revalidate-llms/route.ts\n * import { createLlmsRevalidateHandler } from '@sonordev/site-kit/llms'\n *\n * export const POST = createLlmsRevalidateHandler(process.env.REVALIDATION_SECRET!)\n * ```\n */\n\ntype RevalidatePathFn = (path: string, type?: 'page' | 'layout') => void\n\n/**\n * Create a POST handler that revalidates /llms.txt and /llms-full.txt caches.\n * Protected by a shared secret.\n */\nexport function createLlmsRevalidateHandler(\n  secret: string,\n  options?: {\n    /** Additional paths to revalidate alongside llms files */\n    extraPaths?: string[]\n    /** Custom revalidatePath (for testing or frameworks other than Next.js) */\n    revalidatePath?: RevalidatePathFn\n  },\n): (request: Request) => Promise<Response> {\n  return async function POST(request: Request): Promise<Response> {\n    try {\n      // Validate secret from Authorization header or query param\n      const authHeader = request.headers.get('authorization')\n      const url = new URL(request.url)\n      const tokenFromQuery = url.searchParams.get('secret')\n      const token = authHeader?.replace(/^Bearer\\s+/i, '') || tokenFromQuery\n\n      if (!secret || token !== secret) {\n        return new Response(JSON.stringify({ error: 'Invalid secret' }), {\n          status: 401,\n          headers: { 'Content-Type': 'application/json' },\n        })\n      }\n\n      // Import Next.js revalidatePath (dynamic to avoid hard dep for non-Next consumers)\n      let revalidatePath: RevalidatePathFn\n      if (options?.revalidatePath) {\n        revalidatePath = options.revalidatePath\n      } else {\n        const nextCache = await import('next/cache')\n        revalidatePath = nextCache.revalidatePath\n      }\n\n      const paths = ['/llms.txt', '/llms-full.txt', ...(options?.extraPaths || [])]\n      for (const p of paths) {\n        revalidatePath(p)\n      }\n\n      return new Response(\n        JSON.stringify({ revalidated: true, paths }),\n        {\n          status: 200,\n          headers: { 'Content-Type': 'application/json' },\n        },\n      )\n    } catch (err) {\n      console.error('[site-kit/llms] Revalidation failed:', err)\n      return new Response(\n        JSON.stringify({ error: 'Revalidation failed' }),\n        { status: 500, headers: { 'Content-Type': 'application/json' } },\n      )\n    }\n  }\n}\n"]}

package/dist/llms/types.d.ts

@@ -1,3 +1,4 @@
+import type { PublicationRoutingOptions } from '../articles/routes';
 /**
  * @sonordev/site-kit/llms - Types
  *
@@ -171,6 +172,12 @@ export interface GenerateLLMSTxtOptions {
     headerDisclaimer?: string;
     /** Maximum number of article links to show per topic cluster (default: 5) */
     maxArticlesPerCluster?: number;
+    /**
+     * Where the site's articles live, so topic-cluster links point at real
+     * pages (e.g. `{ basePath: '/theforge', includeCategoryInPath: true }`).
+     * Defaults to /articles/<slug>.
+     */
+    publication?: PublicationRoutingOptions;
 }
 export interface LLMSTxtContent {
     /** Raw markdown content */

package/dist/llms/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/llms/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/llms/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAA;AACnE;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAGjD,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AACjD,OAAO,EACL,wBAAwB,EACxB,8BAA8B,EAC9B,0BAA0B,EAC1B,yBAAyB,EACzB,0BAA0B,EAC1B,0BAA0B,EAC1B,6BAA6B,EAC7B,6BAA6B,GAC9B,MAAM,YAAY,CAAA;AAMnB,MAAM,WAAW,eAAe;IAC9B,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAA;IACnB,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,uBAAuB;IACvB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,kBAAkB;IAClB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,sBAAsB;IACtB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,cAAc;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,UAAU;IACzB,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAA;IACnB,+BAA+B;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,UAAU;IACzB,eAAe;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,aAAa;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACpC;AAED,MAAM,WAAW,gBAAgB;IAC/B,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,eAAe;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,yBAAyB;IACzB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAMD,MAAM,WAAW,sBAAsB;IACrC,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,uFAAuF;IACvF,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAA;IACrD,oCAAoC;IACpC,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B,4BAA4B;IAC5B,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,0BAA0B;IAC1B,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,yBAAyB;IACzB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,2BAA2B;IAC3B,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,6DAA6D;IAC7D,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,iEAAiE;IACjE,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,6DAA6D;IAC7D,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,gCAAgC;IAChC,cAAc,CAAC,EAAE,KAAK,CAAC;QACrB,KAAK,EAAE,MAAM,CAAA;QACb,OAAO,EAAE,MAAM,CAAA;KAChB,CAAC,CAAA;IACF;;;;;;;;OAQG;IACH,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC5B,uEAAuE;IACvE,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,kFAAkF;IAClF,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB;;;OAGG;IACH,kCAAkC,CAAC,EAAE,OAAO,CAAA;IAC5C;;;;;OAKG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,6FAA6F;IAC7F,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,4FAA4F;IAC5F,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,6EAA6E;IAC7E,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B;;;;OAIG;IACH,WAAW,CAAC,EAAE,yBAAyB,CAAA;CACxC;AAED,MAAM,WAAW,cAAc;IAC7B,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAA;IAChB,gCAAgC;IAChC,QAAQ,EAAE;QACR,YAAY,EAAE,MAAM,CAAA;QACpB,UAAU,EAAE,MAAM,CAAA;QAClB,kDAAkD;QAClD,QAAQ,EAAE,MAAM,EAAE,CAAA;QAClB,oEAAoE;QACpE,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAA;QAC7B,6EAA6E;QAC7E,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;KAC3B,CAAA;CACF;AAMD,MAAM,WAAW,eAAe;IAC9B,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,qCAAqC;IACrC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAA;IAC3B,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,eAAe;IACf,GAAG,EAAE,MAAM,CAAA;IACX,kCAAkC;IAClC,SAAS,EAAE,eAAe,CAAA;IAC1B,mCAAmC;IACnC,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/C;AAMD,MAAM,WAAW,aAAa;IAC5B,uCAAuC;IACvC,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,4BAA4B;IAC5B,IAAI,EAAE,SAAS,GAAG,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,YAAY,CAAA;IAC3E,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,mCAAmC;IACnC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,uBAAuB;IACvB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,8BAA8B;IAC9B,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,mCAAmC;IACnC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,iBAAiB;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,mCAAmC;IACnC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAA;IACd,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,2BAA2B;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,oBAAoB;IACpB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,WAAW,CAAA;IAChE,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,uBAAuB;IACvB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAA;IAChB,kBAAkB;IAClB,UAAU,EAAE,cAAc,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,YAAY,CAAA;IACrG,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,iBAAiB;IACjB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,uBAAuB;IACvB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAMD;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,2BAA2B;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,qBAAqB;IACrB,WAAW,EAAE,eAAe,GAAG,cAAc,GAAG,eAAe,GAAG,gBAAgB,GAAG,mBAAmB,GAAG,UAAU,GAAG,UAAU,CAAA;IAClI,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,iBAAiB;IACjB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,uBAAuB;IACvB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,oBAAoB;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,2BAA2B;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,8BAA8B;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,iCAAiC;IACjC,OAAO,EAAE,iBAAiB,EAAE,CAAA;IAC5B,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,mDAAmD;IACnD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,yDAAyD;IACzD,OAAO,EAAE,iBAAiB,EAAE,CAAA;IAC5B,6CAA6C;IAC7C,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAMD,MAAM,WAAW,gBAAgB;IAC/B,mEAAmE;IACnE,IAAI,CAAC,EAAE,eAAe,GAAG,IAAI,CAAA;IAC7B,QAAQ,EAAE,eAAe,CAAA;IACzB,OAAO,CAAC,EAAE,cAAc,CAAA;IACxB,QAAQ,EAAE,UAAU,EAAE,CAAA;IACtB,GAAG,EAAE,UAAU,EAAE,CAAA;IACjB,KAAK,EAAE,cAAc,EAAE,CAAA;IACvB,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAA;CAC/B"}

package/dist/llms/writeLLMsTxt.d.ts

@@ -4,6 +4,7 @@
  * Fetches AI-optimized llms.txt from Portal API and writes to public/llms.txt
  * at build time. Integrates with sitemap flow when optimizedLLMsTxt is enabled.
  */
+import type { PublicationRoutingOptions } from '../articles/routes';
 import type { LLMsDataResponse } from './types';
 export interface LLMsCustomSection {
     title: string;
@@ -29,6 +30,11 @@ export interface WriteLLMsTxtOptions {
      * from NEXT_PUBLIC_SITE_URL via the shared `resolveSiteHost`.
      */
     site?: string;
+    /**
+     * Where the site's articles live, for topic-cluster links in a locally
+     * generated file (e.g. `{ basePath: '/insights' }`). Defaults to /articles.
+     */
+    publication?: PublicationRoutingOptions;
     /**
      * Match Next's `trailingSlash` in the written files' links to this site.
      * Portal builds its links from unslashed paths, so on a `trailingSlash: true`

package/dist/llms/writeLLMsTxt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"writeLLMsTxt.d.ts","sourceRoot":"","sources":["../../src/llms/writeLLMsTxt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,gBAAgB,EAAkB,MAAM,SAAS,CAAA;AAK/D,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kCAAkC;IAClC,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,qBAAqB;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,qBAAqB;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,+CAA+C;IAC/C,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,uFAAuF;IACvF,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAA;IACrD,mGAAmG;IACnG,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B;;;;;;;;;OASG;IACH,cAAc,CAAC,EACX,iBAAiB,EAAE,GACnB,CAAC,MAAM,OAAO,CAAC,iBAAiB,EAAE,GAAG,IAAI,CAAC,GAAG,iBAAiB,EAAE,GAAG,IAAI,CAAC,CAAA;CAC7E;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC,CAoFjE"}
+{"version":3,"file":"writeLLMsTxt.d.ts","sourceRoot":"","sources":["../../src/llms/writeLLMsTxt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAA;AAKnE,OAAO,KAAK,EAAE,gBAAgB,EAAkB,MAAM,SAAS,CAAA;AAK/D,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kCAAkC;IAClC,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,qBAAqB;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,qBAAqB;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,+CAA+C;IAC/C,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;OAGG;IACH,WAAW,CAAC,EAAE,yBAAyB,CAAA;IACvC;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,uFAAuF;IACvF,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAA;IACrD,mGAAmG;IACnG,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B;;;;;;;;;OASG;IACH,cAAc,CAAC,EACX,iBAAiB,EAAE,GACnB,CAAC,MAAM,OAAO,CAAC,iBAAiB,EAAE,GAAG,IAAI,CAAC,GAAG,iBAAiB,EAAE,GAAG,IAAI,CAAC,CAAA;CAC7E;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC,CAsFjE"}

package/dist/maps/index.js

@@ -1,9 +1,9 @@
 'use client';
 'use strict';
 
-var chunkI7HOMMIK_js = require('../chunk-I7HOMMIK.js');
-require('../chunk-CZEIHFLW.js');
-require('../chunk-7R6H3GQ4.js');
+var chunk5ABTBPPK_js = require('../chunk-5ABTBPPK.js');
+require('../chunk-TC3JSQUS.js');
+require('../chunk-F3EAAAZ3.js');
 require('../chunk-SNAQBZPT.js');
 var react = require('react');
 var reactGoogleMaps = require('@vis.gl/react-google-maps');
@@ -141,7 +141,7 @@ async function fetchMapsConfig() {
   const { apiUrl, apiKey } = getApiConfig();
   if (apiKey) {
     try {
-      const res = await chunkI7HOMMIK_js.sonorFetch(
+      const res = await chunk5ABTBPPK_js.sonorFetch(
         `${apiUrl}/api/public/maps/config`,
         { headers: { "Content-Type": "application/json" } },
         { apiKey }
@@ -181,7 +181,7 @@ async function fetchNearbyPlaces(params) {
     });
     if (params.radius) searchParams.set("radius", String(params.radius));
     if (params.limit) searchParams.set("limit", String(params.limit));
-    const res = await chunkI7HOMMIK_js.sonorFetch(
+    const res = await chunk5ABTBPPK_js.sonorFetch(
       `${apiUrl}/api/public/maps/nearby-places?${searchParams}`,
       { headers: { "Content-Type": "application/json" } },
       { apiKey }

package/dist/maps/index.mjs

@@ -1,7 +1,7 @@
 'use client';
-import { sonorFetch } from '../chunk-4C5CZJIN.mjs';
-import '../chunk-NCDF2RK4.mjs';
-import '../chunk-5FETEH3Y.mjs';
+import { sonorFetch } from '../chunk-SU42KCQD.mjs';
+import '../chunk-L63DFM4R.mjs';
+import '../chunk-7MAHP735.mjs';
 import '../chunk-BEXTDHO4.mjs';
 import { useState, useCallback, useEffect } from 'react';
 import { APIProvider, Map as Map$1, AdvancedMarker, Pin, InfoWindow } from '@vis.gl/react-google-maps';

package/dist/og/index.js

@@ -1,31 +1,31 @@
 'use strict';
 
-var chunkOEW2LFOV_js = require('../chunk-OEW2LFOV.js');
+var chunkRLUNEEGM_js = require('../chunk-RLUNEEGM.js');
 var chunkCUNZAD46_js = require('../chunk-CUNZAD46.js');
-require('../chunk-R7GHP3FY.js');
+require('../chunk-JONWE26J.js');
 require('../chunk-SNAQBZPT.js');
 
 
 
 Object.defineProperty(exports, "PARAM_CARD_DIR", {
   enumerable: true,
-  get: function () { return chunkOEW2LFOV_js.PARAM_CARD_DIR; }
+  get: function () { return chunkRLUNEEGM_js.PARAM_CARD_DIR; }
 });
 Object.defineProperty(exports, "buildOgHtml", {
   enumerable: true,
-  get: function () { return chunkOEW2LFOV_js.buildOgHtml; }
+  get: function () { return chunkRLUNEEGM_js.buildOgHtml; }
 });
 Object.defineProperty(exports, "codeCardImage", {
   enumerable: true,
-  get: function () { return chunkOEW2LFOV_js.codeCardImage; }
+  get: function () { return chunkRLUNEEGM_js.codeCardImage; }
 });
 Object.defineProperty(exports, "paramCardImage", {
   enumerable: true,
-  get: function () { return chunkOEW2LFOV_js.paramCardImage; }
+  get: function () { return chunkRLUNEEGM_js.paramCardImage; }
 });
 Object.defineProperty(exports, "paramCardUrl", {
   enumerable: true,
-  get: function () { return chunkOEW2LFOV_js.paramCardUrl; }
+  get: function () { return chunkRLUNEEGM_js.paramCardUrl; }
 });
 Object.defineProperty(exports, "OG_HEIGHT", {
   enumerable: true,

package/dist/og/index.mjs

@@ -1,6 +1,6 @@
-export { PARAM_CARD_DIR, buildOgHtml, codeCardImage, paramCardImage, paramCardUrl } from '../chunk-XZO5I4RS.mjs';
+export { PARAM_CARD_DIR, buildOgHtml, codeCardImage, paramCardImage, paramCardUrl } from '../chunk-HIZJD7TU.mjs';
 export { OG_HEIGHT, OG_WIDTH, defineOgCard } from '../chunk-YU7QZ3PP.mjs';
-import '../chunk-4LYW6PMU.mjs';
+import '../chunk-C2CTLLIO.mjs';
 import '../chunk-BEXTDHO4.mjs';
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/og/route.d.ts

@@ -3,7 +3,7 @@
  *
  * `sonor-setup og` covers the build-time cards: the site card and one per
  * route. This covers the cards that must vary per URL and can't wait for a
- * rebuild — one per blog post, per event, per product — rendered on demand
+ * rebuild — one per article, per event, per product — rendered on demand
  * with next/og (Satori).
  *
  * TWO SHAPES, ONE CARD:
@@ -16,17 +16,17 @@
  * ```tsx
  * // app/blog/[slug]/opengraph-image.tsx
  * import { createOgImage } from '@sonordev/site-kit/og/route'
- * import { getBlogPost } from '@sonordev/site-kit/blog/server'
+ * import { getArticle } from '@sonordev/site-kit/articles/server'
  *
  * export { size, contentType } from '@sonordev/site-kit/og/route'
- * export const alt = 'From the Acme blog'
+ * export const alt = 'From the Acme article'
  *
  * export default createOgImage<{ slug: string }>(async ({ slug }) => {
- *   const post = await getBlogPost(slug)
+ *   const post = await getArticle(slug)
  *   if (!post) return null                  // 404: a bad slug never renders a card
  *   return {
  *     theme: { bg: '#111110', text: '#faf6f0', accent: '#ad1d25' },
- *     kicker: 'From the blog',
+ *     kicker: 'From the publication',
  *     title: post.title,
  *     photoUrl: post.featured_image,       // absolute URL (Satori requirement)
  *     bar: 'yourdomain.com',
@@ -34,7 +34,7 @@
  * })
  * ```
  *
- * The page then passes `images: false` to generateBlogPostMetadata: declared
+ * The page then passes `images: false` to generateArticleMetadata: declared
  * images beat the file convention.
  *
  * `createOgImageRoute` is a plain route handler, `GET(request, { params })`,