@burdenoff/website-sdk 2026.922.2 → 2026.922.3

package/dist/{explore-types-CLw19R76.d.mts → explore-types-CPF1QoMn.d.mts}

@@ -17,6 +17,18 @@
  */
 type ExploreMessageRole = "USER" | "ASSISTANT";
 type ExploreMessageStatus = "PENDING" | "RUNNING" | "COMPLETED" | "FAILED";
+/** `enum ExploreFeedbackRating` — the visitor's verdict on one answer. */
+type ExploreFeedbackRating = "HELPFUL" | "NOT_HELPFUL";
+/**
+ * The reasons offered alongside `NOT_HELPFUL`, in the order the chooser shows them.
+ *
+ * `reason` is `String` on the wire, not an enum, so this list is the SDK's half of the
+ * agreement rather than something the schema enforces — the same treatment
+ * {@link ExploreCtaKind} gets. Use the union when you are *producing* a reason; read one
+ * back as a plain string.
+ */
+declare const EXPLORE_FEEDBACK_REASONS: readonly ["INACCURATE", "INCOMPLETE", "OFF_TOPIC", "HARD_TO_FOLLOW", "OTHER"];
+type ExploreFeedbackReason = (typeof EXPLORE_FEEDBACK_REASONS)[number];
 /**
  * The `ExploreCta.kind` values enumerated in CONTRACT.md §1.
  *
@@ -56,6 +68,21 @@ interface ExploreCtaLink {
     url: string;
     product?: string | null;
 }
+/**
+ * `type ExploreFeedback` — what is on record for one answer, as the server holds it.
+ *
+ * A rating REPLACES the previous one (the server upserts on `messageId`), so this is the
+ * visitor's current opinion and never a history. `reason` is null for `HELPFUL` by
+ * definition, and typed `string` rather than the union because it is `String` on the wire —
+ * a reason added server-side must read back, not break the build of 38 websites.
+ */
+interface ExploreFeedback {
+    rating: ExploreFeedbackRating;
+    /** One of {@link EXPLORE_FEEDBACK_REASONS}. Null for `HELPFUL`. */
+    reason?: string | null;
+    comment?: string | null;
+    createdAt: string;
+}
 /** `type ExploreMessage`. `content` is `""` while the turn is PENDING. */
 interface ExploreMessage {
     id: string;
@@ -79,6 +106,16 @@ interface ExploreMessage {
     answered?: boolean | null;
     /** Files the visitor attached to this turn. Present on USER messages only. */
     attachments?: ExploreAttachment[] | null;
+    /**
+     * The rating this visitor already gave this answer, or null for an unrated one.
+     *
+     * Selected only by the reads scoped to a `conversationToken`, so a polled or restored
+     * transcript shows what was already rated instead of offering the row again. It is always
+     * null on a SHARED transcript — that read is performed by someone else, and the rater's
+     * verdict and free-text note are not theirs to receive. See
+     * `EXPLORE_OWN_MESSAGE_FIELDS`.
+     */
+    feedback?: ExploreFeedback | null;
     errorCode?: string | null;
     createdAt: string;
     completedAt?: string | null;
@@ -171,9 +208,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    index\n  }\n  ctas {\n    kind\n    label\n    url\n    product\n  }\n  followUps\n  answered\n  attachments {\n    name\n    mimeType\n    size\n    textExtracted\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  \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  attachments {\n    name\n    mimeType\n    size\n    textExtracted\n  }\n  errorCode\n  createdAt\n  completedAt\n\n  feedback {\n    rating\n    reason\n    comment\n    createdAt\n  }\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    index\n  }\n  ctas {\n    kind\n    label\n    url\n    product\n  }\n  followUps\n  answered\n  attachments {\n    name\n    mimeType\n    size\n    textExtracted\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    index\n  }\n  ctas {\n    kind\n    label\n    url\n    product\n  }\n  followUps\n  answered\n  attachments {\n    name\n    mimeType\n    size\n    textExtracted\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  \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  attachments {\n    name\n    mimeType\n    size\n    textExtracted\n  }\n  errorCode\n  createdAt\n  completedAt\n\n  feedback {\n    rating\n    reason\n    comment\n    createdAt\n  }\n\n      }\n      assistantMessage {\n        \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  attachments {\n    name\n    mimeType\n    size\n    textExtracted\n  }\n  errorCode\n  createdAt\n  completedAt\n\n  feedback {\n    rating\n    reason\n    comment\n    createdAt\n  }\n\n      }\n      remainingToday\n    }\n  }\n";
 interface ExploreCatalogQueryData {
     exploreCatalog: ExploreCatalog;
 }
@@ -184,4 +221,4 @@ interface SendExploreMessageMutationData {
     sendExploreMessage: SendExploreMessageResult;
 }
 
-export { type ExploreProduct as E, SEND_EXPLORE_MESSAGE_MUTATION as S, type ExploreLimits as a, type ExploreCatalog as b, type ExploreMessage as c, EXPLORE_CATALOG_QUERY as d, EXPLORE_MESSAGE_QUERY as e, type ExploreCatalogQueryData as f, type ExploreConversation as g, type ExploreCtaKind as h, type ExploreCtaLink as i, type ExploreErrorCode as j, type ExploreMessageQueryData as k, type ExploreMessageRole as l, type ExploreMessageStatus as m, type ExploreReference as n, type SendExploreMessageInput as o, type SendExploreMessageMutationData as p, type SendExploreMessageResult as q };
+export { type ExploreProduct as E, SEND_EXPLORE_MESSAGE_MUTATION as S, type ExploreLimits as a, type ExploreCatalog as b, type ExploreMessage as c, type ExploreFeedbackRating as d, type ExploreFeedbackReason as e, EXPLORE_CATALOG_QUERY as f, EXPLORE_MESSAGE_QUERY as g, type ExploreCatalogQueryData as h, type ExploreConversation as i, type ExploreCtaKind as j, type ExploreCtaLink as k, type ExploreErrorCode as l, type ExploreMessageQueryData as m, type ExploreMessageRole as n, type ExploreMessageStatus as o, type ExploreReference as p, type SendExploreMessageInput as q, type SendExploreMessageMutationData as r, type SendExploreMessageResult as s };

package/dist/{explore-types-CLw19R76.d.ts → explore-types-CPF1QoMn.d.ts}

@@ -17,6 +17,18 @@
  */
 type ExploreMessageRole = "USER" | "ASSISTANT";
 type ExploreMessageStatus = "PENDING" | "RUNNING" | "COMPLETED" | "FAILED";
+/** `enum ExploreFeedbackRating` — the visitor's verdict on one answer. */
+type ExploreFeedbackRating = "HELPFUL" | "NOT_HELPFUL";
+/**
+ * The reasons offered alongside `NOT_HELPFUL`, in the order the chooser shows them.
+ *
+ * `reason` is `String` on the wire, not an enum, so this list is the SDK's half of the
+ * agreement rather than something the schema enforces — the same treatment
+ * {@link ExploreCtaKind} gets. Use the union when you are *producing* a reason; read one
+ * back as a plain string.
+ */
+declare const EXPLORE_FEEDBACK_REASONS: readonly ["INACCURATE", "INCOMPLETE", "OFF_TOPIC", "HARD_TO_FOLLOW", "OTHER"];
+type ExploreFeedbackReason = (typeof EXPLORE_FEEDBACK_REASONS)[number];
 /**
  * The `ExploreCta.kind` values enumerated in CONTRACT.md §1.
  *
@@ -56,6 +68,21 @@ interface ExploreCtaLink {
     url: string;
     product?: string | null;
 }
+/**
+ * `type ExploreFeedback` — what is on record for one answer, as the server holds it.
+ *
+ * A rating REPLACES the previous one (the server upserts on `messageId`), so this is the
+ * visitor's current opinion and never a history. `reason` is null for `HELPFUL` by
+ * definition, and typed `string` rather than the union because it is `String` on the wire —
+ * a reason added server-side must read back, not break the build of 38 websites.
+ */
+interface ExploreFeedback {
+    rating: ExploreFeedbackRating;
+    /** One of {@link EXPLORE_FEEDBACK_REASONS}. Null for `HELPFUL`. */
+    reason?: string | null;
+    comment?: string | null;
+    createdAt: string;
+}
 /** `type ExploreMessage`. `content` is `""` while the turn is PENDING. */
 interface ExploreMessage {
     id: string;
@@ -79,6 +106,16 @@ interface ExploreMessage {
     answered?: boolean | null;
     /** Files the visitor attached to this turn. Present on USER messages only. */
     attachments?: ExploreAttachment[] | null;
+    /**
+     * The rating this visitor already gave this answer, or null for an unrated one.
+     *
+     * Selected only by the reads scoped to a `conversationToken`, so a polled or restored
+     * transcript shows what was already rated instead of offering the row again. It is always
+     * null on a SHARED transcript — that read is performed by someone else, and the rater's
+     * verdict and free-text note are not theirs to receive. See
+     * `EXPLORE_OWN_MESSAGE_FIELDS`.
+     */
+    feedback?: ExploreFeedback | null;
     errorCode?: string | null;
     createdAt: string;
     completedAt?: string | null;
@@ -171,9 +208,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    index\n  }\n  ctas {\n    kind\n    label\n    url\n    product\n  }\n  followUps\n  answered\n  attachments {\n    name\n    mimeType\n    size\n    textExtracted\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  \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  attachments {\n    name\n    mimeType\n    size\n    textExtracted\n  }\n  errorCode\n  createdAt\n  completedAt\n\n  feedback {\n    rating\n    reason\n    comment\n    createdAt\n  }\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    index\n  }\n  ctas {\n    kind\n    label\n    url\n    product\n  }\n  followUps\n  answered\n  attachments {\n    name\n    mimeType\n    size\n    textExtracted\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    index\n  }\n  ctas {\n    kind\n    label\n    url\n    product\n  }\n  followUps\n  answered\n  attachments {\n    name\n    mimeType\n    size\n    textExtracted\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  \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  attachments {\n    name\n    mimeType\n    size\n    textExtracted\n  }\n  errorCode\n  createdAt\n  completedAt\n\n  feedback {\n    rating\n    reason\n    comment\n    createdAt\n  }\n\n      }\n      assistantMessage {\n        \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  attachments {\n    name\n    mimeType\n    size\n    textExtracted\n  }\n  errorCode\n  createdAt\n  completedAt\n\n  feedback {\n    rating\n    reason\n    comment\n    createdAt\n  }\n\n      }\n      remainingToday\n    }\n  }\n";
 interface ExploreCatalogQueryData {
     exploreCatalog: ExploreCatalog;
 }
@@ -184,4 +221,4 @@ interface SendExploreMessageMutationData {
     sendExploreMessage: SendExploreMessageResult;
 }
 
-export { type ExploreProduct as E, SEND_EXPLORE_MESSAGE_MUTATION as S, type ExploreLimits as a, type ExploreCatalog as b, type ExploreMessage as c, EXPLORE_CATALOG_QUERY as d, EXPLORE_MESSAGE_QUERY as e, type ExploreCatalogQueryData as f, type ExploreConversation as g, type ExploreCtaKind as h, type ExploreCtaLink as i, type ExploreErrorCode as j, type ExploreMessageQueryData as k, type ExploreMessageRole as l, type ExploreMessageStatus as m, type ExploreReference as n, type SendExploreMessageInput as o, type SendExploreMessageMutationData as p, type SendExploreMessageResult as q };
+export { type ExploreProduct as E, SEND_EXPLORE_MESSAGE_MUTATION as S, type ExploreLimits as a, type ExploreCatalog as b, type ExploreMessage as c, type ExploreFeedbackRating as d, type ExploreFeedbackReason as e, EXPLORE_CATALOG_QUERY as f, EXPLORE_MESSAGE_QUERY as g, type ExploreCatalogQueryData as h, type ExploreConversation as i, type ExploreCtaKind as j, type ExploreCtaLink as k, type ExploreErrorCode as l, type ExploreMessageQueryData as m, type ExploreMessageRole as n, type ExploreMessageStatus as o, type ExploreReference as p, type SendExploreMessageInput as q, type SendExploreMessageMutationData as r, type SendExploreMessageResult as s };

package/dist/hooks/index.d.mts

@@ -1,5 +1,5 @@
-export { D as DEFAULT_EXPLORE_EXAMPLE_PROMPTS, E as ExploreChatError, a as ExploreChatErrorKind, b as ExploreChatPhase, F as FALLBACK_EXPLORE_LIMITS, U as UseExploreChatOptions, c as UseExploreChatResult, d as classifyExploreError, u as useExploreChat } from '../use-explore-chat-DC47G-C3.mjs';
-import '../explore-types-CLw19R76.mjs';
+export { D as DEFAULT_EXPLORE_EXAMPLE_PROMPTS, E as ExploreChatError, a as ExploreChatErrorKind, b as ExploreChatPhase, F as FALLBACK_EXPLORE_LIMITS, U as UseExploreChatOptions, c as UseExploreChatResult, d as classifyExploreError, u as useExploreChat } from '../use-explore-chat-C6Y8JQMj.mjs';
+import '../explore-types-CPF1QoMn.mjs';
 
 interface UseSpeechInputOptions {
     /** Receives settled text as it is recognised. Append it to the draft. */

package/dist/hooks/index.d.ts

@@ -1,5 +1,5 @@
-export { D as DEFAULT_EXPLORE_EXAMPLE_PROMPTS, E as ExploreChatError, a as ExploreChatErrorKind, b as ExploreChatPhase, F as FALLBACK_EXPLORE_LIMITS, U as UseExploreChatOptions, c as UseExploreChatResult, d as classifyExploreError, u as useExploreChat } from '../use-explore-chat-DyPMkzXA.js';
-import '../explore-types-CLw19R76.js';
+export { D as DEFAULT_EXPLORE_EXAMPLE_PROMPTS, E as ExploreChatError, a as ExploreChatErrorKind, b as ExploreChatPhase, F as FALLBACK_EXPLORE_LIMITS, U as UseExploreChatOptions, c as UseExploreChatResult, d as classifyExploreError, u as useExploreChat } from '../use-explore-chat--CxNtkrJ.js';
+import '../explore-types-CPF1QoMn.js';
 
 interface UseSpeechInputOptions {
     /** Receives settled text as it is recognised. Append it to the draft. */

package/dist/hooks/index.js

@@ -265,6 +265,18 @@ var EXPLORE_MESSAGE_FIELDS = (
   completedAt
 `
 );
+var EXPLORE_OWN_MESSAGE_FIELDS = (
+  /* GraphQL */
+  `
+  ${EXPLORE_MESSAGE_FIELDS}
+  feedback {
+    rating
+    reason
+    comment
+    createdAt
+  }
+`
+);
 var EXPLORE_CATALOG_QUERY = (
   /* GraphQL */
   `
@@ -297,7 +309,7 @@ var EXPLORE_MESSAGE_QUERY = (
   `
   query ExploreMessage($conversationToken: String!, $id: ID!) {
     exploreMessage(conversationToken: $conversationToken, id: $id) {
-      ${EXPLORE_MESSAGE_FIELDS}
+      ${EXPLORE_OWN_MESSAGE_FIELDS}
     }
   }
 `
@@ -315,10 +327,10 @@ var SEND_EXPLORE_MESSAGE_MUTATION = (
         createdAt
       }
       userMessage {
-        ${EXPLORE_MESSAGE_FIELDS}
+        ${EXPLORE_OWN_MESSAGE_FIELDS}
       }
       assistantMessage {
-        ${EXPLORE_MESSAGE_FIELDS}
+        ${EXPLORE_OWN_MESSAGE_FIELDS}
       }
       remainingToday
     }
@@ -335,6 +347,22 @@ var RECORD_EXPLORE_CLICK_MUTATION = (
   }
 `
 );
+var SUBMIT_EXPLORE_FEEDBACK_MUTATION = (
+  /* GraphQL */
+  `
+  mutation SubmitExploreFeedback($input: SubmitExploreFeedbackInput!) {
+    submitExploreFeedback(input: $input) {
+      recorded
+      feedback {
+        rating
+        reason
+        comment
+        createdAt
+      }
+    }
+  }
+`
+);
 var CREATE_EXPLORE_SHARE_LINK_MUTATION = (
   /* GraphQL */
   `
@@ -1383,6 +1411,42 @@ function useExploreChat(options = {}) {
     },
     [client]
   );
+  const submitFeedback = react.useCallback(
+    async (messageId, rating, detail) => {
+      const token = conversationTokenRef.current;
+      if (!token) return false;
+      const comment = detail?.comment?.trim();
+      const input = {
+        conversationToken: token,
+        messageId,
+        rating,
+        // Only meaningful with NOT_HELPFUL. The server stores null for HELPFUL either
+        // way; sending it would just be noise the backend has to defend against.
+        reason: rating === "NOT_HELPFUL" ? detail?.reason ?? null : null,
+        comment: comment ? comment : null
+      };
+      try {
+        const res = await client.mutate(
+          SUBMIT_EXPLORE_FEEDBACK_MUTATION,
+          { input }
+        );
+        const result = res?.data?.submitExploreFeedback;
+        if (!result?.recorded) return false;
+        const recorded = result.feedback;
+        if (recorded && mountedRef.current) {
+          setMessages(
+            (current) => current.map(
+              (message) => message.id === messageId ? { ...message, feedback: recorded } : message
+            )
+          );
+        }
+        return true;
+      } catch {
+        return false;
+      }
+    },
+    [client]
+  );
   return {
     phase,
     catalog,
@@ -1402,6 +1466,7 @@ function useExploreChat(options = {}) {
     deleteConversation,
     clearHistory,
     recordClick,
+    submitFeedback,
     createShareLink,
     isSharedView
   };