@burdenoff/website-sdk 2026.1024.1 → 2026.1026.1

package/dist/{use-progressive-reveal-Kr6DwGXG.d.mts → use-progressive-reveal-BFPWbEXy.d.mts}

@@ -1,4 +1,4 @@
-import { b as ExploreLimits, c as ExploreCatalog, d as ExploreMessage, e as ExploreFeedbackRating, f as ExploreFeedbackReason } from './explore-types-BB8HNFzX.mjs';
+import { b as ExploreCatalog, c as ExploreMessage, d as ExploreFeedbackRating, e as ExploreFeedbackReason, f as ExploreLimits } from './explore-types-_9UJu6EA.mjs';
 
 /** What travels on the wire — mirrors `ExploreAttachmentInput`. */
 interface ExploreAttachmentPayload {
@@ -7,6 +7,13 @@ interface ExploreAttachmentPayload {
     size: number;
     textContent: string | null;
 }
+/** A file staged in the composer, before it is sent. */
+interface StagedAttachment extends ExploreAttachmentPayload {
+    /** Stable across re-renders so React keys and the remove button behave. */
+    id: string;
+    /** False when only the name and type could be used. Drives the UI's honesty. */
+    textExtracted: boolean;
+}
 
 /**
  * Where the conversation is right now.
@@ -98,6 +105,22 @@ interface UseExploreChatOptions {
     persist?: boolean;
     /** Called with the message text each time a send is accepted locally. */
     onSend?: (message: string) => void;
+    /**
+     * Whether the conversation is live. Default `true`: every caller that does not pass it behaves exactly as before.
+     *
+     * While `false` the hook asks nothing and reads nothing: no catalog request, no localStorage restore, no shared-link
+     * load (BOFF-9697). A host that keeps ONE conversation for a whole site (an `ExploreChatProvider` above its routes)
+     * passes `false` until the visitor first opens the assistant, so a page view costs no request. A one-way switch:
+     * once `true`, keep it `true` (the provider latches it).
+     */
+    enabled?: boolean;
+    /**
+     * The `?c=` share token to open, in place of reading it from the page's URL (BOFF-9697). Unset (every existing
+     * caller): read from the URL as before. A site-wide provider mounts once for every page, so it takes the token from
+     * its router instead: the token of the route showing `/explore`, `null` anywhere else (a `?c=` on another page is
+     * not a shared conversation). Read once, like the URL: a different token needs a fresh hook (a new `key`).
+     */
+    shareToken?: string | null;
 }
 interface UseExploreChatResult {
     phase: ExploreChatPhase;
@@ -246,4 +269,4 @@ declare function useSpeechOutput({ lang, }?: UseSpeechOutputOptions): UseSpeechO
  */
 declare function useProgressiveReveal(text: string, settled: boolean): string;
 
-export { DEFAULT_EXPLORE_EXAMPLE_PROMPTS as D, type ExploreChatError as E, FALLBACK_EXPLORE_LIMITS as F, type UseExploreChatOptions as U, type ExploreChatErrorKind as a, type ExploreChatPhase as b, type ExploreEscalateOutcome as c, type ExploreEscalateResult as d, type UseExploreChatResult as e, type UseSpeechOutputOptions as f, type UseSpeechOutputResult as g, classifyExploreError as h, useProgressiveReveal as i, useSpeechOutput as j, stopSpeaking as s, 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 UseExploreChatResult as e, type UseSpeechOutputOptions as f, type UseSpeechOutputResult as g, classifyExploreError as h, useProgressiveReveal as i, useSpeechOutput as j, stopSpeaking as s, useExploreChat as u };

package/dist/{use-progressive-reveal-BVJn9NIr.d.ts → use-progressive-reveal-C0hkdu_i.d.ts}

@@ -1,4 +1,4 @@
-import { b as ExploreLimits, c as ExploreCatalog, d as ExploreMessage, e as ExploreFeedbackRating, f as ExploreFeedbackReason } from './explore-types-BB8HNFzX.js';
+import { b as ExploreCatalog, c as ExploreMessage, d as ExploreFeedbackRating, e as ExploreFeedbackReason, f as ExploreLimits } from './explore-types-_9UJu6EA.js';
 
 /** What travels on the wire — mirrors `ExploreAttachmentInput`. */
 interface ExploreAttachmentPayload {
@@ -7,6 +7,13 @@ interface ExploreAttachmentPayload {
     size: number;
     textContent: string | null;
 }
+/** A file staged in the composer, before it is sent. */
+interface StagedAttachment extends ExploreAttachmentPayload {
+    /** Stable across re-renders so React keys and the remove button behave. */
+    id: string;
+    /** False when only the name and type could be used. Drives the UI's honesty. */
+    textExtracted: boolean;
+}
 
 /**
  * Where the conversation is right now.
@@ -98,6 +105,22 @@ interface UseExploreChatOptions {
     persist?: boolean;
     /** Called with the message text each time a send is accepted locally. */
     onSend?: (message: string) => void;
+    /**
+     * Whether the conversation is live. Default `true`: every caller that does not pass it behaves exactly as before.
+     *
+     * While `false` the hook asks nothing and reads nothing: no catalog request, no localStorage restore, no shared-link
+     * load (BOFF-9697). A host that keeps ONE conversation for a whole site (an `ExploreChatProvider` above its routes)
+     * passes `false` until the visitor first opens the assistant, so a page view costs no request. A one-way switch:
+     * once `true`, keep it `true` (the provider latches it).
+     */
+    enabled?: boolean;
+    /**
+     * The `?c=` share token to open, in place of reading it from the page's URL (BOFF-9697). Unset (every existing
+     * caller): read from the URL as before. A site-wide provider mounts once for every page, so it takes the token from
+     * its router instead: the token of the route showing `/explore`, `null` anywhere else (a `?c=` on another page is
+     * not a shared conversation). Read once, like the URL: a different token needs a fresh hook (a new `key`).
+     */
+    shareToken?: string | null;
 }
 interface UseExploreChatResult {
     phase: ExploreChatPhase;
@@ -246,4 +269,4 @@ declare function useSpeechOutput({ lang, }?: UseSpeechOutputOptions): UseSpeechO
  */
 declare function useProgressiveReveal(text: string, settled: boolean): string;
 
-export { DEFAULT_EXPLORE_EXAMPLE_PROMPTS as D, type ExploreChatError as E, FALLBACK_EXPLORE_LIMITS as F, type UseExploreChatOptions as U, type ExploreChatErrorKind as a, type ExploreChatPhase as b, type ExploreEscalateOutcome as c, type ExploreEscalateResult as d, type UseExploreChatResult as e, type UseSpeechOutputOptions as f, type UseSpeechOutputResult as g, classifyExploreError as h, useProgressiveReveal as i, useSpeechOutput as j, stopSpeaking as s, 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 UseExploreChatResult as e, type UseSpeechOutputOptions as f, type UseSpeechOutputResult as g, classifyExploreError as h, useProgressiveReveal as i, useSpeechOutput as j, stopSpeaking as s, useExploreChat as u };

package/package.json

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