@burdenoff/website-sdk 2026.829.5 → 2026.829.6

package/dist/{use-explore-chat-B-E7jN1H.d.mts → use-explore-chat-BzXCz2UM.d.mts}

@@ -77,6 +77,8 @@ interface ExploreMessage {
      * with no source is the honest "we do not have this" signal rather than a hedge.
      */
     answered?: boolean | null;
+    /** Files the visitor attached to this turn. Present on USER messages only. */
+    attachments?: ExploreAttachment[] | null;
     errorCode?: string | null;
     createdAt: string;
     completedAt?: string | null;
@@ -130,6 +132,26 @@ interface SendExploreMessageInput {
     recaptchaToken?: string;
     locale?: string;
     pageUrl?: string;
+    /**
+     * Files attached as extra context. At most 5, each at most 10 MB — re-enforced server-side,
+     * so these are the limits the composer shows, not the limits that hold.
+     */
+    attachments?: ExploreAttachmentInput[];
+}
+/** `input ExploreAttachmentInput`. `textContent` is null for a format the browser cannot read. */
+interface ExploreAttachmentInput {
+    name: string;
+    mimeType: string;
+    size: number;
+    textContent: string | null;
+}
+/** `type ExploreAttachment` — what the server accepted, echoed back. */
+interface ExploreAttachment {
+    name: string;
+    mimeType: string;
+    size: number;
+    /** False when only the filename and type could be used as context. */
+    textExtracted: boolean;
 }
 /**
  * `type SendExploreMessageResult`.
@@ -149,9 +171,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  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  attachments {\n    name\n    mimeType\n    size\n    textExtracted\n  }\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    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";
+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";
 interface ExploreCatalogQueryData {
     exploreCatalog: ExploreCatalog;
 }
@@ -162,6 +184,14 @@ interface SendExploreMessageMutationData {
     sendExploreMessage: SendExploreMessageResult;
 }
 
+/** What travels on the wire — mirrors `ExploreAttachmentInput`. */
+interface ExploreAttachmentPayload {
+    name: string;
+    mimeType: string;
+    size: number;
+    textContent: string | null;
+}
+
 /**
  * Where the conversation is right now.
  *
@@ -226,7 +256,7 @@ interface UseExploreChatResult {
     /** Product the visitor pinned the conversation to, or null for "all". */
     focusProduct: string | null;
     setFocusProduct: (slug: string | null) => void;
-    send: (message: string) => Promise<void>;
+    send: (message: string, attachments?: readonly ExploreAttachmentPayload[]) => Promise<void>;
     /** Stop polling and keep whatever text has streamed so far. */
     stop: () => void;
     /** Re-send the last message after a failed turn. */
@@ -251,6 +281,11 @@ interface UseExploreChatResult {
      * The secret returned is not the conversation token and cannot continue the thread.
      */
     createShareLink: () => Promise<string | null>;
+    /**
+     * True when the transcript on screen came from a shared link rather than this visitor's own
+     * conversation. A shared view is read-only: the share secret cannot continue the thread.
+     */
+    isSharedView: boolean;
     canSend: boolean;
 }
 /** Fallback limits, mirroring the server defaults in CONTRACT.md §3. */

package/dist/{use-explore-chat-B-E7jN1H.d.ts → use-explore-chat-BzXCz2UM.d.ts}

@@ -77,6 +77,8 @@ interface ExploreMessage {
      * with no source is the honest "we do not have this" signal rather than a hedge.
      */
     answered?: boolean | null;
+    /** Files the visitor attached to this turn. Present on USER messages only. */
+    attachments?: ExploreAttachment[] | null;
     errorCode?: string | null;
     createdAt: string;
     completedAt?: string | null;
@@ -130,6 +132,26 @@ interface SendExploreMessageInput {
     recaptchaToken?: string;
     locale?: string;
     pageUrl?: string;
+    /**
+     * Files attached as extra context. At most 5, each at most 10 MB — re-enforced server-side,
+     * so these are the limits the composer shows, not the limits that hold.
+     */
+    attachments?: ExploreAttachmentInput[];
+}
+/** `input ExploreAttachmentInput`. `textContent` is null for a format the browser cannot read. */
+interface ExploreAttachmentInput {
+    name: string;
+    mimeType: string;
+    size: number;
+    textContent: string | null;
+}
+/** `type ExploreAttachment` — what the server accepted, echoed back. */
+interface ExploreAttachment {
+    name: string;
+    mimeType: string;
+    size: number;
+    /** False when only the filename and type could be used as context. */
+    textExtracted: boolean;
 }
 /**
  * `type SendExploreMessageResult`.
@@ -149,9 +171,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  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  attachments {\n    name\n    mimeType\n    size\n    textExtracted\n  }\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    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";
+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";
 interface ExploreCatalogQueryData {
     exploreCatalog: ExploreCatalog;
 }
@@ -162,6 +184,14 @@ interface SendExploreMessageMutationData {
     sendExploreMessage: SendExploreMessageResult;
 }
 
+/** What travels on the wire — mirrors `ExploreAttachmentInput`. */
+interface ExploreAttachmentPayload {
+    name: string;
+    mimeType: string;
+    size: number;
+    textContent: string | null;
+}
+
 /**
  * Where the conversation is right now.
  *
@@ -226,7 +256,7 @@ interface UseExploreChatResult {
     /** Product the visitor pinned the conversation to, or null for "all". */
     focusProduct: string | null;
     setFocusProduct: (slug: string | null) => void;
-    send: (message: string) => Promise<void>;
+    send: (message: string, attachments?: readonly ExploreAttachmentPayload[]) => Promise<void>;
     /** Stop polling and keep whatever text has streamed so far. */
     stop: () => void;
     /** Re-send the last message after a failed turn. */
@@ -251,6 +281,11 @@ interface UseExploreChatResult {
      * The secret returned is not the conversation token and cannot continue the thread.
      */
     createShareLink: () => Promise<string | null>;
+    /**
+     * True when the transcript on screen came from a shared link rather than this visitor's own
+     * conversation. A shared view is read-only: the share secret cannot continue the thread.
+     */
+    isSharedView: boolean;
     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.829.5",
+  "version": "2026.829.6",
   "description": "Shared SDK for Burdenoff product websites - reusable React components, utilities, and configurations",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",