@burdenoff/website-sdk 2026.922.3 → 2026.922.4

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

@@ -142,6 +142,27 @@ interface ExploreLimits {
     messagesPerDay: number;
     historyTurns: number;
 }
+/**
+ * `type ExploreConceptHighlight` — one published concept illustration, offered
+ * as a way into the conversation before the visitor has typed anything.
+ *
+ * Every field is non-null on the wire: a highlight with no picture or no
+ * destination is not a highlight, so the server drops it rather than sending a
+ * half-built one. `product` is the slug, `productName` the display casing the
+ * product's own pages use.
+ *
+ * The pictures are the published concept mockups — illustrations of an idea,
+ * not screenshots of shipping software — which is why every surface that shows
+ * one also labels it (`ExploreStrings.conceptIllustration`).
+ */
+interface ExploreConceptHighlight {
+    product: string;
+    productName: string;
+    title: string;
+    url: string;
+    imageUrl: string;
+    alt: string;
+}
 /**
  * `type ExploreCatalog` — everything the page needs before the first message.
  *
@@ -157,6 +178,18 @@ interface ExploreCatalog {
     limits: ExploreLimits;
     captchaRequired: boolean;
     recaptchaSiteKey?: string | null;
+    /**
+     * At most 8, the site's own product first. Non-null and non-nullable per the
+     * contract, so a gateway that knows the field always sends an array.
+     *
+     * A gateway that does NOT know it yet does not answer without it — it refuses
+     * the whole document (`GRAPHQL_VALIDATION_FAILED`), which is why the hook
+     * retries with `EXPLORE_CATALOG_QUERY_WITHOUT_HIGHLIGHTS` instead of falling
+     * back to the built-in catalog. That retry is the one response that reaches
+     * `normalizeCatalog` with this field absent, and the hardening there is what
+     * keeps `catalog.conceptHighlights.filter(...)` from throwing in render.
+     */
+    conceptHighlights: ExploreConceptHighlight[];
 }
 /** `input SendExploreMessageInput`. */
 interface SendExploreMessageInput {
@@ -202,7 +235,30 @@ interface SendExploreMessageResult {
     remainingToday?: number | null;
 }
 /** Loaded once per page. Safe to serve from the SDK's 5-minute query cache. */
-declare const EXPLORE_CATALOG_QUERY = "\n  query ExploreCatalog($productSlug: String) {\n    exploreCatalog(productSlug: $productSlug) {\n      enabled\n      products {\n        slug\n        name\n        tagline\n        website\n      }\n      examplePrompts\n      welcomeTitle\n      welcomeBody\n      limits {\n        maxMessageLength\n        maxTurnsPerConversation\n        messagesPerDay\n        historyTurns\n      }\n      captchaRequired\n      recaptchaSiteKey\n    }\n  }\n";
+declare const EXPLORE_CATALOG_QUERY: string;
+/**
+ * The same catalog WITHOUT `conceptHighlights`, for a gateway whose supergraph
+ * predates the field.
+ *
+ * This is not belt-and-braces. GraphQL validation is all-or-nothing: a gateway
+ * that does not know the field rejects the ENTIRE document and returns no
+ * `data` at all, so selecting `conceptHighlights` against an older supergraph
+ * costs the whole catalog — `enabled`, `captchaRequired`, `recaptchaSiteKey`,
+ * the welcome copy and `limits` included — and not merely the strip. Measured
+ * against production:
+ *
+ *     {"errors":[{"message":"Cannot query field \\"conceptHighlights\\" on type
+ *       \\"ExploreCatalog\\".","extensions":{"code":"GRAPHQL_VALIDATION_FAILED"}}]}
+ *
+ * That window is guaranteed even with perfect deploy ordering, because the prod
+ * gateway's CDN edge serves a stale supergraph for ~30-40 minutes after the
+ * subgraph publishes. `useExploreChat` therefore retries with this document
+ * (see `catalogRejectedTheHighlightField`) rather than dropping to the built-in
+ * fallback, whose hardcoded `enabled: true` would ignore the server-side kill
+ * switch and whose `captchaRequired: false` would let every send be rejected
+ * server-side while the composer looked fine.
+ */
+declare const EXPLORE_CATALOG_QUERY_WITHOUT_HIGHLIGHTS: string;
 /**
  * The poll. MUST be issued with `client.query(..., { cache: false })` — the
  * default 5-minute cache would return the first PENDING snapshot forever and
@@ -221,4 +277,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, 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 };
+export { type ExploreProduct as E, SEND_EXPLORE_MESSAGE_MUTATION as S, type ExploreReference as a, type ExploreLimits as b, type ExploreCatalog as c, type ExploreMessage as d, type ExploreFeedbackRating as e, type ExploreFeedbackReason as f, EXPLORE_CATALOG_QUERY as g, EXPLORE_CATALOG_QUERY_WITHOUT_HIGHLIGHTS as h, EXPLORE_MESSAGE_QUERY as i, type ExploreCatalogQueryData as j, type ExploreConceptHighlight as k, type ExploreConversation as l, type ExploreCtaKind as m, type ExploreCtaLink as n, type ExploreErrorCode as o, type ExploreMessageQueryData as p, type ExploreMessageRole as q, type ExploreMessageStatus as r, type SendExploreMessageInput as s, type SendExploreMessageMutationData as t, type SendExploreMessageResult as u };

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

@@ -142,6 +142,27 @@ interface ExploreLimits {
     messagesPerDay: number;
     historyTurns: number;
 }
+/**
+ * `type ExploreConceptHighlight` — one published concept illustration, offered
+ * as a way into the conversation before the visitor has typed anything.
+ *
+ * Every field is non-null on the wire: a highlight with no picture or no
+ * destination is not a highlight, so the server drops it rather than sending a
+ * half-built one. `product` is the slug, `productName` the display casing the
+ * product's own pages use.
+ *
+ * The pictures are the published concept mockups — illustrations of an idea,
+ * not screenshots of shipping software — which is why every surface that shows
+ * one also labels it (`ExploreStrings.conceptIllustration`).
+ */
+interface ExploreConceptHighlight {
+    product: string;
+    productName: string;
+    title: string;
+    url: string;
+    imageUrl: string;
+    alt: string;
+}
 /**
  * `type ExploreCatalog` — everything the page needs before the first message.
  *
@@ -157,6 +178,18 @@ interface ExploreCatalog {
     limits: ExploreLimits;
     captchaRequired: boolean;
     recaptchaSiteKey?: string | null;
+    /**
+     * At most 8, the site's own product first. Non-null and non-nullable per the
+     * contract, so a gateway that knows the field always sends an array.
+     *
+     * A gateway that does NOT know it yet does not answer without it — it refuses
+     * the whole document (`GRAPHQL_VALIDATION_FAILED`), which is why the hook
+     * retries with `EXPLORE_CATALOG_QUERY_WITHOUT_HIGHLIGHTS` instead of falling
+     * back to the built-in catalog. That retry is the one response that reaches
+     * `normalizeCatalog` with this field absent, and the hardening there is what
+     * keeps `catalog.conceptHighlights.filter(...)` from throwing in render.
+     */
+    conceptHighlights: ExploreConceptHighlight[];
 }
 /** `input SendExploreMessageInput`. */
 interface SendExploreMessageInput {
@@ -202,7 +235,30 @@ interface SendExploreMessageResult {
     remainingToday?: number | null;
 }
 /** Loaded once per page. Safe to serve from the SDK's 5-minute query cache. */
-declare const EXPLORE_CATALOG_QUERY = "\n  query ExploreCatalog($productSlug: String) {\n    exploreCatalog(productSlug: $productSlug) {\n      enabled\n      products {\n        slug\n        name\n        tagline\n        website\n      }\n      examplePrompts\n      welcomeTitle\n      welcomeBody\n      limits {\n        maxMessageLength\n        maxTurnsPerConversation\n        messagesPerDay\n        historyTurns\n      }\n      captchaRequired\n      recaptchaSiteKey\n    }\n  }\n";
+declare const EXPLORE_CATALOG_QUERY: string;
+/**
+ * The same catalog WITHOUT `conceptHighlights`, for a gateway whose supergraph
+ * predates the field.
+ *
+ * This is not belt-and-braces. GraphQL validation is all-or-nothing: a gateway
+ * that does not know the field rejects the ENTIRE document and returns no
+ * `data` at all, so selecting `conceptHighlights` against an older supergraph
+ * costs the whole catalog — `enabled`, `captchaRequired`, `recaptchaSiteKey`,
+ * the welcome copy and `limits` included — and not merely the strip. Measured
+ * against production:
+ *
+ *     {"errors":[{"message":"Cannot query field \\"conceptHighlights\\" on type
+ *       \\"ExploreCatalog\\".","extensions":{"code":"GRAPHQL_VALIDATION_FAILED"}}]}
+ *
+ * That window is guaranteed even with perfect deploy ordering, because the prod
+ * gateway's CDN edge serves a stale supergraph for ~30-40 minutes after the
+ * subgraph publishes. `useExploreChat` therefore retries with this document
+ * (see `catalogRejectedTheHighlightField`) rather than dropping to the built-in
+ * fallback, whose hardcoded `enabled: true` would ignore the server-side kill
+ * switch and whose `captchaRequired: false` would let every send be rejected
+ * server-side while the composer looked fine.
+ */
+declare const EXPLORE_CATALOG_QUERY_WITHOUT_HIGHLIGHTS: string;
 /**
  * The poll. MUST be issued with `client.query(..., { cache: false })` — the
  * default 5-minute cache would return the first PENDING snapshot forever and
@@ -221,4 +277,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, 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 };
+export { type ExploreProduct as E, SEND_EXPLORE_MESSAGE_MUTATION as S, type ExploreReference as a, type ExploreLimits as b, type ExploreCatalog as c, type ExploreMessage as d, type ExploreFeedbackRating as e, type ExploreFeedbackReason as f, EXPLORE_CATALOG_QUERY as g, EXPLORE_CATALOG_QUERY_WITHOUT_HIGHLIGHTS as h, EXPLORE_MESSAGE_QUERY as i, type ExploreCatalogQueryData as j, type ExploreConceptHighlight as k, type ExploreConversation as l, type ExploreCtaKind as m, type ExploreCtaLink as n, type ExploreErrorCode as o, type ExploreMessageQueryData as p, type ExploreMessageRole as q, type ExploreMessageStatus as r, type SendExploreMessageInput as s, type SendExploreMessageMutationData as t, type SendExploreMessageResult as u };

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-C6Y8JQMj.mjs';
-import '../explore-types-CPF1QoMn.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-Dgm-jf96.mjs';
+import '../explore-types-DvQPiL1t.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--CxNtkrJ.js';
-import '../explore-types-CPF1QoMn.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-CNEdKBc1.js';
+import '../explore-types-DvQPiL1t.js';
 
 interface UseSpeechInputOptions {
     /** Receives settled text as it is recognised. Append it to the draft. */

package/dist/hooks/index.js

@@ -277,11 +277,9 @@ var EXPLORE_OWN_MESSAGE_FIELDS = (
   }
 `
 );
-var EXPLORE_CATALOG_QUERY = (
+var EXPLORE_CATALOG_ESTABLISHED_FIELDS = (
   /* GraphQL */
   `
-  query ExploreCatalog($productSlug: String) {
-    exploreCatalog(productSlug: $productSlug) {
       enabled
       products {
         slug
@@ -299,11 +297,35 @@ var EXPLORE_CATALOG_QUERY = (
         historyTurns
       }
       captchaRequired
-      recaptchaSiteKey
+      recaptchaSiteKey`
+);
+var EXPLORE_CATALOG_HIGHLIGHT_FIELD = (
+  /* GraphQL */
+  `
+      conceptHighlights {
+        product
+        productName
+        title
+        url
+        imageUrl
+        alt
+      }`
+);
+function exploreCatalogDocument(extraFields) {
+  return (
+    /* GraphQL */
+    `
+  query ExploreCatalog($productSlug: String) {
+    exploreCatalog(productSlug: $productSlug) {${EXPLORE_CATALOG_ESTABLISHED_FIELDS}${extraFields}
     }
   }
 `
+  );
+}
+var EXPLORE_CATALOG_QUERY = exploreCatalogDocument(
+  EXPLORE_CATALOG_HIGHLIGHT_FIELD
 );
+var EXPLORE_CATALOG_QUERY_WITHOUT_HIGHLIGHTS = exploreCatalogDocument("");
 var EXPLORE_MESSAGE_QUERY = (
   /* GraphQL */
   `
@@ -667,7 +689,12 @@ function buildFallbackCatalog(examplePrompts, welcome) {
     welcomeBody: welcome?.body ?? FALLBACK_WELCOME_BODY,
     limits: FALLBACK_EXPLORE_LIMITS,
     captchaRequired: false,
-    recaptchaSiteKey: null
+    recaptchaSiteKey: null,
+    // Empty, and deliberately not synthesised from `ECOSYSTEM_PRODUCTS`: a concept highlight
+    // needs a real published illustration URL, and this SDK has no registry of them. An
+    // invented path would render 38 broken frames on the one screen every prerender captures.
+    // The strip renders nothing at all when the list is empty, which is the honest fallback.
+    conceptHighlights: []
   };
 }
 function normalizeCatalog(raw, fallback) {
@@ -684,9 +711,27 @@ function normalizeCatalog(raw, fallback) {
       historyTurns: raw.limits?.historyTurns || fallback.limits.historyTurns
     },
     captchaRequired: raw.captchaRequired === true,
-    recaptchaSiteKey: raw.recaptchaSiteKey ?? null
+    recaptchaSiteKey: raw.recaptchaSiteKey ?? null,
+    // `[ExploreConceptHighlight!]!` on the wire, so a gateway that KNOWS the field always
+    // sends an array. The one response that arrives without it is the retry against an older
+    // supergraph (`EXPLORE_CATALOG_QUERY_WITHOUT_HIGHLIGHTS`) — that gateway does not answer
+    // the full document at all, it refuses it. Either way
+    // `catalog.conceptHighlights.filter(...)` on `undefined` would throw inside render,
+    // blanking the welcome screen over a decorative strip.
+    conceptHighlights: raw.conceptHighlights?.length ? raw.conceptHighlights : fallback.conceptHighlights
   };
 }
+var CATALOG_DOCUMENT_REJECTED_CODES = /* @__PURE__ */ new Set([
+  "GRAPHQL_VALIDATION_FAILED",
+  "HTTP_400"
+]);
+function catalogRejectedTheHighlightField(res) {
+  if (res.data?.exploreCatalog) return false;
+  return (res.errors ?? []).some((error) => {
+    const code = error.extensions?.code;
+    return typeof code === "string" && CATALOG_DOCUMENT_REJECTED_CODES.has(code) || error.message.includes("conceptHighlights");
+  });
+}
 var RATE_LIMIT_CODES = /* @__PURE__ */ new Set([
   "RATE_LIMITED",
   "HTTP_429",
@@ -1026,11 +1071,19 @@ function useExploreChat(options = {}) {
   react.useEffect(() => {
     let cancelled = false;
     const load = async () => {
-      const res = await client.query(
+      const variables = { productSlug: productSlug ?? null };
+      let res = await client.query(
         EXPLORE_CATALOG_QUERY,
-        { productSlug: productSlug ?? null }
+        variables
       );
       if (cancelled || !mountedRef.current) return;
+      if (catalogRejectedTheHighlightField(res)) {
+        res = await client.query(
+          EXPLORE_CATALOG_QUERY_WITHOUT_HIGHLIGHTS,
+          variables
+        );
+        if (cancelled || !mountedRef.current) return;
+      }
       const raw = res.data?.exploreCatalog;
       if (res.errors?.length || !raw) {
         console.warn(