@burdenoff/website-sdk 2026.826.1 → 2026.828.2

package/dist/{graphql-client-Cv6TO6hn.d.mts → graphql-client-BXn6RYV0.d.mts}

@@ -29,6 +29,30 @@ interface WebSDKClientConfig {
      */
     maxRetries?: number;
 }
+/**
+ * Per-call overrides for {@link WebSDKClient.query}.
+ *
+ * The defaults (5-minute response cache + in-flight deduplication) are right
+ * for the read-once content queries most SDK components make, and wrong for a
+ * poll loop: the second poll of the same `(query, variables)` pair would be
+ * served straight from the cache and the UI would freeze on the first
+ * response forever. Pass `{ cache: false }` for anything polled.
+ */
+interface WebSDKQueryOptions {
+    /**
+     * Use the response cache and in-flight deduplication. Default `true`.
+     * `false` skips the cache read, the dedupe map AND the cache write, so the
+     * call always hits the network and never poisons a later cached read.
+     */
+    cache?: boolean;
+    /** Override the client-wide request timeout for this call only. */
+    timeoutMs?: number;
+}
+/** Per-call overrides for {@link WebSDKClient.mutate}. */
+interface WebSDKMutateOptions {
+    /** Override the client-wide request timeout for this call only. */
+    timeoutMs?: number;
+}
 interface GraphQLResponse<T = Record<string, unknown>> {
     data?: T;
     errors?: Array<{
@@ -53,13 +77,16 @@ declare class WebSDKClient {
     constructor(config: WebSDKClientConfig);
     getConfig(): WebSDKClientConfig;
     /**
-     * Execute a GraphQL query (with deduplication and caching)
+     * Execute a GraphQL query (with deduplication and caching).
+     *
+     * Pass `{ cache: false }` to bypass the cache entirely — required for poll
+     * loops, where every tick must reach the network.
      */
-    query<T = Record<string, unknown>>(query: string, variables?: Record<string, unknown>): Promise<GraphQLResponse<T>>;
+    query<T = Record<string, unknown>>(query: string, variables?: Record<string, unknown>, options?: WebSDKQueryOptions): Promise<GraphQLResponse<T>>;
     /**
      * Execute a GraphQL mutation
      */
-    mutate<T = Record<string, unknown>>(mutation: string, variables?: Record<string, unknown>): Promise<GraphQLResponse<T>>;
+    mutate<T = Record<string, unknown>>(mutation: string, variables?: Record<string, unknown>, options?: WebSDKMutateOptions): Promise<GraphQLResponse<T>>;
     /** HTTP statuses worth another attempt — transient server/edge conditions. */
     private static isRetriableStatus;
     private static sleep;
@@ -72,4 +99,4 @@ declare class WebSDKClient {
     private request;
 }
 
-export { WebSDKClient as W, type WebSDKClientConfig as a };
+export { type GraphQLResponse as G, WebSDKClient as W, type WebSDKClientConfig as a, type WebSDKMutateOptions as b, type WebSDKQueryOptions as c };

package/dist/{graphql-client-Cv6TO6hn.d.ts → graphql-client-BXn6RYV0.d.ts}

@@ -29,6 +29,30 @@ interface WebSDKClientConfig {
      */
     maxRetries?: number;
 }
+/**
+ * Per-call overrides for {@link WebSDKClient.query}.
+ *
+ * The defaults (5-minute response cache + in-flight deduplication) are right
+ * for the read-once content queries most SDK components make, and wrong for a
+ * poll loop: the second poll of the same `(query, variables)` pair would be
+ * served straight from the cache and the UI would freeze on the first
+ * response forever. Pass `{ cache: false }` for anything polled.
+ */
+interface WebSDKQueryOptions {
+    /**
+     * Use the response cache and in-flight deduplication. Default `true`.
+     * `false` skips the cache read, the dedupe map AND the cache write, so the
+     * call always hits the network and never poisons a later cached read.
+     */
+    cache?: boolean;
+    /** Override the client-wide request timeout for this call only. */
+    timeoutMs?: number;
+}
+/** Per-call overrides for {@link WebSDKClient.mutate}. */
+interface WebSDKMutateOptions {
+    /** Override the client-wide request timeout for this call only. */
+    timeoutMs?: number;
+}
 interface GraphQLResponse<T = Record<string, unknown>> {
     data?: T;
     errors?: Array<{
@@ -53,13 +77,16 @@ declare class WebSDKClient {
     constructor(config: WebSDKClientConfig);
     getConfig(): WebSDKClientConfig;
     /**
-     * Execute a GraphQL query (with deduplication and caching)
+     * Execute a GraphQL query (with deduplication and caching).
+     *
+     * Pass `{ cache: false }` to bypass the cache entirely — required for poll
+     * loops, where every tick must reach the network.
      */
-    query<T = Record<string, unknown>>(query: string, variables?: Record<string, unknown>): Promise<GraphQLResponse<T>>;
+    query<T = Record<string, unknown>>(query: string, variables?: Record<string, unknown>, options?: WebSDKQueryOptions): Promise<GraphQLResponse<T>>;
     /**
      * Execute a GraphQL mutation
      */
-    mutate<T = Record<string, unknown>>(mutation: string, variables?: Record<string, unknown>): Promise<GraphQLResponse<T>>;
+    mutate<T = Record<string, unknown>>(mutation: string, variables?: Record<string, unknown>, options?: WebSDKMutateOptions): Promise<GraphQLResponse<T>>;
     /** HTTP statuses worth another attempt — transient server/edge conditions. */
     private static isRetriableStatus;
     private static sleep;
@@ -72,4 +99,4 @@ declare class WebSDKClient {
     private request;
 }
 
-export { WebSDKClient as W, type WebSDKClientConfig as a };
+export { type GraphQLResponse as G, WebSDKClient as W, type WebSDKClientConfig as a, type WebSDKMutateOptions as b, type WebSDKQueryOptions as c };

package/dist/hooks/index.d.mts

@@ -0,0 +1 @@
+export { D as DEFAULT_EXPLORE_EXAMPLE_PROMPTS, d as ExploreChatError, e as ExploreChatErrorKind, f as ExploreChatPhase, F as FALLBACK_EXPLORE_LIMITS, U as UseExploreChatOptions, u as UseExploreChatResult, v as classifyExploreError, w as useExploreChat } from '../index-CUJTTlYx.mjs';

package/dist/hooks/index.d.ts

@@ -0,0 +1 @@
+export { D as DEFAULT_EXPLORE_EXAMPLE_PROMPTS, d as ExploreChatError, e as ExploreChatErrorKind, f as ExploreChatPhase, F as FALLBACK_EXPLORE_LIMITS, U as UseExploreChatOptions, u as UseExploreChatResult, v as classifyExploreError, w as useExploreChat } from '../index-CUJTTlYx.js';