@burdenoff/website-sdk 2026.1102.2 → 2026.1102.3

package/dist/{use-explore-chat-DunjG-3p.d.ts → use-explore-chat-B3dOOvJN.d.ts}

@@ -1,4 +1,4 @@
-import { E as ExploreCatalog, a as ExploreMessage, b as ExploreFeedbackRating, c as ExploreFeedbackReason, d as ExploreLimits } from './explore-types-Bb2Ih3d8.js';
+import { E as ExploreCatalog, a as ExploreMessage, b as ExploreSurface, c as ExploreFeedbackRating, d as ExploreFeedbackReason, e as ExploreLimits } from './explore-types-Ol1Mm3dW.js';
 
 /** What travels on the wire — mirrors `ExploreAttachmentInput`. */
 interface ExploreAttachmentPayload {
@@ -122,6 +122,31 @@ interface UseExploreChatOptions {
      */
     shareToken?: string | null;
 }
+/** How one question is sent: see {@link UseExploreChatResult.send}. */
+interface ExploreSendOptions {
+    surface?: ExploreSurface;
+}
+/**
+ * The question one {@link UseExploreChatResult.send} added to the conversation: the id of its USER message (the
+ * server's once the server took it; the one shown while it was on its way when the server never did) and the
+ * conversation's token as the send ended (null when the server never named one).
+ */
+interface ExploreSent {
+    userMessageId: string;
+    conversationToken: string | null;
+}
+/**
+ * A question a {@link UseExploreChatResult.retry} sent again, in place of the one that failed: every id the question
+ * had before (`replacedMessageIds`, oldest first: the failed USER message the retry dropped, then, once the server
+ * took it, the one shown while it was on its way) and the question as it is now. Announced when the retry adds its
+ * question, and again once the server takes it (its own message, and the conversation's token as the server named
+ * it), each time in the same update as the messages it describes. Both name the failed message, so a reader that only
+ * sees the last one (React may render the two as one) still finds the question it knew.
+ */
+interface ExploreResent {
+    replacedMessageIds: readonly string[];
+    sent: ExploreSent;
+}
 interface UseExploreChatResult {
     phase: ExploreChatPhase;
     /** Never null — starts as the baked or static fallback catalog, upgraded by the server. */
@@ -140,11 +165,26 @@ interface UseExploreChatResult {
     /** Product the visitor pinned the conversation to, or null for "all". */
     focusProduct: string | null;
     setFocusProduct: (slug: string | null) => void;
-    send: (message: string, attachments?: readonly ExploreAttachmentPayload[]) => Promise<void>;
+    /**
+     * Ask `message`, with files as extra context. `options.surface` says where it was asked: only the live avatar's own
+     * question box passes `AVATAR` (BOFF-9797); the chat's composer passes nothing, and nothing is sent for it. A retry
+     * and the silent re-send after a stale captcha token keep the surface of the question they send again.
+     *
+     * Resolves, once the server has answered the send (or it failed), with the question it added, or null when it added
+     * none: an empty question, one asked while another is on its way, a disabled chat, a question over the length or
+     * turn limit, or the panel gone.
+     */
+    send: (message: string, attachments?: readonly ExploreAttachmentPayload[], options?: ExploreSendOptions) => Promise<ExploreSent | null>;
     /** Stop polling and keep whatever text has streamed so far. */
     stop: () => void;
     /** Re-send the last message after a failed turn. */
     retry: () => void;
+    /**
+     * BOFF-9797. The last question a {@link retry} sent again in place of a failed one (see {@link ExploreResent}), or
+     * null when there was none since the conversation was last reset. The Avatar tab follows it, so a question asked
+     * there and retried from Chat is still the one asked there.
+     */
+    resent: ExploreResent | null;
     /** Clear the conversation and the persisted session. */
     reset: () => void;
     /** Past conversations held in THIS browser, newest first. */
@@ -243,4 +283,4 @@ interface ArchivedExploreConversation {
 }
 declare function useExploreChat(options?: UseExploreChatOptions): UseExploreChatResult;
 
-export { DEFAULT_EXPLORE_EXAMPLE_PROMPTS as D, type ExploreChatError as E, FALLBACK_EXPLORE_LIMITS as F, type StagedAttachment as S, type UseExploreChatOptions as U, type ExploreChatErrorKind as a, type ExploreChatPhase as b, type ExploreEscalateOutcome as c, type ExploreEscalateResult as d, type UseExploreChatResult as e, classifyExploreError as f, useExploreChat as u };
+export { DEFAULT_EXPLORE_EXAMPLE_PROMPTS as D, type ExploreChatError as E, FALLBACK_EXPLORE_LIMITS as F, type StagedAttachment as S, type UseExploreChatOptions as U, type ExploreChatErrorKind as a, type ExploreChatPhase as b, type ExploreEscalateOutcome as c, type ExploreEscalateResult as d, type ExploreResent as e, type ExploreSendOptions as f, type ExploreSent as g, type UseExploreChatResult as h, classifyExploreError as i, useExploreChat as u };

package/dist/{use-explore-chat-zRuoAin6.d.mts → use-explore-chat-CbfohA9O.d.mts}

@@ -1,4 +1,4 @@
-import { E as ExploreCatalog, a as ExploreMessage, b as ExploreFeedbackRating, c as ExploreFeedbackReason, d as ExploreLimits } from './explore-types-Bb2Ih3d8.mjs';
+import { E as ExploreCatalog, a as ExploreMessage, b as ExploreSurface, c as ExploreFeedbackRating, d as ExploreFeedbackReason, e as ExploreLimits } from './explore-types-Ol1Mm3dW.mjs';
 
 /** What travels on the wire — mirrors `ExploreAttachmentInput`. */
 interface ExploreAttachmentPayload {
@@ -122,6 +122,31 @@ interface UseExploreChatOptions {
      */
     shareToken?: string | null;
 }
+/** How one question is sent: see {@link UseExploreChatResult.send}. */
+interface ExploreSendOptions {
+    surface?: ExploreSurface;
+}
+/**
+ * The question one {@link UseExploreChatResult.send} added to the conversation: the id of its USER message (the
+ * server's once the server took it; the one shown while it was on its way when the server never did) and the
+ * conversation's token as the send ended (null when the server never named one).
+ */
+interface ExploreSent {
+    userMessageId: string;
+    conversationToken: string | null;
+}
+/**
+ * A question a {@link UseExploreChatResult.retry} sent again, in place of the one that failed: every id the question
+ * had before (`replacedMessageIds`, oldest first: the failed USER message the retry dropped, then, once the server
+ * took it, the one shown while it was on its way) and the question as it is now. Announced when the retry adds its
+ * question, and again once the server takes it (its own message, and the conversation's token as the server named
+ * it), each time in the same update as the messages it describes. Both name the failed message, so a reader that only
+ * sees the last one (React may render the two as one) still finds the question it knew.
+ */
+interface ExploreResent {
+    replacedMessageIds: readonly string[];
+    sent: ExploreSent;
+}
 interface UseExploreChatResult {
     phase: ExploreChatPhase;
     /** Never null — starts as the baked or static fallback catalog, upgraded by the server. */
@@ -140,11 +165,26 @@ interface UseExploreChatResult {
     /** Product the visitor pinned the conversation to, or null for "all". */
     focusProduct: string | null;
     setFocusProduct: (slug: string | null) => void;
-    send: (message: string, attachments?: readonly ExploreAttachmentPayload[]) => Promise<void>;
+    /**
+     * Ask `message`, with files as extra context. `options.surface` says where it was asked: only the live avatar's own
+     * question box passes `AVATAR` (BOFF-9797); the chat's composer passes nothing, and nothing is sent for it. A retry
+     * and the silent re-send after a stale captcha token keep the surface of the question they send again.
+     *
+     * Resolves, once the server has answered the send (or it failed), with the question it added, or null when it added
+     * none: an empty question, one asked while another is on its way, a disabled chat, a question over the length or
+     * turn limit, or the panel gone.
+     */
+    send: (message: string, attachments?: readonly ExploreAttachmentPayload[], options?: ExploreSendOptions) => Promise<ExploreSent | null>;
     /** Stop polling and keep whatever text has streamed so far. */
     stop: () => void;
     /** Re-send the last message after a failed turn. */
     retry: () => void;
+    /**
+     * BOFF-9797. The last question a {@link retry} sent again in place of a failed one (see {@link ExploreResent}), or
+     * null when there was none since the conversation was last reset. The Avatar tab follows it, so a question asked
+     * there and retried from Chat is still the one asked there.
+     */
+    resent: ExploreResent | null;
     /** Clear the conversation and the persisted session. */
     reset: () => void;
     /** Past conversations held in THIS browser, newest first. */
@@ -243,4 +283,4 @@ interface ArchivedExploreConversation {
 }
 declare function useExploreChat(options?: UseExploreChatOptions): UseExploreChatResult;
 
-export { DEFAULT_EXPLORE_EXAMPLE_PROMPTS as D, type ExploreChatError as E, FALLBACK_EXPLORE_LIMITS as F, type StagedAttachment as S, type UseExploreChatOptions as U, type ExploreChatErrorKind as a, type ExploreChatPhase as b, type ExploreEscalateOutcome as c, type ExploreEscalateResult as d, type UseExploreChatResult as e, classifyExploreError as f, useExploreChat as u };
+export { DEFAULT_EXPLORE_EXAMPLE_PROMPTS as D, type ExploreChatError as E, FALLBACK_EXPLORE_LIMITS as F, type StagedAttachment as S, type UseExploreChatOptions as U, type ExploreChatErrorKind as a, type ExploreChatPhase as b, type ExploreEscalateOutcome as c, type ExploreEscalateResult as d, type ExploreResent as e, type ExploreSendOptions as f, type ExploreSent as g, type UseExploreChatResult as h, classifyExploreError as i, useExploreChat as u };

package/package.json

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