@sonordev/site-kit 1.2.7

package/dist/llms/index.js

@@ -0,0 +1,581 @@
+'use strict';
+
+var chunkDDKW2FNA_js = require('../chunk-DDKW2FNA.js');
+require('../chunk-ZSMWDLMK.js');
+var fs = require('fs');
+var path = require('path');
+var jsxRuntime = require('react/jsx-runtime');
+
+function createLLMsTxtHandler(options = {}) {
+  const { preferStatic = true, ...generateOptions } = options;
+  return async function GET() {
+    try {
+      if (preferStatic) {
+        const staticPath = path.join(process.cwd(), "public", "llms.txt");
+        if (fs.existsSync(staticPath)) {
+          const markdown2 = fs.readFileSync(staticPath, "utf-8");
+          return new Response(markdown2, {
+            status: 200,
+            headers: {
+              "Content-Type": "text/plain; charset=utf-8",
+              "Cache-Control": "public, max-age=3600, s-maxage=3600"
+            }
+          });
+        }
+      }
+      const { markdown, metadata } = await chunkDDKW2FNA_js.generateLLMsTxt(generateOptions);
+      return new Response(markdown, {
+        status: 200,
+        headers: {
+          "Content-Type": "text/plain; charset=utf-8",
+          "Cache-Control": "public, max-age=3600, s-maxage=3600",
+          "X-Generated-At": metadata.generated_at,
+          "X-Sections": metadata.sections.join(",")
+        }
+      });
+    } catch (error) {
+      console.error("@sonordev/llms: Error generating llms.txt:", error);
+      return new Response("# Error\n\nUnable to generate llms.txt content.", {
+        status: 500,
+        headers: { "Content-Type": "text/plain; charset=utf-8" }
+      });
+    }
+  };
+}
+function createLLMsFullTxtHandler(options = {}) {
+  const { preferStatic = true, ...generateOptions } = options;
+  return async function GET() {
+    try {
+      if (preferStatic) {
+        const staticPath = path.join(process.cwd(), "public", "llms-full.txt");
+        if (fs.existsSync(staticPath)) {
+          const markdown2 = fs.readFileSync(staticPath, "utf-8");
+          return new Response(markdown2, {
+            status: 200,
+            headers: {
+              "Content-Type": "text/plain; charset=utf-8",
+              "Cache-Control": "public, max-age=3600, s-maxage=3600"
+            }
+          });
+        }
+      }
+      const { markdown, metadata } = await chunkDDKW2FNA_js.generateLLMsFullTxt(generateOptions);
+      return new Response(markdown, {
+        status: 200,
+        headers: {
+          "Content-Type": "text/plain; charset=utf-8",
+          "Cache-Control": "public, max-age=3600, s-maxage=3600",
+          "X-Generated-At": metadata.generated_at,
+          "X-Sections": metadata.sections.join(",")
+        }
+      });
+    } catch (error) {
+      console.error("@sonordev/llms: Error generating llms-full.txt:", error);
+      return new Response("# Error\n\nUnable to generate llms-full.txt content.", {
+        status: 500,
+        headers: { "Content-Type": "text/plain; charset=utf-8" }
+      });
+    }
+  };
+}
+function SpeakableSchema({
+  type,
+  name,
+  url,
+  speakable,
+  additionalProperties = {}
+}) {
+  const schema = createSpeakableSchema(type, name, url, speakable, additionalProperties);
+  return /* @__PURE__ */ jsxRuntime.jsx(
+    "script",
+    {
+      type: "application/ld+json",
+      dangerouslySetInnerHTML: {
+        __html: JSON.stringify(schema, null, 0)
+      }
+    }
+  );
+}
+function createSpeakableSchema(type, name, url, speakable, additionalProperties = {}) {
+  const speakableSpec = {
+    "@type": "SpeakableSpecification"
+  };
+  if (speakable.cssSelectors?.length) {
+    speakableSpec.cssSelector = speakable.cssSelectors;
+  } else if (speakable.xPaths?.length) {
+    speakableSpec.xpath = speakable.xPaths;
+  } else {
+    speakableSpec.cssSelector = [
+      "h1",
+      "[data-speakable]",
+      ".page-summary",
+      ".key-points",
+      'meta[name="description"]'
+    ];
+  }
+  return {
+    "@context": "https://schema.org",
+    "@type": type,
+    name,
+    url,
+    speakable: speakableSpec,
+    ...additionalProperties
+  };
+}
+var DEFAULT_SPEAKABLE_SELECTORS = {
+  /** Standard page elements */
+  page: ["h1", 'meta[name="description"]', ".page-summary"],
+  /** Article/blog post elements */
+  article: ["h1", ".article-summary", ".article-intro", 'meta[name="description"]'],
+  /** Service page elements */
+  service: ["h1", ".service-overview", ".key-benefits", 'meta[name="description"]'],
+  /** FAQ page elements */
+  faq: ["h1", ".faq-intro", ".faq-item"],
+  /** Contact page elements */
+  contact: ["h1", ".contact-intro", ".business-hours", ".contact-info"]
+};
+function getSpeakableSelectorsForPage(pageType) {
+  return DEFAULT_SPEAKABLE_SELECTORS[pageType] || DEFAULT_SPEAKABLE_SELECTORS.page;
+}
+function AEOBlock({
+  id,
+  type,
+  question,
+  speakable = true,
+  entityId,
+  children,
+  className = ""
+}) {
+  const blockId = id || `aeo-${type}-${Math.random().toString(36).slice(2, 8)}`;
+  const baseClasses = `aeo-block aeo-${type}`;
+  const combinedClasses = className ? `${baseClasses} ${className}` : baseClasses;
+  const sonorAttrs = {
+    "data-sonor-ai": type,
+    "data-sonor-block": "true",
+    ...entityId && { "data-sonor-entity": entityId }
+  };
+  if (type === "answer" && question) {
+    return /* @__PURE__ */ jsxRuntime.jsxs(
+      "section",
+      {
+        id: blockId,
+        className: combinedClasses,
+        "data-speakable": speakable ? "true" : void 0,
+        "data-aeo-type": type,
+        ...sonorAttrs,
+        itemScope: true,
+        itemType: "https://schema.org/Question",
+        children: [
+          /* @__PURE__ */ jsxRuntime.jsx("h3", { itemProp: "name", className: "aeo-question", children: question }),
+          /* @__PURE__ */ jsxRuntime.jsx(
+            "div",
+            {
+              itemScope: true,
+              itemType: "https://schema.org/Answer",
+              itemProp: "acceptedAnswer",
+              className: "aeo-answer",
+              children: /* @__PURE__ */ jsxRuntime.jsx("div", { itemProp: "text", children })
+            }
+          )
+        ]
+      }
+    );
+  }
+  if (type === "definition") {
+    return /* @__PURE__ */ jsxRuntime.jsx(
+      "section",
+      {
+        id: blockId,
+        className: combinedClasses,
+        "data-speakable": speakable ? "true" : void 0,
+        "data-aeo-type": type,
+        ...sonorAttrs,
+        children
+      }
+    );
+  }
+  if (type === "steps") {
+    return /* @__PURE__ */ jsxRuntime.jsx(
+      "section",
+      {
+        id: blockId,
+        className: combinedClasses,
+        "data-speakable": speakable ? "true" : void 0,
+        "data-aeo-type": type,
+        ...sonorAttrs,
+        itemScope: true,
+        itemType: "https://schema.org/HowTo",
+        children
+      }
+    );
+  }
+  return /* @__PURE__ */ jsxRuntime.jsx(
+    "section",
+    {
+      id: blockId,
+      className: combinedClasses,
+      "data-speakable": speakable ? "true" : void 0,
+      "data-aeo-type": type,
+      ...sonorAttrs,
+      children
+    }
+  );
+}
+function AEOSummary({
+  title = "Key Points",
+  points,
+  speakable = true,
+  entityId,
+  className = ""
+}) {
+  const baseClasses = "aeo-summary";
+  const combinedClasses = className ? `${baseClasses} ${className}` : baseClasses;
+  return /* @__PURE__ */ jsxRuntime.jsxs(
+    "div",
+    {
+      className: combinedClasses,
+      "data-speakable": speakable ? "true" : void 0,
+      "data-aeo-type": "summary",
+      "data-sonor-ai": "summary",
+      "data-sonor-block": "true",
+      ...entityId && { "data-sonor-entity": entityId },
+      children: [
+        title && /* @__PURE__ */ jsxRuntime.jsx("h3", { className: "aeo-summary-title", children: title }),
+        /* @__PURE__ */ jsxRuntime.jsx("ul", { className: "aeo-summary-points", children: points.map((point, index) => /* @__PURE__ */ jsxRuntime.jsx("li", { className: "aeo-summary-point", children: point }, index)) })
+      ]
+    }
+  );
+}
+function AEODefinition({
+  term,
+  definition,
+  speakable = true,
+  entityId,
+  source,
+  className = ""
+}) {
+  const baseClasses = "aeo-definition";
+  const combinedClasses = className ? `${baseClasses} ${className}` : baseClasses;
+  return /* @__PURE__ */ jsxRuntime.jsxs(
+    "dl",
+    {
+      className: combinedClasses,
+      "data-speakable": speakable ? "true" : void 0,
+      "data-aeo-type": "definition",
+      "data-sonor-ai": "definition",
+      "data-sonor-block": "true",
+      ...entityId && { "data-sonor-entity": entityId },
+      ...source && { "data-sonor-source": source },
+      itemScope: true,
+      itemType: "https://schema.org/DefinedTerm",
+      children: [
+        /* @__PURE__ */ jsxRuntime.jsx("dt", { className: "aeo-term", itemProp: "name", children: /* @__PURE__ */ jsxRuntime.jsx("strong", { children: term }) }),
+        /* @__PURE__ */ jsxRuntime.jsx("dd", { className: "aeo-definition-text", itemProp: "description", children: definition })
+      ]
+    }
+  );
+}
+function AEOSteps({
+  title,
+  children,
+  speakable = true,
+  entityId,
+  className = ""
+}) {
+  const baseClasses = "aeo-steps";
+  const combinedClasses = className ? `${baseClasses} ${className}` : baseClasses;
+  return /* @__PURE__ */ jsxRuntime.jsxs(
+    "section",
+    {
+      className: combinedClasses,
+      "data-speakable": speakable ? "true" : void 0,
+      "data-aeo-type": "steps",
+      "data-sonor-ai": "steps",
+      "data-sonor-block": "true",
+      ...entityId && { "data-sonor-entity": entityId },
+      itemScope: true,
+      itemType: "https://schema.org/HowTo",
+      children: [
+        /* @__PURE__ */ jsxRuntime.jsx("h3", { className: "aeo-steps-title", itemProp: "name", children: title }),
+        /* @__PURE__ */ jsxRuntime.jsx("ol", { className: "aeo-steps-list", children })
+      ]
+    }
+  );
+}
+function AEOStep({
+  number,
+  name,
+  children
+}) {
+  return /* @__PURE__ */ jsxRuntime.jsxs(
+    "li",
+    {
+      className: "aeo-step",
+      itemScope: true,
+      itemType: "https://schema.org/HowToStep",
+      itemProp: "step",
+      children: [
+        /* @__PURE__ */ jsxRuntime.jsx("span", { className: "aeo-step-number", itemProp: "position", children: number }),
+        /* @__PURE__ */ jsxRuntime.jsx("strong", { className: "aeo-step-name", itemProp: "name", children: name }),
+        /* @__PURE__ */ jsxRuntime.jsx("div", { className: "aeo-step-content", itemProp: "text", children })
+      ]
+    }
+  );
+}
+function AEOComparison({
+  title,
+  items,
+  labelA,
+  labelB,
+  speakable = true,
+  entityId,
+  className = ""
+}) {
+  const baseClasses = "aeo-comparison";
+  const combinedClasses = className ? `${baseClasses} ${className}` : baseClasses;
+  return /* @__PURE__ */ jsxRuntime.jsxs(
+    "section",
+    {
+      className: combinedClasses,
+      "data-speakable": speakable ? "true" : void 0,
+      "data-aeo-type": "comparison",
+      "data-sonor-ai": "comparison",
+      "data-sonor-block": "true",
+      ...entityId && { "data-sonor-entity": entityId },
+      children: [
+        /* @__PURE__ */ jsxRuntime.jsx("h3", { className: "aeo-comparison-title", children: title }),
+        /* @__PURE__ */ jsxRuntime.jsxs("table", { className: "aeo-comparison-table", children: [
+          /* @__PURE__ */ jsxRuntime.jsx("thead", { children: /* @__PURE__ */ jsxRuntime.jsxs("tr", { children: [
+            /* @__PURE__ */ jsxRuntime.jsx("th", { children: "Aspect" }),
+            /* @__PURE__ */ jsxRuntime.jsx("th", { children: labelA }),
+            /* @__PURE__ */ jsxRuntime.jsx("th", { children: labelB })
+          ] }) }),
+          /* @__PURE__ */ jsxRuntime.jsx("tbody", { children: items.map((item, index) => /* @__PURE__ */ jsxRuntime.jsxs("tr", { children: [
+            /* @__PURE__ */ jsxRuntime.jsx("td", { className: "aeo-comparison-aspect", children: item.aspect }),
+            /* @__PURE__ */ jsxRuntime.jsx("td", { className: "aeo-comparison-a", children: item.optionA }),
+            /* @__PURE__ */ jsxRuntime.jsx("td", { className: "aeo-comparison-b", children: item.optionB })
+          ] }, index)) })
+        ] })
+      ]
+    }
+  );
+}
+function AEOClaim({
+  source,
+  sourceUrl,
+  confidence = 1,
+  claimType = "fact",
+  retrievedAt,
+  children,
+  className = ""
+}) {
+  const baseClasses = "aeo-claim";
+  const combinedClasses = className ? `${baseClasses} ${className}` : baseClasses;
+  return /* @__PURE__ */ jsxRuntime.jsxs(
+    "span",
+    {
+      className: combinedClasses,
+      "data-sonor-claim": "true",
+      "data-sonor-source": source,
+      ...sourceUrl && { "data-sonor-source-url": sourceUrl },
+      "data-sonor-confidence": confidence.toString(),
+      "data-sonor-claim-type": claimType,
+      ...retrievedAt && { "data-sonor-retrieved": retrievedAt },
+      itemScope: true,
+      itemType: "https://schema.org/Claim",
+      children: [
+        /* @__PURE__ */ jsxRuntime.jsx("span", { itemProp: "text", children }),
+        sourceUrl ? /* @__PURE__ */ jsxRuntime.jsx("meta", { itemProp: "citation", content: sourceUrl }) : /* @__PURE__ */ jsxRuntime.jsx("meta", { itemProp: "citation", content: source })
+      ]
+    }
+  );
+}
+function AEOEntity({
+  entityId,
+  entityType,
+  name,
+  url,
+  children,
+  className = ""
+}) {
+  const baseClasses = "aeo-entity";
+  const combinedClasses = className ? `${baseClasses} aeo-entity-${entityType} ${className}` : `${baseClasses} aeo-entity-${entityType}`;
+  return /* @__PURE__ */ jsxRuntime.jsxs(
+    "span",
+    {
+      className: combinedClasses,
+      "data-sonor-entity": entityId,
+      "data-sonor-entity-type": entityType,
+      "data-sonor-entity-name": name,
+      ...url && { "data-sonor-entity-url": url },
+      itemScope: true,
+      itemType: `https://schema.org/${entityType === "organization" ? "Organization" : entityType === "person" ? "Person" : entityType === "location" ? "Place" : "Thing"}`,
+      children: [
+        /* @__PURE__ */ jsxRuntime.jsx("span", { itemProp: "name", children }),
+        url && /* @__PURE__ */ jsxRuntime.jsx("link", { itemProp: "url", href: url })
+      ]
+    }
+  );
+}
+function AEOProvenanceList({
+  sources,
+  title = "Sources & References",
+  className = ""
+}) {
+  const baseClasses = "aeo-provenance-list";
+  const combinedClasses = className ? `${baseClasses} ${className}` : baseClasses;
+  const getSchemaType = (sourceType) => {
+    switch (sourceType) {
+      case "legal_statute":
+        return "https://schema.org/Legislation";
+      case "research_paper":
+        return "https://schema.org/ScholarlyArticle";
+      case "news_article":
+        return "https://schema.org/NewsArticle";
+      case "press_release":
+        return "https://schema.org/NewsArticle";
+      default:
+        return "https://schema.org/CreativeWork";
+    }
+  };
+  return /* @__PURE__ */ jsxRuntime.jsxs(
+    "aside",
+    {
+      className: combinedClasses,
+      "data-sonor-provenance": "list",
+      "data-sonor-source-count": sources.length.toString(),
+      itemScope: true,
+      itemType: "https://schema.org/ItemList",
+      children: [
+        /* @__PURE__ */ jsxRuntime.jsx("h4", { className: "aeo-provenance-title", itemProp: "name", children: title }),
+        /* @__PURE__ */ jsxRuntime.jsx("ol", { className: "aeo-provenance-sources", children: sources.map((source, index) => /* @__PURE__ */ jsxRuntime.jsxs(
+          "li",
+          {
+            className: "aeo-provenance-item",
+            "data-sonor-source-id": source.id,
+            "data-sonor-source-type": source.source_type,
+            ...source.confidence && { "data-sonor-confidence": source.confidence.toString() },
+            itemScope: true,
+            itemType: getSchemaType(source.source_type),
+            itemProp: "itemListElement",
+            children: [
+              /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "aeo-provenance-number", children: [
+                "[",
+                index + 1,
+                "]"
+              ] }),
+              source.url ? /* @__PURE__ */ jsxRuntime.jsx(
+                "a",
+                {
+                  href: source.url,
+                  className: "aeo-provenance-link",
+                  itemProp: "url",
+                  target: "_blank",
+                  rel: "noopener noreferrer",
+                  children: /* @__PURE__ */ jsxRuntime.jsx("span", { itemProp: "name", children: source.title })
+                }
+              ) : /* @__PURE__ */ jsxRuntime.jsx("span", { itemProp: "name", children: source.title }),
+              source.publisher && /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "aeo-provenance-publisher", itemProp: "publisher", children: [
+                "\u2014 ",
+                source.publisher
+              ] }),
+              source.published_at && /* @__PURE__ */ jsxRuntime.jsxs(
+                "time",
+                {
+                  className: "aeo-provenance-date",
+                  itemProp: "datePublished",
+                  dateTime: source.published_at,
+                  children: [
+                    "(",
+                    new Date(source.published_at).toLocaleDateString(),
+                    ")"
+                  ]
+                }
+              ),
+              source.identifier && /* @__PURE__ */ jsxRuntime.jsx("span", { className: "aeo-provenance-identifier", "data-sonor-identifier": source.identifier, children: source.identifier }),
+              source.excerpt && /* @__PURE__ */ jsxRuntime.jsx("blockquote", { className: "aeo-provenance-excerpt", itemProp: "description", children: source.excerpt })
+            ]
+          },
+          source.id
+        )) })
+      ]
+    }
+  );
+}
+function AEOCitedContent({
+  children,
+  sources,
+  showSourcesList = true,
+  className = ""
+}) {
+  const baseClasses = "aeo-cited-content";
+  const combinedClasses = className ? `${baseClasses} ${className}` : baseClasses;
+  return /* @__PURE__ */ jsxRuntime.jsxs(
+    "section",
+    {
+      className: combinedClasses,
+      "data-sonor-ai": "cited-content",
+      "data-sonor-provenance": "inline",
+      "data-sonor-source-count": sources.length.toString(),
+      children: [
+        /* @__PURE__ */ jsxRuntime.jsx("div", { className: "aeo-cited-body", children }),
+        showSourcesList && sources.length > 0 && /* @__PURE__ */ jsxRuntime.jsx(AEOProvenanceList, { sources, title: "References" })
+      ]
+    }
+  );
+}
+
+Object.defineProperty(exports, "generateLLMsFullTxt", {
+  enumerable: true,
+  get: function () { return chunkDDKW2FNA_js.generateLLMsFullTxt; }
+});
+Object.defineProperty(exports, "generateLLMsTxt", {
+  enumerable: true,
+  get: function () { return chunkDDKW2FNA_js.generateLLMsTxt; }
+});
+Object.defineProperty(exports, "getBusinessInfo", {
+  enumerable: true,
+  get: function () { return chunkDDKW2FNA_js.getBusinessInfo; }
+});
+Object.defineProperty(exports, "getFAQItems", {
+  enumerable: true,
+  get: function () { return chunkDDKW2FNA_js.getFAQItems; }
+});
+Object.defineProperty(exports, "getLLMsData", {
+  enumerable: true,
+  get: function () { return chunkDDKW2FNA_js.getLLMsData; }
+});
+Object.defineProperty(exports, "getOptimizedLLMsTxt", {
+  enumerable: true,
+  get: function () { return chunkDDKW2FNA_js.getOptimizedLLMsTxt; }
+});
+Object.defineProperty(exports, "getPageSummaries", {
+  enumerable: true,
+  get: function () { return chunkDDKW2FNA_js.getPageSummaries; }
+});
+Object.defineProperty(exports, "getServices", {
+  enumerable: true,
+  get: function () { return chunkDDKW2FNA_js.getServices; }
+});
+Object.defineProperty(exports, "writeLLMsTxtToPublic", {
+  enumerable: true,
+  get: function () { return chunkDDKW2FNA_js.writeLLMsTxtToPublic; }
+});
+exports.AEOBlock = AEOBlock;
+exports.AEOCitedContent = AEOCitedContent;
+exports.AEOClaim = AEOClaim;
+exports.AEOComparison = AEOComparison;
+exports.AEODefinition = AEODefinition;
+exports.AEOEntity = AEOEntity;
+exports.AEOProvenanceList = AEOProvenanceList;
+exports.AEOStep = AEOStep;
+exports.AEOSteps = AEOSteps;
+exports.AEOSummary = AEOSummary;
+exports.DEFAULT_SPEAKABLE_SELECTORS = DEFAULT_SPEAKABLE_SELECTORS;
+exports.SpeakableSchema = SpeakableSchema;
+exports.createLLMsFullTxtHandler = createLLMsFullTxtHandler;
+exports.createLLMsTxtHandler = createLLMsTxtHandler;
+exports.createSpeakableSchema = createSpeakableSchema;
+exports.getSpeakableSelectorsForPage = getSpeakableSelectorsForPage;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map