@burdenoff/website-sdk 2026.828.7 → 2026.829.2

package/dist/{use-explore-chat-DhvZhH8f.d.mts → use-explore-chat-8eL7WdLc.d.mts}

@@ -39,6 +39,8 @@ interface ExploreReference {
     description?: string | null;
     product?: string | null;
     imageUrl?: string | null;
+    /** 1-based citation number; the answer text carries a matching `[n]` marker. */
+    index?: number | null;
 }
 /**
  * `type ExploreCta` — a suggested next step attached to an answer.
@@ -68,6 +70,13 @@ interface ExploreMessage {
     activity: string[];
     references: ExploreReference[];
     ctas: ExploreCtaLink[];
+    /** Up to three suggested next questions, derived from what the answer covered. */
+    followUps?: string[] | null;
+    /**
+     * False when the corpus could not answer. A grounded answer always cites, so an answer
+     * with no source is the honest "we do not have this" signal rather than a hedge.
+     */
+    answered?: boolean | null;
     errorCode?: string | null;
     createdAt: string;
     completedAt?: string | null;
@@ -140,9 +149,9 @@ declare const EXPLORE_CATALOG_QUERY = "\n  query ExploreCatalog($productSlug: St
  * default 5-minute cache would return the first PENDING snapshot forever and
  * the answer would never appear.
  */
-declare const EXPLORE_MESSAGE_QUERY = "\n  query ExploreMessage($conversationToken: String!, $id: ID!) {\n    exploreMessage(conversationToken: $conversationToken, id: $id) {\n      \n  id\n  conversationId\n  role\n  status\n  content\n  partialContent\n  activity\n  references {\n    url\n    title\n    description\n    product\n    imageUrl\n  }\n  ctas {\n    kind\n    label\n    url\n    product\n  }\n  errorCode\n  createdAt\n  completedAt\n\n    }\n  }\n";
+declare const EXPLORE_MESSAGE_QUERY = "\n  query ExploreMessage($conversationToken: String!, $id: ID!) {\n    exploreMessage(conversationToken: $conversationToken, id: $id) {\n      \n  id\n  conversationId\n  role\n  status\n  content\n  partialContent\n  activity\n  references {\n    url\n    title\n    description\n    product\n    imageUrl\n    index\n  }\n  ctas {\n    kind\n    label\n    url\n    product\n  }\n  followUps\n  answered\n  errorCode\n  createdAt\n  completedAt\n\n    }\n  }\n";
 /** Submit half of the submit + poll pair. */
-declare const SEND_EXPLORE_MESSAGE_MUTATION = "\n  mutation SendExploreMessage($input: SendExploreMessageInput!) {\n    sendExploreMessage(input: $input) {\n      conversation {\n        id\n        token\n        productSlug\n        turnCount\n        createdAt\n      }\n      userMessage {\n        \n  id\n  conversationId\n  role\n  status\n  content\n  partialContent\n  activity\n  references {\n    url\n    title\n    description\n    product\n    imageUrl\n  }\n  ctas {\n    kind\n    label\n    url\n    product\n  }\n  errorCode\n  createdAt\n  completedAt\n\n      }\n      assistantMessage {\n        \n  id\n  conversationId\n  role\n  status\n  content\n  partialContent\n  activity\n  references {\n    url\n    title\n    description\n    product\n    imageUrl\n  }\n  ctas {\n    kind\n    label\n    url\n    product\n  }\n  errorCode\n  createdAt\n  completedAt\n\n      }\n      remainingToday\n    }\n  }\n";
+declare const SEND_EXPLORE_MESSAGE_MUTATION = "\n  mutation SendExploreMessage($input: SendExploreMessageInput!) {\n    sendExploreMessage(input: $input) {\n      conversation {\n        id\n        token\n        productSlug\n        turnCount\n        createdAt\n      }\n      userMessage {\n        \n  id\n  conversationId\n  role\n  status\n  content\n  partialContent\n  activity\n  references {\n    url\n    title\n    description\n    product\n    imageUrl\n    index\n  }\n  ctas {\n    kind\n    label\n    url\n    product\n  }\n  followUps\n  answered\n  errorCode\n  createdAt\n  completedAt\n\n      }\n      assistantMessage {\n        \n  id\n  conversationId\n  role\n  status\n  content\n  partialContent\n  activity\n  references {\n    url\n    title\n    description\n    product\n    imageUrl\n    index\n  }\n  ctas {\n    kind\n    label\n    url\n    product\n  }\n  followUps\n  answered\n  errorCode\n  createdAt\n  completedAt\n\n      }\n      remainingToday\n    }\n  }\n";
 interface ExploreCatalogQueryData {
     exploreCatalog: ExploreCatalog;
 }
@@ -232,6 +241,11 @@ interface UseExploreChatResult {
     deleteConversation: (token: string) => void;
     /** Forget every past conversation held in this browser. */
     clearHistory: () => void;
+    /**
+     * Record that the visitor followed a link this answer offered. Fire-and-forget — never
+     * awaited, never throws, and must never delay the navigation it is reporting on.
+     */
+    recordClick: (messageId: string, kind: "CTA" | "REFERENCE", url: string) => void;
     canSend: boolean;
 }
 /** Fallback limits, mirroring the server defaults in CONTRACT.md §3. */

package/dist/{use-explore-chat-DhvZhH8f.d.ts → use-explore-chat-8eL7WdLc.d.ts}

@@ -39,6 +39,8 @@ interface ExploreReference {
     description?: string | null;
     product?: string | null;
     imageUrl?: string | null;
+    /** 1-based citation number; the answer text carries a matching `[n]` marker. */
+    index?: number | null;
 }
 /**
  * `type ExploreCta` — a suggested next step attached to an answer.
@@ -68,6 +70,13 @@ interface ExploreMessage {
     activity: string[];
     references: ExploreReference[];
     ctas: ExploreCtaLink[];
+    /** Up to three suggested next questions, derived from what the answer covered. */
+    followUps?: string[] | null;
+    /**
+     * False when the corpus could not answer. A grounded answer always cites, so an answer
+     * with no source is the honest "we do not have this" signal rather than a hedge.
+     */
+    answered?: boolean | null;
     errorCode?: string | null;
     createdAt: string;
     completedAt?: string | null;
@@ -140,9 +149,9 @@ declare const EXPLORE_CATALOG_QUERY = "\n  query ExploreCatalog($productSlug: St
  * default 5-minute cache would return the first PENDING snapshot forever and
  * the answer would never appear.
  */
-declare const EXPLORE_MESSAGE_QUERY = "\n  query ExploreMessage($conversationToken: String!, $id: ID!) {\n    exploreMessage(conversationToken: $conversationToken, id: $id) {\n      \n  id\n  conversationId\n  role\n  status\n  content\n  partialContent\n  activity\n  references {\n    url\n    title\n    description\n    product\n    imageUrl\n  }\n  ctas {\n    kind\n    label\n    url\n    product\n  }\n  errorCode\n  createdAt\n  completedAt\n\n    }\n  }\n";
+declare const EXPLORE_MESSAGE_QUERY = "\n  query ExploreMessage($conversationToken: String!, $id: ID!) {\n    exploreMessage(conversationToken: $conversationToken, id: $id) {\n      \n  id\n  conversationId\n  role\n  status\n  content\n  partialContent\n  activity\n  references {\n    url\n    title\n    description\n    product\n    imageUrl\n    index\n  }\n  ctas {\n    kind\n    label\n    url\n    product\n  }\n  followUps\n  answered\n  errorCode\n  createdAt\n  completedAt\n\n    }\n  }\n";
 /** Submit half of the submit + poll pair. */
-declare const SEND_EXPLORE_MESSAGE_MUTATION = "\n  mutation SendExploreMessage($input: SendExploreMessageInput!) {\n    sendExploreMessage(input: $input) {\n      conversation {\n        id\n        token\n        productSlug\n        turnCount\n        createdAt\n      }\n      userMessage {\n        \n  id\n  conversationId\n  role\n  status\n  content\n  partialContent\n  activity\n  references {\n    url\n    title\n    description\n    product\n    imageUrl\n  }\n  ctas {\n    kind\n    label\n    url\n    product\n  }\n  errorCode\n  createdAt\n  completedAt\n\n      }\n      assistantMessage {\n        \n  id\n  conversationId\n  role\n  status\n  content\n  partialContent\n  activity\n  references {\n    url\n    title\n    description\n    product\n    imageUrl\n  }\n  ctas {\n    kind\n    label\n    url\n    product\n  }\n  errorCode\n  createdAt\n  completedAt\n\n      }\n      remainingToday\n    }\n  }\n";
+declare const SEND_EXPLORE_MESSAGE_MUTATION = "\n  mutation SendExploreMessage($input: SendExploreMessageInput!) {\n    sendExploreMessage(input: $input) {\n      conversation {\n        id\n        token\n        productSlug\n        turnCount\n        createdAt\n      }\n      userMessage {\n        \n  id\n  conversationId\n  role\n  status\n  content\n  partialContent\n  activity\n  references {\n    url\n    title\n    description\n    product\n    imageUrl\n    index\n  }\n  ctas {\n    kind\n    label\n    url\n    product\n  }\n  followUps\n  answered\n  errorCode\n  createdAt\n  completedAt\n\n      }\n      assistantMessage {\n        \n  id\n  conversationId\n  role\n  status\n  content\n  partialContent\n  activity\n  references {\n    url\n    title\n    description\n    product\n    imageUrl\n    index\n  }\n  ctas {\n    kind\n    label\n    url\n    product\n  }\n  followUps\n  answered\n  errorCode\n  createdAt\n  completedAt\n\n      }\n      remainingToday\n    }\n  }\n";
 interface ExploreCatalogQueryData {
     exploreCatalog: ExploreCatalog;
 }
@@ -232,6 +241,11 @@ interface UseExploreChatResult {
     deleteConversation: (token: string) => void;
     /** Forget every past conversation held in this browser. */
     clearHistory: () => void;
+    /**
+     * Record that the visitor followed a link this answer offered. Fire-and-forget — never
+     * awaited, never throws, and must never delay the navigation it is reporting on.
+     */
+    recordClick: (messageId: string, kind: "CTA" | "REFERENCE", url: string) => void;
     canSend: boolean;
 }
 /** Fallback limits, mirroring the server defaults in CONTRACT.md §3. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@burdenoff/website-sdk",
-  "version": "2026.828.7",
+  "version": "2026.829.2",
   "description": "Shared SDK for Burdenoff product websites - reusable React components, utilities, and configurations",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",