@burdenoff/website-sdk 2026.923.1 → 2026.923.2

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":"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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","/**\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":";;;AAmBO,SAAS,MAAM,MAAA,EAA8B;AAClD,EAAA,OAAO,OAAA,CAAQ,IAAA,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.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.923.1",
+  "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",