@burdenoff/website-sdk 2026.922.5 → 2026.923.2

package/dist/{use-progressive-reveal-Ha3gYPfs.d.mts → use-progressive-reveal-Cmy8bA7L.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-DvQPiL1t.mjs';
+import { b as ExploreLimits, c as ExploreCatalog, d as ExploreMessage, e as ExploreFeedbackRating, f as ExploreFeedbackReason } from './explore-types-B5sdOC5M.mjs';
 
 /** What travels on the wire — mirrors `ExploreAttachmentInput`. */
 interface ExploreAttachmentPayload {
@@ -34,6 +34,34 @@ interface ExploreChatError {
     /** Whether re-sending the same message could plausibly succeed. */
     retryable: boolean;
 }
+/**
+ * What came of handing the conversation to a person.
+ *
+ * `sent` and `already-handed-over` are BOTH successes. The second is the double-clicked
+ * button, the retried request and the reloaded page: the server keeps one handover per
+ * conversation, so a repeat submit returns the first one rather than filing a second ticket.
+ * A visitor who is worried enough to ask for a human must never be told "you already did
+ * that" — the conversation is with a person either way, and the UI says so either way.
+ */
+type ExploreEscalateOutcome = "sent" | "already-handed-over"
+/** The SERVER rejected the address (`INVALID_EMAIL`), after the client let it through. */
+ | "invalid-email" | "rate-limited" | "captcha"
+/** No conversation token — nothing to hand over. The form should not have been offered. */
+ | "no-conversation" | "failed";
+interface ExploreEscalateResult {
+    outcome: ExploreEscalateOutcome;
+    /**
+     * The address the SERVER says the reply is going to, on `sent` and `already-handed-over`;
+     * null otherwise.
+     *
+     * On `already-handed-over` this is the address the FIRST handover used, which may not be
+     * the one just typed — and it is the one the reply actually reaches, so it is the one to
+     * show back.
+     */
+    email: string | null;
+    /** When the handover was filed, as the server holds it. Null unless it exists. */
+    createdAt: string | null;
+}
 interface UseExploreChatOptions {
     /** Slug of the product site this page is on — a soft hint to the harness. */
     productSlug?: string;
@@ -116,6 +144,30 @@ interface UseExploreChatResult {
         reason?: ExploreFeedbackReason | null;
         comment?: string | null;
     }) => Promise<boolean>;
+    /**
+     * Hand this conversation to a person, so they pick it up with the transcript attached.
+     *
+     * Awaited, like {@link submitFeedback} and for the same reason — the visitor is watching
+     * the control they pressed — but this one has more to say than true/false: "we could not
+     * deliver to that address", "you are sending these too fast" and "it is already with a
+     * human" are three different things to a worried visitor, and one boolean flattens them
+     * into a shrug. It never throws; every outcome comes back in
+     * {@link ExploreEscalateResult}.
+     *
+     * `email` is personal data. It goes into the mutation variables and nowhere else — not
+     * into `messages` (which is what this hook persists), not into `onSend`, not into any
+     * analytics call.
+     */
+    escalate: (email: string, note?: string) => Promise<ExploreEscalateResult>;
+    /**
+     * Whether there is a conversation a person could actually be handed.
+     *
+     * False on a fresh page and false in a read-only shared view (a `?c=` secret is not a
+     * conversation token), which are exactly the cases where {@link escalate} could only
+     * answer `no-conversation`. Offer the form on this, rather than offering one that cannot
+     * work.
+     */
+    canEscalate: boolean;
     /**
      * Mint a read-only link to this conversation, or null when there is nothing to share yet.
      * The secret returned is not the conversation token and cannot continue the thread.
@@ -141,11 +193,6 @@ declare const FALLBACK_EXPLORE_LIMITS: ExploreLimits;
  * brochure without a single copy change being reviewed.
  */
 declare const DEFAULT_EXPLORE_EXAMPLE_PROMPTS: string[];
-/**
- * Map a `extensions.code` (or a client-side transport code) onto the bucket the
- * UI renders. Unknown codes are treated as retryable — a transient backend
- * condition we have not enumerated is far more likely than a permanent one.
- */
 declare function classifyExploreError(code: string | null | undefined, serverMessage?: string | null): ExploreChatError;
 /** One past conversation, as shown in the history list and restored on click. */
 interface ArchivedExploreConversation {
@@ -194,4 +241,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 UseExploreChatResult as c, type UseSpeechOutputOptions as d, type UseSpeechOutputResult as e, classifyExploreError as f, useProgressiveReveal as g, useSpeechOutput as h, stopSpeaking as s, useExploreChat as u };
+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 };

package/dist/{use-progressive-reveal-BfU_IHip.d.ts → use-progressive-reveal-DHPGGxZu.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-DvQPiL1t.js';
+import { b as ExploreLimits, c as ExploreCatalog, d as ExploreMessage, e as ExploreFeedbackRating, f as ExploreFeedbackReason } from './explore-types-B5sdOC5M.js';
 
 /** What travels on the wire — mirrors `ExploreAttachmentInput`. */
 interface ExploreAttachmentPayload {
@@ -34,6 +34,34 @@ interface ExploreChatError {
     /** Whether re-sending the same message could plausibly succeed. */
     retryable: boolean;
 }
+/**
+ * What came of handing the conversation to a person.
+ *
+ * `sent` and `already-handed-over` are BOTH successes. The second is the double-clicked
+ * button, the retried request and the reloaded page: the server keeps one handover per
+ * conversation, so a repeat submit returns the first one rather than filing a second ticket.
+ * A visitor who is worried enough to ask for a human must never be told "you already did
+ * that" — the conversation is with a person either way, and the UI says so either way.
+ */
+type ExploreEscalateOutcome = "sent" | "already-handed-over"
+/** The SERVER rejected the address (`INVALID_EMAIL`), after the client let it through. */
+ | "invalid-email" | "rate-limited" | "captcha"
+/** No conversation token — nothing to hand over. The form should not have been offered. */
+ | "no-conversation" | "failed";
+interface ExploreEscalateResult {
+    outcome: ExploreEscalateOutcome;
+    /**
+     * The address the SERVER says the reply is going to, on `sent` and `already-handed-over`;
+     * null otherwise.
+     *
+     * On `already-handed-over` this is the address the FIRST handover used, which may not be
+     * the one just typed — and it is the one the reply actually reaches, so it is the one to
+     * show back.
+     */
+    email: string | null;
+    /** When the handover was filed, as the server holds it. Null unless it exists. */
+    createdAt: string | null;
+}
 interface UseExploreChatOptions {
     /** Slug of the product site this page is on — a soft hint to the harness. */
     productSlug?: string;
@@ -116,6 +144,30 @@ interface UseExploreChatResult {
         reason?: ExploreFeedbackReason | null;
         comment?: string | null;
     }) => Promise<boolean>;
+    /**
+     * Hand this conversation to a person, so they pick it up with the transcript attached.
+     *
+     * Awaited, like {@link submitFeedback} and for the same reason — the visitor is watching
+     * the control they pressed — but this one has more to say than true/false: "we could not
+     * deliver to that address", "you are sending these too fast" and "it is already with a
+     * human" are three different things to a worried visitor, and one boolean flattens them
+     * into a shrug. It never throws; every outcome comes back in
+     * {@link ExploreEscalateResult}.
+     *
+     * `email` is personal data. It goes into the mutation variables and nowhere else — not
+     * into `messages` (which is what this hook persists), not into `onSend`, not into any
+     * analytics call.
+     */
+    escalate: (email: string, note?: string) => Promise<ExploreEscalateResult>;
+    /**
+     * Whether there is a conversation a person could actually be handed.
+     *
+     * False on a fresh page and false in a read-only shared view (a `?c=` secret is not a
+     * conversation token), which are exactly the cases where {@link escalate} could only
+     * answer `no-conversation`. Offer the form on this, rather than offering one that cannot
+     * work.
+     */
+    canEscalate: boolean;
     /**
      * Mint a read-only link to this conversation, or null when there is nothing to share yet.
      * The secret returned is not the conversation token and cannot continue the thread.
@@ -141,11 +193,6 @@ declare const FALLBACK_EXPLORE_LIMITS: ExploreLimits;
  * brochure without a single copy change being reviewed.
  */
 declare const DEFAULT_EXPLORE_EXAMPLE_PROMPTS: string[];
-/**
- * Map a `extensions.code` (or a client-side transport code) onto the bucket the
- * UI renders. Unknown codes are treated as retryable — a transient backend
- * condition we have not enumerated is far more likely than a permanent one.
- */
 declare function classifyExploreError(code: string | null | undefined, serverMessage?: string | null): ExploreChatError;
 /** One past conversation, as shown in the history list and restored on click. */
 interface ArchivedExploreConversation {
@@ -194,4 +241,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 UseExploreChatResult as c, type UseSpeechOutputOptions as d, type UseSpeechOutputResult as e, classifyExploreError as f, useProgressiveReveal as g, useSpeechOutput as h, stopSpeaking as s, useExploreChat as u };
+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 };

package/dist/utils/index.d.mts

@@ -66,4 +66,58 @@ declare function loadRecaptchaV3(siteKey: string): Promise<RecaptchaV3>;
  */
 declare function getRecaptchaV3Token(siteKey: string, action?: string): Promise<string>;
 
-export { EXPLORE_RECAPTCHA_ACTION, type RecaptchaV3, cn, getRecaptchaV3Token, loadRecaptchaV3 };
+/**
+ * Which routes a host site should render WITHOUT its marketing footer.
+ *
+ * ## Why this lives in the SDK
+ *
+ * It was written 39 times. The footer belongs to each website, so the obvious
+ * place for the rule is each website — and eight agents asked to add it produced
+ * five different helpers (`footerless-routes.ts`, `footer-visibility.ts`,
+ * `footer-routes.ts`, `explore-route.ts`, plus six copies inlined straight into
+ * a layout). All five behave the same today. The next person to change the rule
+ * has to find all five, and will not.
+ *
+ * The rule is really a property of the SDK's own surfaces: `/explore` is
+ * footerless because `ExplorePage` sizes itself to one viewport, which is a fact
+ * about this package, not about any site. So it is declared here, once, and the
+ * sites ask.
+ *
+ * ## Why `/explore` and nothing else
+ *
+ * `ExplorePage` renders a full-viewport chat pane (`100dvh` minus the site
+ * chrome above it), so anything after it is below the fold by construction. On a
+ * phone these footers are 1100-1330px — roughly 70% of the document — and that
+ * bulk is what allowed a restored scroll offset to open the page on nothing but
+ * footer, with zero pixels of the chat on screen.
+ *
+ * The SDK's OTHER pages are the opposite case and must keep their footer:
+ * `/concepts`, `/concept/:slug`, `/answers` and `/answer/:slug` are ordinary
+ * indexed content pages whose footer carries the site's internal links.
+ * Stripping it would cost hundreds of pages their internal linking, and nobody
+ * would notice for weeks.
+ */
+/** Routes that render without the site footer. Exact paths, not prefixes. */
+declare const FOOTERLESS_ROUTES: readonly string[];
+/**
+ * Normalise a router pathname for exact comparison.
+ *
+ * React Router matches case-insensitively (`caseSensitive` defaults to false)
+ * and tolerates a trailing slash, so `/Explore/` reaches the same route element
+ * as `/explore` and has to be treated the same way here. Half the fleet's
+ * hand-written versions compared case-sensitively and would have rendered a
+ * footer under the chat pane on `/Explore`.
+ */
+declare function normalizeRoutePath(pathname: string): string;
+/**
+ * True when this pathname is one of the SDK's full-screen surfaces.
+ *
+ * Deliberately an exact-set test. `startsWith("/explore")` would also swallow a
+ * future `/explore-beta`, and `includes("explore")` would swallow far more —
+ * including `/concept/explore-your-data`, which is a real shape of concept slug.
+ */
+declare function isFooterlessPath(pathname: string): boolean;
+/** Inverse of {@link isFooterlessPath}, for layouts that read better positively. */
+declare function shouldRenderSiteFooter(pathname: string): boolean;
+
+export { EXPLORE_RECAPTCHA_ACTION, FOOTERLESS_ROUTES, type RecaptchaV3, cn, getRecaptchaV3Token, isFooterlessPath, loadRecaptchaV3, normalizeRoutePath, shouldRenderSiteFooter };

package/dist/utils/index.d.ts

@@ -66,4 +66,58 @@ declare function loadRecaptchaV3(siteKey: string): Promise<RecaptchaV3>;
  */
 declare function getRecaptchaV3Token(siteKey: string, action?: string): Promise<string>;
 
-export { EXPLORE_RECAPTCHA_ACTION, type RecaptchaV3, cn, getRecaptchaV3Token, loadRecaptchaV3 };
+/**
+ * Which routes a host site should render WITHOUT its marketing footer.
+ *
+ * ## Why this lives in the SDK
+ *
+ * It was written 39 times. The footer belongs to each website, so the obvious
+ * place for the rule is each website — and eight agents asked to add it produced
+ * five different helpers (`footerless-routes.ts`, `footer-visibility.ts`,
+ * `footer-routes.ts`, `explore-route.ts`, plus six copies inlined straight into
+ * a layout). All five behave the same today. The next person to change the rule
+ * has to find all five, and will not.
+ *
+ * The rule is really a property of the SDK's own surfaces: `/explore` is
+ * footerless because `ExplorePage` sizes itself to one viewport, which is a fact
+ * about this package, not about any site. So it is declared here, once, and the
+ * sites ask.
+ *
+ * ## Why `/explore` and nothing else
+ *
+ * `ExplorePage` renders a full-viewport chat pane (`100dvh` minus the site
+ * chrome above it), so anything after it is below the fold by construction. On a
+ * phone these footers are 1100-1330px — roughly 70% of the document — and that
+ * bulk is what allowed a restored scroll offset to open the page on nothing but
+ * footer, with zero pixels of the chat on screen.
+ *
+ * The SDK's OTHER pages are the opposite case and must keep their footer:
+ * `/concepts`, `/concept/:slug`, `/answers` and `/answer/:slug` are ordinary
+ * indexed content pages whose footer carries the site's internal links.
+ * Stripping it would cost hundreds of pages their internal linking, and nobody
+ * would notice for weeks.
+ */
+/** Routes that render without the site footer. Exact paths, not prefixes. */
+declare const FOOTERLESS_ROUTES: readonly string[];
+/**
+ * Normalise a router pathname for exact comparison.
+ *
+ * React Router matches case-insensitively (`caseSensitive` defaults to false)
+ * and tolerates a trailing slash, so `/Explore/` reaches the same route element
+ * as `/explore` and has to be treated the same way here. Half the fleet's
+ * hand-written versions compared case-sensitively and would have rendered a
+ * footer under the chat pane on `/Explore`.
+ */
+declare function normalizeRoutePath(pathname: string): string;
+/**
+ * True when this pathname is one of the SDK's full-screen surfaces.
+ *
+ * Deliberately an exact-set test. `startsWith("/explore")` would also swallow a
+ * future `/explore-beta`, and `includes("explore")` would swallow far more —
+ * including `/concept/explore-your-data`, which is a real shape of concept slug.
+ */
+declare function isFooterlessPath(pathname: string): boolean;
+/** Inverse of {@link isFooterlessPath}, for layouts that read better positively. */
+declare function shouldRenderSiteFooter(pathname: string): boolean;
+
+export { EXPLORE_RECAPTCHA_ACTION, FOOTERLESS_ROUTES, type RecaptchaV3, cn, getRecaptchaV3Token, isFooterlessPath, loadRecaptchaV3, normalizeRoutePath, shouldRenderSiteFooter };

package/dist/utils/index.js

@@ -74,9 +74,26 @@ async function getRecaptchaV3Token(siteKey, action = EXPLORE_RECAPTCHA_ACTION) {
   return api.execute(siteKey, { action });
 }
 
+// src/utils/site-chrome.ts
+var FOOTERLESS_ROUTES = ["/explore"];
+function normalizeRoutePath(pathname) {
+  const trimmed = pathname.toLowerCase().replace(/\/+$/, "");
+  return trimmed === "" ? "/" : trimmed;
+}
+function isFooterlessPath(pathname) {
+  return FOOTERLESS_ROUTES.includes(normalizeRoutePath(pathname));
+}
+function shouldRenderSiteFooter(pathname) {
+  return !isFooterlessPath(pathname);
+}
+
 exports.EXPLORE_RECAPTCHA_ACTION = EXPLORE_RECAPTCHA_ACTION;
+exports.FOOTERLESS_ROUTES = FOOTERLESS_ROUTES;
 exports.cn = cn;
 exports.getRecaptchaV3Token = getRecaptchaV3Token;
+exports.isFooterlessPath = isFooterlessPath;
 exports.loadRecaptchaV3 = loadRecaptchaV3;
+exports.normalizeRoutePath = normalizeRoutePath;
+exports.shouldRenderSiteFooter = shouldRenderSiteFooter;
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/cn.ts","../../src/utils/recaptcha-v3.ts"],"names":["twMerge","clsx"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Utility function to merge Tailwind CSS classes\n * Combines clsx and tailwind-merge for optimal class handling\n */\n\nimport { type ClassValue, clsx } from \"clsx\";\nimport { twMerge } from \"tailwind-merge\";\n\n/**\n * Merge multiple class names intelligently\n * - Handles conditional classes via clsx\n * - Deduplicates and resolves Tailwind conflicts via tailwind-merge\n *\n * @example\n * ```ts\n * cn('px-4 py-2', 'bg-blue-500', { 'text-white': isActive })\n * // => 'px-4 py-2 bg-blue-500 text-white' (if isActive is true)\n * ```\n */\nexport function cn(...inputs: ClassValue[]): string {\n  return twMerge(clsx(inputs));\n}\n","/**\n * reCAPTCHA v3 (invisible, score-based) loader and token minter.\n *\n * Deliberately dependency-free: the SDK already ships the `react-google-recaptcha`\n * peer for the **v2 checkbox** used by `ContactPage`, and the two widgets cannot\n * share a script tag — v3 needs `?render=<siteKey>` on the URL, v2 must not have\n * it. This module injects its own v3 script and leaves the v2 integration alone.\n *\n * The Explore chat turns v3 on purely from the backend catalog\n * (`exploreCatalog.captchaRequired && recaptchaSiteKey`), so nothing is loaded\n * and no third-party request is made on sites where captcha is off.\n */\n\n/** The slice of the `grecaptcha` global this module uses. */\nexport interface RecaptchaV3 {\n  /** Runs the callback once the API is fully initialised. */\n  ready(callback: () => void): void;\n  /** Mints a single-use token for `action`. */\n  execute(siteKey: string, options: { action: string }): Promise<string>;\n}\n\ndeclare global {\n  interface Window {\n    grecaptcha?: RecaptchaV3;\n  }\n}\n\nconst SCRIPT_ID = \"boff-recaptcha-v3\";\nconst SCRIPT_SRC = \"https://www.google.com/recaptcha/api.js?render=\";\n\n/** Default action name reported to reCAPTCHA for Explore chat submissions. */\nexport const EXPLORE_RECAPTCHA_ACTION = \"explore_chat\";\n\n/**\n * One in-flight/settled promise per site key. Guarantees the script tag is\n * injected at most once even when several components mount at the same time,\n * and lets later callers await the same load instead of racing it.\n */\nconst loaders = new Map<string, Promise<RecaptchaV3>>();\n\nfunction isBrowser(): boolean {\n  return typeof window !== \"undefined\" && typeof document !== \"undefined\";\n}\n\n/**\n * Load the reCAPTCHA v3 script for `siteKey` and resolve once `grecaptcha` is\n * ready to mint tokens.\n *\n * - Injects the script at most once per site key (subsequent calls reuse the\n *   same promise).\n * - Adopts an already-present script tag (e.g. injected by the host site)\n *   rather than adding a second one.\n * - Rejects rather than hanging when the script fails to load, so the caller\n *   can decide whether to submit without a token or surface an error.\n */\nexport function loadRecaptchaV3(siteKey: string): Promise<RecaptchaV3> {\n  if (!siteKey) {\n    return Promise.reject(new Error(\"reCAPTCHA site key is required\"));\n  }\n  if (!isBrowser()) {\n    return Promise.reject(\n      new Error(\"reCAPTCHA v3 can only be loaded in a browser\"),\n    );\n  }\n\n  const existing = loaders.get(siteKey);\n  if (existing) return existing;\n\n  const promise = new Promise<RecaptchaV3>((resolve, reject) => {\n    const ready = () => {\n      const api = window.grecaptcha;\n      if (!api) {\n        reject(new Error(\"reCAPTCHA loaded but grecaptcha is unavailable\"));\n        return;\n      }\n      // `ready` queues until the API has finished initialising internally;\n      // calling `execute` before that throws.\n      api.ready(() => resolve(api));\n    };\n\n    // Already loaded by this module, another SDK instance, or the host site.\n    if (window.grecaptcha) {\n      ready();\n      return;\n    }\n\n    const scriptId = `${SCRIPT_ID}-${siteKey}`;\n    const found = document.getElementById(scriptId);\n    if (found) {\n      found.addEventListener(\"load\", ready, { once: true });\n      found.addEventListener(\n        \"error\",\n        () => reject(new Error(\"Failed to load reCAPTCHA v3\")),\n        { once: true },\n      );\n      return;\n    }\n\n    const script = document.createElement(\"script\");\n    script.id = scriptId;\n    script.src = `${SCRIPT_SRC}${encodeURIComponent(siteKey)}`;\n    script.async = true;\n    script.defer = true;\n    script.addEventListener(\"load\", ready, { once: true });\n    script.addEventListener(\n      \"error\",\n      () => {\n        // Drop the memo so a later attempt can retry a transient CDN failure\n        // instead of being stuck with a permanently rejected promise.\n        loaders.delete(siteKey);\n        reject(new Error(\"Failed to load reCAPTCHA v3\"));\n      },\n      { once: true },\n    );\n    document.head.appendChild(script);\n  });\n\n  loaders.set(siteKey, promise);\n  return promise;\n}\n\n/**\n * Mint a single-use reCAPTCHA v3 token, loading the script on first use.\n *\n * Tokens are valid for ~2 minutes and are consumed by one verification, so\n * this must be called per submission — never cached.\n */\nexport async function getRecaptchaV3Token(\n  siteKey: string,\n  action: string = EXPLORE_RECAPTCHA_ACTION,\n): Promise<string> {\n  const api = await loadRecaptchaV3(siteKey);\n  return api.execute(siteKey, { action });\n}\n"]}
+{"version":3,"sources":["../../src/utils/cn.ts","../../src/utils/recaptcha-v3.ts","../../src/utils/site-chrome.ts"],"names":["twMerge","clsx"],"mappings":";;;;;AAmBO,SAAS,MAAM,MAAA,EAA8B;AAClD,EAAA,OAAOA,qBAAA,CAAQC,SAAA,CAAK,MAAM,CAAC,CAAA;AAC7B;;;ACMA,IAAM,SAAA,GAAY,mBAAA;AAClB,IAAM,UAAA,GAAa,iDAAA;AAGZ,IAAM,wBAAA,GAA2B;AAOxC,IAAM,OAAA,uBAAc,GAAA,EAAkC;AAEtD,SAAS,SAAA,GAAqB;AAC5B,EAAA,OAAO,OAAO,MAAA,KAAW,WAAA,IAAe,OAAO,QAAA,KAAa,WAAA;AAC9D;AAaO,SAAS,gBAAgB,OAAA,EAAuC;AACrE,EAAA,IAAI,CAAC,OAAA,EAAS;AACZ,IAAA,OAAO,OAAA,CAAQ,MAAA,CAAO,IAAI,KAAA,CAAM,gCAAgC,CAAC,CAAA;AAAA,EACnE;AACA,EAAA,IAAI,CAAC,WAAU,EAAG;AAChB,IAAA,OAAO,OAAA,CAAQ,MAAA;AAAA,MACb,IAAI,MAAM,8CAA8C;AAAA,KAC1D;AAAA,EACF;AAEA,EAAA,MAAM,QAAA,GAAW,OAAA,CAAQ,GAAA,CAAI,OAAO,CAAA;AACpC,EAAA,IAAI,UAAU,OAAO,QAAA;AAErB,EAAA,MAAM,OAAA,GAAU,IAAI,OAAA,CAAqB,CAAC,SAAS,MAAA,KAAW;AAC5D,IAAA,MAAM,QAAQ,MAAM;AAClB,MAAA,MAAM,MAAM,MAAA,CAAO,UAAA;AACnB,MAAA,IAAI,CAAC,GAAA,EAAK;AACR,QAAA,MAAA,CAAO,IAAI,KAAA,CAAM,gDAAgD,CAAC,CAAA;AAClE,QAAA;AAAA,MACF;AAGA,MAAA,GAAA,CAAI,KAAA,CAAM,MAAM,OAAA,CAAQ,GAAG,CAAC,CAAA;AAAA,IAC9B,CAAA;AAGA,IAAA,IAAI,OAAO,UAAA,EAAY;AACrB,MAAA,KAAA,EAAM;AACN,MAAA;AAAA,IACF;AAEA,IAAA,MAAM,QAAA,GAAW,CAAA,EAAG,SAAS,CAAA,CAAA,EAAI,OAAO,CAAA,CAAA;AACxC,IAAA,MAAM,KAAA,GAAQ,QAAA,CAAS,cAAA,CAAe,QAAQ,CAAA;AAC9C,IAAA,IAAI,KAAA,EAAO;AACT,MAAA,KAAA,CAAM,iBAAiB,MAAA,EAAQ,KAAA,EAAO,EAAE,IAAA,EAAM,MAAM,CAAA;AACpD,MAAA,KAAA,CAAM,gBAAA;AAAA,QACJ,OAAA;AAAA,QACA,MAAM,MAAA,CAAO,IAAI,KAAA,CAAM,6BAA6B,CAAC,CAAA;AAAA,QACrD,EAAE,MAAM,IAAA;AAAK,OACf;AACA,MAAA;AAAA,IACF;AAEA,IAAA,MAAM,MAAA,GAAS,QAAA,CAAS,aAAA,CAAc,QAAQ,CAAA;AAC9C,IAAA,MAAA,CAAO,EAAA,GAAK,QAAA;AACZ,IAAA,MAAA,CAAO,MAAM,CAAA,EAAG,UAAU,CAAA,EAAG,kBAAA,CAAmB,OAAO,CAAC,CAAA,CAAA;AACxD,IAAA,MAAA,CAAO,KAAA,GAAQ,IAAA;AACf,IAAA,MAAA,CAAO,KAAA,GAAQ,IAAA;AACf,IAAA,MAAA,CAAO,iBAAiB,MAAA,EAAQ,KAAA,EAAO,EAAE,IAAA,EAAM,MAAM,CAAA;AACrD,IAAA,MAAA,CAAO,gBAAA;AAAA,MACL,OAAA;AAAA,MACA,MAAM;AAGJ,QAAA,OAAA,CAAQ,OAAO,OAAO,CAAA;AACtB,QAAA,MAAA,CAAO,IAAI,KAAA,CAAM,6BAA6B,CAAC,CAAA;AAAA,MACjD,CAAA;AAAA,MACA,EAAE,MAAM,IAAA;AAAK,KACf;AACA,IAAA,QAAA,CAAS,IAAA,CAAK,YAAY,MAAM,CAAA;AAAA,EAClC,CAAC,CAAA;AAED,EAAA,OAAA,CAAQ,GAAA,CAAI,SAAS,OAAO,CAAA;AAC5B,EAAA,OAAO,OAAA;AACT;AAQA,eAAsB,mBAAA,CACpB,OAAA,EACA,MAAA,GAAiB,wBAAA,EACA;AACjB,EAAA,MAAM,GAAA,GAAM,MAAM,eAAA,CAAgB,OAAO,CAAA;AACzC,EAAA,OAAO,GAAA,CAAI,OAAA,CAAQ,OAAA,EAAS,EAAE,QAAQ,CAAA;AACxC;;;ACpGO,IAAM,iBAAA,GAAuC,CAAC,UAAU;AAWxD,SAAS,mBAAmB,QAAA,EAA0B;AAC3D,EAAA,MAAM,UAAU,QAAA,CAAS,WAAA,EAAY,CAAE,OAAA,CAAQ,QAAQ,EAAE,CAAA;AACzD,EAAA,OAAO,OAAA,KAAY,KAAK,GAAA,GAAM,OAAA;AAChC;AASO,SAAS,iBAAiB,QAAA,EAA2B;AAC1D,EAAA,OAAO,iBAAA,CAAkB,QAAA,CAAS,kBAAA,CAAmB,QAAQ,CAAC,CAAA;AAChE;AAGO,SAAS,uBAAuB,QAAA,EAA2B;AAChE,EAAA,OAAO,CAAC,iBAAiB,QAAQ,CAAA;AACnC","file":"index.js","sourcesContent":["/**\n * Utility function to merge Tailwind CSS classes\n * Combines clsx and tailwind-merge for optimal class handling\n */\n\nimport { type ClassValue, clsx } from \"clsx\";\nimport { twMerge } from \"tailwind-merge\";\n\n/**\n * Merge multiple class names intelligently\n * - Handles conditional classes via clsx\n * - Deduplicates and resolves Tailwind conflicts via tailwind-merge\n *\n * @example\n * ```ts\n * cn('px-4 py-2', 'bg-blue-500', { 'text-white': isActive })\n * // => 'px-4 py-2 bg-blue-500 text-white' (if isActive is true)\n * ```\n */\nexport function cn(...inputs: ClassValue[]): string {\n  return twMerge(clsx(inputs));\n}\n","/**\n * reCAPTCHA v3 (invisible, score-based) loader and token minter.\n *\n * Deliberately dependency-free: the SDK already ships the `react-google-recaptcha`\n * peer for the **v2 checkbox** used by `ContactPage`, and the two widgets cannot\n * share a script tag — v3 needs `?render=<siteKey>` on the URL, v2 must not have\n * it. This module injects its own v3 script and leaves the v2 integration alone.\n *\n * The Explore chat turns v3 on purely from the backend catalog\n * (`exploreCatalog.captchaRequired && recaptchaSiteKey`), so nothing is loaded\n * and no third-party request is made on sites where captcha is off.\n */\n\n/** The slice of the `grecaptcha` global this module uses. */\nexport interface RecaptchaV3 {\n  /** Runs the callback once the API is fully initialised. */\n  ready(callback: () => void): void;\n  /** Mints a single-use token for `action`. */\n  execute(siteKey: string, options: { action: string }): Promise<string>;\n}\n\ndeclare global {\n  interface Window {\n    grecaptcha?: RecaptchaV3;\n  }\n}\n\nconst SCRIPT_ID = \"boff-recaptcha-v3\";\nconst SCRIPT_SRC = \"https://www.google.com/recaptcha/api.js?render=\";\n\n/** Default action name reported to reCAPTCHA for Explore chat submissions. */\nexport const EXPLORE_RECAPTCHA_ACTION = \"explore_chat\";\n\n/**\n * One in-flight/settled promise per site key. Guarantees the script tag is\n * injected at most once even when several components mount at the same time,\n * and lets later callers await the same load instead of racing it.\n */\nconst loaders = new Map<string, Promise<RecaptchaV3>>();\n\nfunction isBrowser(): boolean {\n  return typeof window !== \"undefined\" && typeof document !== \"undefined\";\n}\n\n/**\n * Load the reCAPTCHA v3 script for `siteKey` and resolve once `grecaptcha` is\n * ready to mint tokens.\n *\n * - Injects the script at most once per site key (subsequent calls reuse the\n *   same promise).\n * - Adopts an already-present script tag (e.g. injected by the host site)\n *   rather than adding a second one.\n * - Rejects rather than hanging when the script fails to load, so the caller\n *   can decide whether to submit without a token or surface an error.\n */\nexport function loadRecaptchaV3(siteKey: string): Promise<RecaptchaV3> {\n  if (!siteKey) {\n    return Promise.reject(new Error(\"reCAPTCHA site key is required\"));\n  }\n  if (!isBrowser()) {\n    return Promise.reject(\n      new Error(\"reCAPTCHA v3 can only be loaded in a browser\"),\n    );\n  }\n\n  const existing = loaders.get(siteKey);\n  if (existing) return existing;\n\n  const promise = new Promise<RecaptchaV3>((resolve, reject) => {\n    const ready = () => {\n      const api = window.grecaptcha;\n      if (!api) {\n        reject(new Error(\"reCAPTCHA loaded but grecaptcha is unavailable\"));\n        return;\n      }\n      // `ready` queues until the API has finished initialising internally;\n      // calling `execute` before that throws.\n      api.ready(() => resolve(api));\n    };\n\n    // Already loaded by this module, another SDK instance, or the host site.\n    if (window.grecaptcha) {\n      ready();\n      return;\n    }\n\n    const scriptId = `${SCRIPT_ID}-${siteKey}`;\n    const found = document.getElementById(scriptId);\n    if (found) {\n      found.addEventListener(\"load\", ready, { once: true });\n      found.addEventListener(\n        \"error\",\n        () => reject(new Error(\"Failed to load reCAPTCHA v3\")),\n        { once: true },\n      );\n      return;\n    }\n\n    const script = document.createElement(\"script\");\n    script.id = scriptId;\n    script.src = `${SCRIPT_SRC}${encodeURIComponent(siteKey)}`;\n    script.async = true;\n    script.defer = true;\n    script.addEventListener(\"load\", ready, { once: true });\n    script.addEventListener(\n      \"error\",\n      () => {\n        // Drop the memo so a later attempt can retry a transient CDN failure\n        // instead of being stuck with a permanently rejected promise.\n        loaders.delete(siteKey);\n        reject(new Error(\"Failed to load reCAPTCHA v3\"));\n      },\n      { once: true },\n    );\n    document.head.appendChild(script);\n  });\n\n  loaders.set(siteKey, promise);\n  return promise;\n}\n\n/**\n * Mint a single-use reCAPTCHA v3 token, loading the script on first use.\n *\n * Tokens are valid for ~2 minutes and are consumed by one verification, so\n * this must be called per submission — never cached.\n */\nexport async function getRecaptchaV3Token(\n  siteKey: string,\n  action: string = EXPLORE_RECAPTCHA_ACTION,\n): Promise<string> {\n  const api = await loadRecaptchaV3(siteKey);\n  return api.execute(siteKey, { action });\n}\n","/**\n * Which routes a host site should render WITHOUT its marketing footer.\n *\n * ## Why this lives in the SDK\n *\n * It was written 39 times. The footer belongs to each website, so the obvious\n * place for the rule is each website — and eight agents asked to add it produced\n * five different helpers (`footerless-routes.ts`, `footer-visibility.ts`,\n * `footer-routes.ts`, `explore-route.ts`, plus six copies inlined straight into\n * a layout). All five behave the same today. The next person to change the rule\n * has to find all five, and will not.\n *\n * The rule is really a property of the SDK's own surfaces: `/explore` is\n * footerless because `ExplorePage` sizes itself to one viewport, which is a fact\n * about this package, not about any site. So it is declared here, once, and the\n * sites ask.\n *\n * ## Why `/explore` and nothing else\n *\n * `ExplorePage` renders a full-viewport chat pane (`100dvh` minus the site\n * chrome above it), so anything after it is below the fold by construction. On a\n * phone these footers are 1100-1330px — roughly 70% of the document — and that\n * bulk is what allowed a restored scroll offset to open the page on nothing but\n * footer, with zero pixels of the chat on screen.\n *\n * The SDK's OTHER pages are the opposite case and must keep their footer:\n * `/concepts`, `/concept/:slug`, `/answers` and `/answer/:slug` are ordinary\n * indexed content pages whose footer carries the site's internal links.\n * Stripping it would cost hundreds of pages their internal linking, and nobody\n * would notice for weeks.\n */\n\n/** Routes that render without the site footer. Exact paths, not prefixes. */\nexport const FOOTERLESS_ROUTES: readonly string[] = [\"/explore\"];\n\n/**\n * Normalise a router pathname for exact comparison.\n *\n * React Router matches case-insensitively (`caseSensitive` defaults to false)\n * and tolerates a trailing slash, so `/Explore/` reaches the same route element\n * as `/explore` and has to be treated the same way here. Half the fleet's\n * hand-written versions compared case-sensitively and would have rendered a\n * footer under the chat pane on `/Explore`.\n */\nexport function normalizeRoutePath(pathname: string): string {\n  const trimmed = pathname.toLowerCase().replace(/\\/+$/, \"\");\n  return trimmed === \"\" ? \"/\" : trimmed;\n}\n\n/**\n * True when this pathname is one of the SDK's full-screen surfaces.\n *\n * Deliberately an exact-set test. `startsWith(\"/explore\")` would also swallow a\n * future `/explore-beta`, and `includes(\"explore\")` would swallow far more —\n * including `/concept/explore-your-data`, which is a real shape of concept slug.\n */\nexport function isFooterlessPath(pathname: string): boolean {\n  return FOOTERLESS_ROUTES.includes(normalizeRoutePath(pathname));\n}\n\n/** Inverse of {@link isFooterlessPath}, for layouts that read better positively. */\nexport function shouldRenderSiteFooter(pathname: string): boolean {\n  return !isFooterlessPath(pathname);\n}\n"]}

package/dist/utils/index.mjs

@@ -72,6 +72,19 @@ async function getRecaptchaV3Token(siteKey, action = EXPLORE_RECAPTCHA_ACTION) {
   return api.execute(siteKey, { action });
 }
 
-export { EXPLORE_RECAPTCHA_ACTION, cn, getRecaptchaV3Token, loadRecaptchaV3 };
+// src/utils/site-chrome.ts
+var FOOTERLESS_ROUTES = ["/explore"];
+function normalizeRoutePath(pathname) {
+  const trimmed = pathname.toLowerCase().replace(/\/+$/, "");
+  return trimmed === "" ? "/" : trimmed;
+}
+function isFooterlessPath(pathname) {
+  return FOOTERLESS_ROUTES.includes(normalizeRoutePath(pathname));
+}
+function shouldRenderSiteFooter(pathname) {
+  return !isFooterlessPath(pathname);
+}
+
+export { EXPLORE_RECAPTCHA_ACTION, FOOTERLESS_ROUTES, cn, getRecaptchaV3Token, isFooterlessPath, loadRecaptchaV3, normalizeRoutePath, shouldRenderSiteFooter };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/utils/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/cn.ts","../../src/utils/recaptcha-v3.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * Utility function to merge Tailwind CSS classes\n * Combines clsx and tailwind-merge for optimal class handling\n */\n\nimport { type ClassValue, clsx } from \"clsx\";\nimport { twMerge } from \"tailwind-merge\";\n\n/**\n * Merge multiple class names intelligently\n * - Handles conditional classes via clsx\n * - Deduplicates and resolves Tailwind conflicts via tailwind-merge\n *\n * @example\n * ```ts\n * cn('px-4 py-2', 'bg-blue-500', { 'text-white': isActive })\n * // => 'px-4 py-2 bg-blue-500 text-white' (if isActive is true)\n * ```\n */\nexport function cn(...inputs: ClassValue[]): string {\n  return twMerge(clsx(inputs));\n}\n","/**\n * reCAPTCHA v3 (invisible, score-based) loader and token minter.\n *\n * Deliberately dependency-free: the SDK already ships the `react-google-recaptcha`\n * peer for the **v2 checkbox** used by `ContactPage`, and the two widgets cannot\n * share a script tag — v3 needs `?render=<siteKey>` on the URL, v2 must not have\n * it. This module injects its own v3 script and leaves the v2 integration alone.\n *\n * The Explore chat turns v3 on purely from the backend catalog\n * (`exploreCatalog.captchaRequired && recaptchaSiteKey`), so nothing is loaded\n * and no third-party request is made on sites where captcha is off.\n */\n\n/** The slice of the `grecaptcha` global this module uses. */\nexport interface RecaptchaV3 {\n  /** Runs the callback once the API is fully initialised. */\n  ready(callback: () => void): void;\n  /** Mints a single-use token for `action`. */\n  execute(siteKey: string, options: { action: string }): Promise<string>;\n}\n\ndeclare global {\n  interface Window {\n    grecaptcha?: RecaptchaV3;\n  }\n}\n\nconst SCRIPT_ID = \"boff-recaptcha-v3\";\nconst SCRIPT_SRC = \"https://www.google.com/recaptcha/api.js?render=\";\n\n/** Default action name reported to reCAPTCHA for Explore chat submissions. */\nexport const EXPLORE_RECAPTCHA_ACTION = \"explore_chat\";\n\n/**\n * One in-flight/settled promise per site key. Guarantees the script tag is\n * injected at most once even when several components mount at the same time,\n * and lets later callers await the same load instead of racing it.\n */\nconst loaders = new Map<string, Promise<RecaptchaV3>>();\n\nfunction isBrowser(): boolean {\n  return typeof window !== \"undefined\" && typeof document !== \"undefined\";\n}\n\n/**\n * Load the reCAPTCHA v3 script for `siteKey` and resolve once `grecaptcha` is\n * ready to mint tokens.\n *\n * - Injects the script at most once per site key (subsequent calls reuse the\n *   same promise).\n * - Adopts an already-present script tag (e.g. injected by the host site)\n *   rather than adding a second one.\n * - Rejects rather than hanging when the script fails to load, so the caller\n *   can decide whether to submit without a token or surface an error.\n */\nexport function loadRecaptchaV3(siteKey: string): Promise<RecaptchaV3> {\n  if (!siteKey) {\n    return Promise.reject(new Error(\"reCAPTCHA site key is required\"));\n  }\n  if (!isBrowser()) {\n    return Promise.reject(\n      new Error(\"reCAPTCHA v3 can only be loaded in a browser\"),\n    );\n  }\n\n  const existing = loaders.get(siteKey);\n  if (existing) return existing;\n\n  const promise = new Promise<RecaptchaV3>((resolve, reject) => {\n    const ready = () => {\n      const api = window.grecaptcha;\n      if (!api) {\n        reject(new Error(\"reCAPTCHA loaded but grecaptcha is unavailable\"));\n        return;\n      }\n      // `ready` queues until the API has finished initialising internally;\n      // calling `execute` before that throws.\n      api.ready(() => resolve(api));\n    };\n\n    // Already loaded by this module, another SDK instance, or the host site.\n    if (window.grecaptcha) {\n      ready();\n      return;\n    }\n\n    const scriptId = `${SCRIPT_ID}-${siteKey}`;\n    const found = document.getElementById(scriptId);\n    if (found) {\n      found.addEventListener(\"load\", ready, { once: true });\n      found.addEventListener(\n        \"error\",\n        () => reject(new Error(\"Failed to load reCAPTCHA v3\")),\n        { once: true },\n      );\n      return;\n    }\n\n    const script = document.createElement(\"script\");\n    script.id = scriptId;\n    script.src = `${SCRIPT_SRC}${encodeURIComponent(siteKey)}`;\n    script.async = true;\n    script.defer = true;\n    script.addEventListener(\"load\", ready, { once: true });\n    script.addEventListener(\n      \"error\",\n      () => {\n        // Drop the memo so a later attempt can retry a transient CDN failure\n        // instead of being stuck with a permanently rejected promise.\n        loaders.delete(siteKey);\n        reject(new Error(\"Failed to load reCAPTCHA v3\"));\n      },\n      { once: true },\n    );\n    document.head.appendChild(script);\n  });\n\n  loaders.set(siteKey, promise);\n  return promise;\n}\n\n/**\n * Mint a single-use reCAPTCHA v3 token, loading the script on first use.\n *\n * Tokens are valid for ~2 minutes and are consumed by one verification, so\n * this must be called per submission — never cached.\n */\nexport async function getRecaptchaV3Token(\n  siteKey: string,\n  action: string = EXPLORE_RECAPTCHA_ACTION,\n): Promise<string> {\n  const api = await loadRecaptchaV3(siteKey);\n  return api.execute(siteKey, { action });\n}\n"]}
+{"version":3,"sources":["../../src/utils/cn.ts","../../src/utils/recaptcha-v3.ts","../../src/utils/site-chrome.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * Utility function to merge Tailwind CSS classes\n * Combines clsx and tailwind-merge for optimal class handling\n */\n\nimport { type ClassValue, clsx } from \"clsx\";\nimport { twMerge } from \"tailwind-merge\";\n\n/**\n * Merge multiple class names intelligently\n * - Handles conditional classes via clsx\n * - Deduplicates and resolves Tailwind conflicts via tailwind-merge\n *\n * @example\n * ```ts\n * cn('px-4 py-2', 'bg-blue-500', { 'text-white': isActive })\n * // => 'px-4 py-2 bg-blue-500 text-white' (if isActive is true)\n * ```\n */\nexport function cn(...inputs: ClassValue[]): string {\n  return twMerge(clsx(inputs));\n}\n","/**\n * reCAPTCHA v3 (invisible, score-based) loader and token minter.\n *\n * Deliberately dependency-free: the SDK already ships the `react-google-recaptcha`\n * peer for the **v2 checkbox** used by `ContactPage`, and the two widgets cannot\n * share a script tag — v3 needs `?render=<siteKey>` on the URL, v2 must not have\n * it. This module injects its own v3 script and leaves the v2 integration alone.\n *\n * The Explore chat turns v3 on purely from the backend catalog\n * (`exploreCatalog.captchaRequired && recaptchaSiteKey`), so nothing is loaded\n * and no third-party request is made on sites where captcha is off.\n */\n\n/** The slice of the `grecaptcha` global this module uses. */\nexport interface RecaptchaV3 {\n  /** Runs the callback once the API is fully initialised. */\n  ready(callback: () => void): void;\n  /** Mints a single-use token for `action`. */\n  execute(siteKey: string, options: { action: string }): Promise<string>;\n}\n\ndeclare global {\n  interface Window {\n    grecaptcha?: RecaptchaV3;\n  }\n}\n\nconst SCRIPT_ID = \"boff-recaptcha-v3\";\nconst SCRIPT_SRC = \"https://www.google.com/recaptcha/api.js?render=\";\n\n/** Default action name reported to reCAPTCHA for Explore chat submissions. */\nexport const EXPLORE_RECAPTCHA_ACTION = \"explore_chat\";\n\n/**\n * One in-flight/settled promise per site key. Guarantees the script tag is\n * injected at most once even when several components mount at the same time,\n * and lets later callers await the same load instead of racing it.\n */\nconst loaders = new Map<string, Promise<RecaptchaV3>>();\n\nfunction isBrowser(): boolean {\n  return typeof window !== \"undefined\" && typeof document !== \"undefined\";\n}\n\n/**\n * Load the reCAPTCHA v3 script for `siteKey` and resolve once `grecaptcha` is\n * ready to mint tokens.\n *\n * - Injects the script at most once per site key (subsequent calls reuse the\n *   same promise).\n * - Adopts an already-present script tag (e.g. injected by the host site)\n *   rather than adding a second one.\n * - Rejects rather than hanging when the script fails to load, so the caller\n *   can decide whether to submit without a token or surface an error.\n */\nexport function loadRecaptchaV3(siteKey: string): Promise<RecaptchaV3> {\n  if (!siteKey) {\n    return Promise.reject(new Error(\"reCAPTCHA site key is required\"));\n  }\n  if (!isBrowser()) {\n    return Promise.reject(\n      new Error(\"reCAPTCHA v3 can only be loaded in a browser\"),\n    );\n  }\n\n  const existing = loaders.get(siteKey);\n  if (existing) return existing;\n\n  const promise = new Promise<RecaptchaV3>((resolve, reject) => {\n    const ready = () => {\n      const api = window.grecaptcha;\n      if (!api) {\n        reject(new Error(\"reCAPTCHA loaded but grecaptcha is unavailable\"));\n        return;\n      }\n      // `ready` queues until the API has finished initialising internally;\n      // calling `execute` before that throws.\n      api.ready(() => resolve(api));\n    };\n\n    // Already loaded by this module, another SDK instance, or the host site.\n    if (window.grecaptcha) {\n      ready();\n      return;\n    }\n\n    const scriptId = `${SCRIPT_ID}-${siteKey}`;\n    const found = document.getElementById(scriptId);\n    if (found) {\n      found.addEventListener(\"load\", ready, { once: true });\n      found.addEventListener(\n        \"error\",\n        () => reject(new Error(\"Failed to load reCAPTCHA v3\")),\n        { once: true },\n      );\n      return;\n    }\n\n    const script = document.createElement(\"script\");\n    script.id = scriptId;\n    script.src = `${SCRIPT_SRC}${encodeURIComponent(siteKey)}`;\n    script.async = true;\n    script.defer = true;\n    script.addEventListener(\"load\", ready, { once: true });\n    script.addEventListener(\n      \"error\",\n      () => {\n        // Drop the memo so a later attempt can retry a transient CDN failure\n        // instead of being stuck with a permanently rejected promise.\n        loaders.delete(siteKey);\n        reject(new Error(\"Failed to load reCAPTCHA v3\"));\n      },\n      { once: true },\n    );\n    document.head.appendChild(script);\n  });\n\n  loaders.set(siteKey, promise);\n  return promise;\n}\n\n/**\n * Mint a single-use reCAPTCHA v3 token, loading the script on first use.\n *\n * Tokens are valid for ~2 minutes and are consumed by one verification, so\n * this must be called per submission — never cached.\n */\nexport async function getRecaptchaV3Token(\n  siteKey: string,\n  action: string = EXPLORE_RECAPTCHA_ACTION,\n): Promise<string> {\n  const api = await loadRecaptchaV3(siteKey);\n  return api.execute(siteKey, { action });\n}\n","/**\n * Which routes a host site should render WITHOUT its marketing footer.\n *\n * ## Why this lives in the SDK\n *\n * It was written 39 times. The footer belongs to each website, so the obvious\n * place for the rule is each website — and eight agents asked to add it produced\n * five different helpers (`footerless-routes.ts`, `footer-visibility.ts`,\n * `footer-routes.ts`, `explore-route.ts`, plus six copies inlined straight into\n * a layout). All five behave the same today. The next person to change the rule\n * has to find all five, and will not.\n *\n * The rule is really a property of the SDK's own surfaces: `/explore` is\n * footerless because `ExplorePage` sizes itself to one viewport, which is a fact\n * about this package, not about any site. So it is declared here, once, and the\n * sites ask.\n *\n * ## Why `/explore` and nothing else\n *\n * `ExplorePage` renders a full-viewport chat pane (`100dvh` minus the site\n * chrome above it), so anything after it is below the fold by construction. On a\n * phone these footers are 1100-1330px — roughly 70% of the document — and that\n * bulk is what allowed a restored scroll offset to open the page on nothing but\n * footer, with zero pixels of the chat on screen.\n *\n * The SDK's OTHER pages are the opposite case and must keep their footer:\n * `/concepts`, `/concept/:slug`, `/answers` and `/answer/:slug` are ordinary\n * indexed content pages whose footer carries the site's internal links.\n * Stripping it would cost hundreds of pages their internal linking, and nobody\n * would notice for weeks.\n */\n\n/** Routes that render without the site footer. Exact paths, not prefixes. */\nexport const FOOTERLESS_ROUTES: readonly string[] = [\"/explore\"];\n\n/**\n * Normalise a router pathname for exact comparison.\n *\n * React Router matches case-insensitively (`caseSensitive` defaults to false)\n * and tolerates a trailing slash, so `/Explore/` reaches the same route element\n * as `/explore` and has to be treated the same way here. Half the fleet's\n * hand-written versions compared case-sensitively and would have rendered a\n * footer under the chat pane on `/Explore`.\n */\nexport function normalizeRoutePath(pathname: string): string {\n  const trimmed = pathname.toLowerCase().replace(/\\/+$/, \"\");\n  return trimmed === \"\" ? \"/\" : trimmed;\n}\n\n/**\n * True when this pathname is one of the SDK's full-screen surfaces.\n *\n * Deliberately an exact-set test. `startsWith(\"/explore\")` would also swallow a\n * future `/explore-beta`, and `includes(\"explore\")` would swallow far more —\n * including `/concept/explore-your-data`, which is a real shape of concept slug.\n */\nexport function isFooterlessPath(pathname: string): boolean {\n  return FOOTERLESS_ROUTES.includes(normalizeRoutePath(pathname));\n}\n\n/** Inverse of {@link isFooterlessPath}, for layouts that read better positively. */\nexport function shouldRenderSiteFooter(pathname: string): boolean {\n  return !isFooterlessPath(pathname);\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@burdenoff/website-sdk",
-  "version": "2026.922.5",
+  "version": "2026.923.2",
   "description": "Shared SDK for Burdenoff product websites - reusable React components, utilities, and configurations",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -74,8 +74,9 @@
     "type-check": "bash scripts/build-limits.sh tsc --noEmit",
     "prepublishOnly": "bun run build",
     "test": "vitest",
+    "test:run": "vitest run --maxWorkers=4",
     "test:coverage": "vitest --coverage",
-    "sanity": "bash scripts/build-limits.sh --gate bash -c 'bun run format:check && bun run lint:sanity && bun run type-check && bun run build'"
+    "sanity": "bash scripts/build-limits.sh --gate bash -c 'bun run format:check && bun run lint:sanity && bun run type-check && bun run test:run && bun run build'"
   },
   "keywords": [
     "burdenoff",