@burdenoff/website-sdk 2026.1102.2 → 2026.1104.1

package/dist/{chunk-FQH3AJN3.js → chunk-7O2I32ZN.js}

@@ -54,5 +54,5 @@ exports.isAvatarVersion = isAvatarVersion;
 exports.isRealTurnstileSiteKey = isRealTurnstileSiteKey;
 exports.liveConfigComplete = liveConfigComplete;
 exports.turnstileSiteKeyOf = turnstileSiteKeyOf;
-//# sourceMappingURL=chunk-FQH3AJN3.js.map
-//# sourceMappingURL=chunk-FQH3AJN3.js.map
+//# sourceMappingURL=chunk-7O2I32ZN.js.map
+//# sourceMappingURL=chunk-7O2I32ZN.js.map

package/dist/chunk-7O2I32ZN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/explore-avatar-live-config.ts"],"names":[],"mappings":";;;AAmEO,IAAM,mBAAA,GAAsB,oBAAA;AAEnC,IAAM,IAAA,GAAO,wBAAA;AACb,IAAM,OAAA,GAAU,wBAAA;AAChB,IAAM,QAAA,GAAW,wBAAA;AAKjB,IAAM,aAAA,GAAgB,wBAAA;AAMtB,IAAM,aAAA,GAAgB,0BAAA;AACtB,IAAM,iCAAiB,IAAI,GAAA,CAAI,CAAC,WAAA,EAAa,WAAA,EAAa,OAAO,CAAC,CAAA;AAG3D,SAAS,aAAa,KAAA,EAAwB;AACnD,EAAA,OAAO,IAAA,CAAK,KAAK,KAAK,CAAA;AACxB;AAGO,SAAS,gBAAgB,KAAA,EAAwB;AACtD,EAAA,OAAO,OAAA,CAAQ,KAAK,KAAK,CAAA;AAC3B;AAOO,SAAS,cAAc,UAAA,EAA+C;AAC3E,EAAA,IAAI,CAAC,YAAY,OAAO,IAAA;AACxB,EAAA,IAAI,GAAA;AACJ,EAAA,IAAI;AACF,IAAA,GAAA,GAAM,IAAI,IAAI,UAAU,CAAA;AAAA,EAC1B,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,MAAM,KAAA,GACJ,IAAI,QAAA,KAAa,OAAA,IAAW,eAAe,GAAA,CAAI,GAAA,CAAI,QAAA,CAAS,WAAA,EAAa,CAAA;AAC3E,EAAA,IAAI,GAAA,CAAI,QAAA,KAAa,QAAA,IAAY,CAAC,OAAO,OAAO,IAAA;AAChD,EAAA,OAAO,CAAA,EAAG,GAAA,CAAI,MAAM,CAAA,EAAG,mBAAmB,CAAA,CAAA;AAC5C;AAGO,SAAS,uBAAuB,GAAA,EAAsB;AAC3D,EAAA,OAAO,cAAc,IAAA,CAAK,GAAG,KAAK,CAAC,aAAA,CAAc,KAAK,GAAG,CAAA;AAC3D;AAMO,SAAS,mBAAmB,IAAA,EAAuC;AACxE,EAAA,MAAM,MAAe,IAAA,CAAK,gBAAA;AAC1B,EAAA,MAAM,YAAqB,IAAA,CAAK,gBAAA;AAChC,EAAA,OACE,OAAO,IAAA,CAAK,IAAA,KAAS,UAAA,IACrB,OAAO,IAAA,CAAK,IAAA,KAAS,QAAA,IACrB,YAAA,CAAa,KAAK,IAAI,CAAA,IACtB,OAAO,IAAA,CAAK,oBAAoB,QAAA,IAChC,eAAA,CAAgB,IAAA,CAAK,eAAe,CAAA,KACnC,GAAA,KAAQ,MAAA,IACP,GAAA,KAAQ,MACP,OAAO,GAAA,KAAQ,QAAA,IAAY,QAAA,CAAS,KAAK,GAAG,CAAA,CAAA,KAC9C,SAAA,KAAc,MAAA,IAAa,OAAO,SAAA,KAAc,SAAA,CAAA;AAErD;AAMO,SAAS,mBACd,IAAA,EACe;AACf,EAAA,MAAM,MAAM,IAAA,CAAK,gBAAA;AACjB,EAAA,IAAI,OAAO,QAAQ,QAAA,IAAY,CAAC,SAAS,IAAA,CAAK,GAAG,GAAG,OAAO,IAAA;AAC3D,EAAA,IAAI,KAAK,gBAAA,KAAqB,KAAA,IAAS,CAAC,sBAAA,CAAuB,GAAG,CAAA,EAAG;AACnE,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,OAAO,GAAA;AACT;AAMA,IAAM,QAAA,mBAAuC,IAAI,GAAA,CAAmB,CAAC,IAAI,CAAC,CAAA;AAGnE,SAAS,2BAA2B,MAAA,EAAgC;AACzE,EAAA,OAAO,QAAA,CAAS,IAAI,MAAM,CAAA;AAC5B","file":"chunk-7O2I32ZN.js","sourcesContent":["/**\n * BOFF-9797. The small part of the live avatar that the panel itself needs, whether or not it is ever opened: what a\n * host's `avatar.live` is, whether the live avatar can run on this page at all, and where its requests go.\n *\n * Everything else (the view, its state machine, the requests, the words, the bot check) is a separate chunk that a\n * site only downloads when its visitor first opens the Avatar view (see `explore-avatar-live.tsx`). That is why this\n * file is separate and kept to a few lines: it is the only part of the live avatar in the package root for a site that\n * does not pass `avatar.live`, and the part of it that decides, without loading anything, whether the chunk is wanted.\n * Types only, plus plain functions: nothing here imports a component, a context or a string table.\n */\nimport type { ExploreLocale } from \"./explore-i18n\";\nimport type { AvatarLiveModule } from \"../avatar-live/types\";\nimport type { UseExploreChatResult } from \"../hooks/use-explore-chat\";\n\n/**\n * BOFF-9797. A host's opt-in to the live avatar on its panel's Avatar tab. `site`, `load` and `manifestVersion` are\n * required; a config that is incomplete, or has an optional field of the wrong shape, leaves the tab as it was (and a\n * warning in the console).\n */\nexport interface ExplorePanelAvatarLive {\n  /** The site, as the live avatar service knows it: `healthybowl`. */\n  site: string;\n  /**\n   * Loads the live avatar's room module: `() => import('@burdenoff/website-sdk/avatar-live')`. Called only after the\n   * visitor presses Start on the consent card, never on page load or on opening the tab. That entry needs the\n   * package's optional peer dependency for media rooms (see the README).\n   */\n  load: () => Promise<AvatarLiveModule>;\n  /**\n   * The site's Cloudflare Turnstile site key, for the bot check that runs when the visitor presses Start. Used only when\n   * the server says it checks for bots (its availability's `botCheck`, contract v1.2), or says nothing of it (a server\n   * older than v1.2, which always checks): such a server's live avatar then needs a key, and without one the tab stays\n   * as it was. A server that runs no bot check needs none, and no Cloudflare script is loaded for it, key or not.\n   */\n  turnstileSiteKey?: string;\n  /**\n   * Whether `turnstileSiteKey` may be one of Cloudflare's test keys (`1x00000000000000000000AA` and keys of their\n   * shape). `websiteAvatarLive` sets it: true on alpha only, false everywhere else, so a production page never runs a\n   * test widget. Unset (a config made by hand): any key of a valid shape, as before.\n   */\n  allowTestSiteKey?: boolean;\n  /** The version of the suggested-question list the panel shows (its `examplePrompts`), such as `hb-en-1`. */\n  manifestVersion: string;\n}\n\n/**\n * What the live avatar reads of the panel's conversation: the transcript, whether it is read-only and the token, and\n * `reset` (the chat's own New chat) for its New chat button where the conversation can never be read. Where the server\n * reads typed questions too (contract v1.3), the Avatar tab's own question box asks through the same conversation:\n * `send` (with `surface: \"AVATAR\"`), and `canSend`, `phase`, `activity` and `catalog` to say when it can and what the\n * answer is doing, and `resent` to follow a question asked there that Chat's Retry sent again.\n */\nexport type AvatarConversation = Pick<\n  UseExploreChatResult,\n  | \"messages\"\n  | \"isSharedView\"\n  | \"getConversationToken\"\n  | \"reset\"\n  | \"send\"\n  | \"canSend\"\n  | \"phase\"\n  | \"activity\"\n  | \"catalog\"\n  | \"resent\"\n>;\n\n/** The web branch's routes, under the gateway's origin. */\nexport const AVATAR_WEB_API_PATH = \"/api/web-avatar/v1\";\n\nconst SITE = /^[a-z][a-z0-9-]{1,31}$/;\nconst VERSION = /^[A-Za-z0-9._-]{1,32}$/;\nconst SITE_KEY = /^[A-Za-z0-9_-]{1,128}$/;\n/**\n * The shape of Cloudflare's dummy site keys: a digit, `x`, a run of zeros and two letters (`1x00000000000000000000AA`,\n * `2x00000000000000000000AB`, `3x00000000000000000000FF`, …). Also catches an all-zero `0x…` placeholder.\n */\nconst TEST_SITE_KEY = /^\\dx0{16,}[A-Za-z]{2}$/;\n/**\n * A real-looking site key. Cloudflare documents no format for real keys; every key it issues starts `0x` (in practice\n * `0x4AAAAAAA…`, about 24 characters), in letters, digits, `_` and `-`. The length is kept loose (18 to 64 in all) so a\n * longer key Cloudflare might issue later still passes, and the charset matches what the panel accepts.\n */\nconst REAL_SITE_KEY = /^0x[A-Za-z0-9_-]{16,62}$/;\nconst LOOPBACK_HOSTS = new Set([\"localhost\", \"127.0.0.1\", \"[::1]\"]);\n\n/** A site slug the contract accepts (`healthybowl`). */\nexport function isAvatarSite(value: string): boolean {\n  return SITE.test(value);\n}\n\n/** A consent or manifest version the contract accepts (`hb-en-1`). */\nexport function isAvatarVersion(value: string): boolean {\n  return VERSION.test(value);\n}\n\n/**\n * The web branch's base URL on the SDK's configured gateway: the gateway URL's origin, plus\n * {@link AVATAR_WEB_API_PATH}. Null for anything that is not an `https:` URL (or `http:` on this machine, for local\n * development).\n */\nexport function avatarApiBase(gatewayUrl: string | undefined): string | null {\n  if (!gatewayUrl) return null;\n  let url: URL;\n  try {\n    url = new URL(gatewayUrl);\n  } catch {\n    return null;\n  }\n  const local =\n    url.protocol === \"http:\" && LOOPBACK_HOSTS.has(url.hostname.toLowerCase());\n  if (url.protocol !== \"https:\" && !local) return null;\n  return `${url.origin}${AVATAR_WEB_API_PATH}`;\n}\n\n/** A real-looking Turnstile site key: `0x…`, and not of the shape of Cloudflare's test keys. */\nexport function isRealTurnstileSiteKey(key: string): boolean {\n  return REAL_SITE_KEY.test(key) && !TEST_SITE_KEY.test(key);\n}\n\n/**\n * Whether a host's `avatar.live` has everything the live avatar needs, in the shapes the contract accepts. The site\n * key is optional (an empty one is none), and checked only when it is there.\n */\nexport function liveConfigComplete(live: ExplorePanelAvatarLive): boolean {\n  const key: unknown = live.turnstileSiteKey;\n  const allowTest: unknown = live.allowTestSiteKey;\n  return (\n    typeof live.load === \"function\" &&\n    typeof live.site === \"string\" &&\n    isAvatarSite(live.site) &&\n    typeof live.manifestVersion === \"string\" &&\n    isAvatarVersion(live.manifestVersion) &&\n    (key === undefined ||\n      key === \"\" ||\n      (typeof key === \"string\" && SITE_KEY.test(key))) &&\n    (allowTest === undefined || typeof allowTest === \"boolean\")\n  );\n}\n\n/**\n * The site key a bot check at Start may use, or null when there is none: no key, one of no valid shape, or one of\n * Cloudflare's test keys where `allowTestSiteKey` is false.\n */\nexport function turnstileSiteKeyOf(\n  live: ExplorePanelAvatarLive,\n): string | null {\n  const key = live.turnstileSiteKey;\n  if (typeof key !== \"string\" || !SITE_KEY.test(key)) return null;\n  if (live.allowTestSiteKey === false && !isRealTurnstileSiteKey(key)) {\n    return null;\n  }\n  return key;\n}\n\n/**\n * The locales whose live-avatar strings have been reviewed. The live avatar runs only in these; see\n * `explore-avatar-i18n.ts`. English only, until a named reviewer signs off on another.\n */\nconst REVIEWED: ReadonlySet<ExploreLocale> = new Set<ExploreLocale>([\"en\"]);\n\n/** Whether the live avatar may run in `locale`: its strings have been reviewed. */\nexport function isAvatarLiveLocaleReviewed(locale: ExploreLocale): boolean {\n  return REVIEWED.has(locale);\n}\n"]}

package/dist/{chunk-SFT3WHN5.mjs → chunk-K3QZGJEH.mjs}

@@ -46,5 +46,5 @@ function isAvatarLiveLocaleReviewed(locale) {
 }
 
 export { avatarApiBase, isAvatarLiveLocaleReviewed, isAvatarSite, isAvatarVersion, isRealTurnstileSiteKey, liveConfigComplete, turnstileSiteKeyOf };
-//# sourceMappingURL=chunk-SFT3WHN5.mjs.map
-//# sourceMappingURL=chunk-SFT3WHN5.mjs.map
+//# sourceMappingURL=chunk-K3QZGJEH.mjs.map
+//# sourceMappingURL=chunk-K3QZGJEH.mjs.map

package/dist/chunk-K3QZGJEH.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/explore-avatar-live-config.ts"],"names":[],"mappings":";AAmEO,IAAM,mBAAA,GAAsB,oBAAA;AAEnC,IAAM,IAAA,GAAO,wBAAA;AACb,IAAM,OAAA,GAAU,wBAAA;AAChB,IAAM,QAAA,GAAW,wBAAA;AAKjB,IAAM,aAAA,GAAgB,wBAAA;AAMtB,IAAM,aAAA,GAAgB,0BAAA;AACtB,IAAM,iCAAiB,IAAI,GAAA,CAAI,CAAC,WAAA,EAAa,WAAA,EAAa,OAAO,CAAC,CAAA;AAG3D,SAAS,aAAa,KAAA,EAAwB;AACnD,EAAA,OAAO,IAAA,CAAK,KAAK,KAAK,CAAA;AACxB;AAGO,SAAS,gBAAgB,KAAA,EAAwB;AACtD,EAAA,OAAO,OAAA,CAAQ,KAAK,KAAK,CAAA;AAC3B;AAOO,SAAS,cAAc,UAAA,EAA+C;AAC3E,EAAA,IAAI,CAAC,YAAY,OAAO,IAAA;AACxB,EAAA,IAAI,GAAA;AACJ,EAAA,IAAI;AACF,IAAA,GAAA,GAAM,IAAI,IAAI,UAAU,CAAA;AAAA,EAC1B,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,MAAM,KAAA,GACJ,IAAI,QAAA,KAAa,OAAA,IAAW,eAAe,GAAA,CAAI,GAAA,CAAI,QAAA,CAAS,WAAA,EAAa,CAAA;AAC3E,EAAA,IAAI,GAAA,CAAI,QAAA,KAAa,QAAA,IAAY,CAAC,OAAO,OAAO,IAAA;AAChD,EAAA,OAAO,CAAA,EAAG,GAAA,CAAI,MAAM,CAAA,EAAG,mBAAmB,CAAA,CAAA;AAC5C;AAGO,SAAS,uBAAuB,GAAA,EAAsB;AAC3D,EAAA,OAAO,cAAc,IAAA,CAAK,GAAG,KAAK,CAAC,aAAA,CAAc,KAAK,GAAG,CAAA;AAC3D;AAMO,SAAS,mBAAmB,IAAA,EAAuC;AACxE,EAAA,MAAM,MAAe,IAAA,CAAK,gBAAA;AAC1B,EAAA,MAAM,YAAqB,IAAA,CAAK,gBAAA;AAChC,EAAA,OACE,OAAO,IAAA,CAAK,IAAA,KAAS,UAAA,IACrB,OAAO,IAAA,CAAK,IAAA,KAAS,QAAA,IACrB,YAAA,CAAa,KAAK,IAAI,CAAA,IACtB,OAAO,IAAA,CAAK,oBAAoB,QAAA,IAChC,eAAA,CAAgB,IAAA,CAAK,eAAe,CAAA,KACnC,GAAA,KAAQ,MAAA,IACP,GAAA,KAAQ,MACP,OAAO,GAAA,KAAQ,QAAA,IAAY,QAAA,CAAS,KAAK,GAAG,CAAA,CAAA,KAC9C,SAAA,KAAc,MAAA,IAAa,OAAO,SAAA,KAAc,SAAA,CAAA;AAErD;AAMO,SAAS,mBACd,IAAA,EACe;AACf,EAAA,MAAM,MAAM,IAAA,CAAK,gBAAA;AACjB,EAAA,IAAI,OAAO,QAAQ,QAAA,IAAY,CAAC,SAAS,IAAA,CAAK,GAAG,GAAG,OAAO,IAAA;AAC3D,EAAA,IAAI,KAAK,gBAAA,KAAqB,KAAA,IAAS,CAAC,sBAAA,CAAuB,GAAG,CAAA,EAAG;AACnE,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,OAAO,GAAA;AACT;AAMA,IAAM,QAAA,mBAAuC,IAAI,GAAA,CAAmB,CAAC,IAAI,CAAC,CAAA;AAGnE,SAAS,2BAA2B,MAAA,EAAgC;AACzE,EAAA,OAAO,QAAA,CAAS,IAAI,MAAM,CAAA;AAC5B","file":"chunk-K3QZGJEH.mjs","sourcesContent":["/**\n * BOFF-9797. The small part of the live avatar that the panel itself needs, whether or not it is ever opened: what a\n * host's `avatar.live` is, whether the live avatar can run on this page at all, and where its requests go.\n *\n * Everything else (the view, its state machine, the requests, the words, the bot check) is a separate chunk that a\n * site only downloads when its visitor first opens the Avatar view (see `explore-avatar-live.tsx`). That is why this\n * file is separate and kept to a few lines: it is the only part of the live avatar in the package root for a site that\n * does not pass `avatar.live`, and the part of it that decides, without loading anything, whether the chunk is wanted.\n * Types only, plus plain functions: nothing here imports a component, a context or a string table.\n */\nimport type { ExploreLocale } from \"./explore-i18n\";\nimport type { AvatarLiveModule } from \"../avatar-live/types\";\nimport type { UseExploreChatResult } from \"../hooks/use-explore-chat\";\n\n/**\n * BOFF-9797. A host's opt-in to the live avatar on its panel's Avatar tab. `site`, `load` and `manifestVersion` are\n * required; a config that is incomplete, or has an optional field of the wrong shape, leaves the tab as it was (and a\n * warning in the console).\n */\nexport interface ExplorePanelAvatarLive {\n  /** The site, as the live avatar service knows it: `healthybowl`. */\n  site: string;\n  /**\n   * Loads the live avatar's room module: `() => import('@burdenoff/website-sdk/avatar-live')`. Called only after the\n   * visitor presses Start on the consent card, never on page load or on opening the tab. That entry needs the\n   * package's optional peer dependency for media rooms (see the README).\n   */\n  load: () => Promise<AvatarLiveModule>;\n  /**\n   * The site's Cloudflare Turnstile site key, for the bot check that runs when the visitor presses Start. Used only when\n   * the server says it checks for bots (its availability's `botCheck`, contract v1.2), or says nothing of it (a server\n   * older than v1.2, which always checks): such a server's live avatar then needs a key, and without one the tab stays\n   * as it was. A server that runs no bot check needs none, and no Cloudflare script is loaded for it, key or not.\n   */\n  turnstileSiteKey?: string;\n  /**\n   * Whether `turnstileSiteKey` may be one of Cloudflare's test keys (`1x00000000000000000000AA` and keys of their\n   * shape). `websiteAvatarLive` sets it: true on alpha only, false everywhere else, so a production page never runs a\n   * test widget. Unset (a config made by hand): any key of a valid shape, as before.\n   */\n  allowTestSiteKey?: boolean;\n  /** The version of the suggested-question list the panel shows (its `examplePrompts`), such as `hb-en-1`. */\n  manifestVersion: string;\n}\n\n/**\n * What the live avatar reads of the panel's conversation: the transcript, whether it is read-only and the token, and\n * `reset` (the chat's own New chat) for its New chat button where the conversation can never be read. Where the server\n * reads typed questions too (contract v1.3), the Avatar tab's own question box asks through the same conversation:\n * `send` (with `surface: \"AVATAR\"`), and `canSend`, `phase`, `activity` and `catalog` to say when it can and what the\n * answer is doing, and `resent` to follow a question asked there that Chat's Retry sent again.\n */\nexport type AvatarConversation = Pick<\n  UseExploreChatResult,\n  | \"messages\"\n  | \"isSharedView\"\n  | \"getConversationToken\"\n  | \"reset\"\n  | \"send\"\n  | \"canSend\"\n  | \"phase\"\n  | \"activity\"\n  | \"catalog\"\n  | \"resent\"\n>;\n\n/** The web branch's routes, under the gateway's origin. */\nexport const AVATAR_WEB_API_PATH = \"/api/web-avatar/v1\";\n\nconst SITE = /^[a-z][a-z0-9-]{1,31}$/;\nconst VERSION = /^[A-Za-z0-9._-]{1,32}$/;\nconst SITE_KEY = /^[A-Za-z0-9_-]{1,128}$/;\n/**\n * The shape of Cloudflare's dummy site keys: a digit, `x`, a run of zeros and two letters (`1x00000000000000000000AA`,\n * `2x00000000000000000000AB`, `3x00000000000000000000FF`, …). Also catches an all-zero `0x…` placeholder.\n */\nconst TEST_SITE_KEY = /^\\dx0{16,}[A-Za-z]{2}$/;\n/**\n * A real-looking site key. Cloudflare documents no format for real keys; every key it issues starts `0x` (in practice\n * `0x4AAAAAAA…`, about 24 characters), in letters, digits, `_` and `-`. The length is kept loose (18 to 64 in all) so a\n * longer key Cloudflare might issue later still passes, and the charset matches what the panel accepts.\n */\nconst REAL_SITE_KEY = /^0x[A-Za-z0-9_-]{16,62}$/;\nconst LOOPBACK_HOSTS = new Set([\"localhost\", \"127.0.0.1\", \"[::1]\"]);\n\n/** A site slug the contract accepts (`healthybowl`). */\nexport function isAvatarSite(value: string): boolean {\n  return SITE.test(value);\n}\n\n/** A consent or manifest version the contract accepts (`hb-en-1`). */\nexport function isAvatarVersion(value: string): boolean {\n  return VERSION.test(value);\n}\n\n/**\n * The web branch's base URL on the SDK's configured gateway: the gateway URL's origin, plus\n * {@link AVATAR_WEB_API_PATH}. Null for anything that is not an `https:` URL (or `http:` on this machine, for local\n * development).\n */\nexport function avatarApiBase(gatewayUrl: string | undefined): string | null {\n  if (!gatewayUrl) return null;\n  let url: URL;\n  try {\n    url = new URL(gatewayUrl);\n  } catch {\n    return null;\n  }\n  const local =\n    url.protocol === \"http:\" && LOOPBACK_HOSTS.has(url.hostname.toLowerCase());\n  if (url.protocol !== \"https:\" && !local) return null;\n  return `${url.origin}${AVATAR_WEB_API_PATH}`;\n}\n\n/** A real-looking Turnstile site key: `0x…`, and not of the shape of Cloudflare's test keys. */\nexport function isRealTurnstileSiteKey(key: string): boolean {\n  return REAL_SITE_KEY.test(key) && !TEST_SITE_KEY.test(key);\n}\n\n/**\n * Whether a host's `avatar.live` has everything the live avatar needs, in the shapes the contract accepts. The site\n * key is optional (an empty one is none), and checked only when it is there.\n */\nexport function liveConfigComplete(live: ExplorePanelAvatarLive): boolean {\n  const key: unknown = live.turnstileSiteKey;\n  const allowTest: unknown = live.allowTestSiteKey;\n  return (\n    typeof live.load === \"function\" &&\n    typeof live.site === \"string\" &&\n    isAvatarSite(live.site) &&\n    typeof live.manifestVersion === \"string\" &&\n    isAvatarVersion(live.manifestVersion) &&\n    (key === undefined ||\n      key === \"\" ||\n      (typeof key === \"string\" && SITE_KEY.test(key))) &&\n    (allowTest === undefined || typeof allowTest === \"boolean\")\n  );\n}\n\n/**\n * The site key a bot check at Start may use, or null when there is none: no key, one of no valid shape, or one of\n * Cloudflare's test keys where `allowTestSiteKey` is false.\n */\nexport function turnstileSiteKeyOf(\n  live: ExplorePanelAvatarLive,\n): string | null {\n  const key = live.turnstileSiteKey;\n  if (typeof key !== \"string\" || !SITE_KEY.test(key)) return null;\n  if (live.allowTestSiteKey === false && !isRealTurnstileSiteKey(key)) {\n    return null;\n  }\n  return key;\n}\n\n/**\n * The locales whose live-avatar strings have been reviewed. The live avatar runs only in these; see\n * `explore-avatar-i18n.ts`. English only, until a named reviewer signs off on another.\n */\nconst REVIEWED: ReadonlySet<ExploreLocale> = new Set<ExploreLocale>([\"en\"]);\n\n/** Whether the live avatar may run in `locale`: its strings have been reviewed. */\nexport function isAvatarLiveLocaleReviewed(locale: ExploreLocale): boolean {\n  return REVIEWED.has(locale);\n}\n"]}

package/dist/{chunk-SK5UGG6A.js → chunk-P5GMVPR6.js}

@@ -748,6 +748,7 @@ function useExploreChat(options = {}) {
   const [remainingToday, setRemainingToday] = react.useState(null);
   const [focusProduct, setFocusProductState] = react.useState(null);
   const [turnCount, setTurnCount] = react.useState(0);
+  const [resent, setResent] = react.useState(null);
   const messagesRef = react.useRef([]);
   const [archive, setArchive] = react.useState([]);
   const [hydrated, setHydrated] = react.useState(false);
@@ -768,6 +769,7 @@ function useExploreChat(options = {}) {
   const lastSentAttachmentsRef = react.useRef(
     []
   );
+  const lastSentSurfaceRef = react.useRef(null);
   const inFlightRef = react.useRef(false);
   catalogRef.current = catalog;
   const rememberConversationToken = react.useCallback((token) => {
@@ -1016,7 +1018,7 @@ function useExploreChat(options = {}) {
     [client, pollIntervalMs, pollTimeoutMs]
   );
   const submit = react.useCallback(
-    async (text, optimisticId, captchaAttempt, attachments) => {
+    async (text, optimisticId, captchaAttempt, attachments, surface, replaces) => {
       const activeCatalog = catalogRef.current;
       let recaptchaToken;
       if (activeCatalog.captchaRequired && activeCatalog.recaptchaSiteKey) {
@@ -1035,27 +1037,27 @@ function useExploreChat(options = {}) {
         ...recaptchaToken ? { recaptchaToken } : {},
         ...locale ? { locale } : {},
         ...pageUrl ? { pageUrl } : {},
-        ...attachments.length > 0 ? { attachments: [...attachments] } : {}
+        ...attachments.length > 0 ? { attachments: [...attachments] } : {},
+        ...surface !== null ? { surface } : {}
       };
       const res = await client.mutate(
         SEND_EXPLORE_MESSAGE_MUTATION,
         { input },
         { timeoutMs: SEND_REQUEST_TIMEOUT_MS }
       );
-      if (!mountedRef.current) return;
+      if (!mountedRef.current) return null;
       const first = res.errors?.[0];
       const result = res.data?.sendExploreMessage;
       if (first || !result) {
         const code = typeof first?.extensions?.code === "string" ? first.extensions.code : void 0;
         const classified = classifyExploreError(code, first?.message);
         if (classified.kind === "captcha" && captchaAttempt === 0) {
-          await submit(text, optimisticId, 1, attachments);
-          return;
+          return submit(text, optimisticId, 1, attachments, surface, replaces);
         }
         inFlightRef.current = false;
         setError(classified);
         setPhase(classified.kind === "rate-limit" ? "limited" : "error");
-        return;
+        return null;
       }
       rememberConversationToken(result.conversation.token);
       turnCountRef.current = result.conversation.turnCount;
@@ -1067,6 +1069,15 @@ function useExploreChat(options = {}) {
         const replaced = prev.some((m) => m.id === optimisticId) ? prev.map((m) => m.id === optimisticId ? userMessage : m) : [...prev, userMessage];
         return [...replaced, assistantMessage];
       });
+      if (replaces !== null) {
+        setResent({
+          replacedMessageIds: [...replaces, optimisticId],
+          sent: {
+            userMessageId: userMessage.id,
+            conversationToken: result.conversation.token
+          }
+        });
+      }
       if (assistantMessage.status === "COMPLETED" || assistantMessage.status === "FAILED") {
         inFlightRef.current = false;
         if (assistantMessage.status === "FAILED") {
@@ -1078,10 +1089,11 @@ function useExploreChat(options = {}) {
         } else {
           setPhase("ready");
         }
-        return;
+        return userMessage.id;
       }
       setPhase("streaming");
       startPolling(result.conversation.token, assistantMessage.id);
+      return userMessage.id;
     },
     [
       client,
@@ -1092,16 +1104,17 @@ function useExploreChat(options = {}) {
       startPolling
     ]
   );
-  const send = react.useCallback(
-    async (message, attachments = []) => {
+  const sendQuestion = react.useCallback(
+    async (message, attachments, options2, replaces) => {
       const text = message.trim();
-      if (!text) return;
-      if (inFlightRef.current) return;
+      const surface = options2.surface ?? null;
+      if (!text) return null;
+      if (inFlightRef.current) return null;
       const activeCatalog = catalogRef.current;
       if (!activeCatalog.enabled) {
         setError(classifyExploreError("EXPLORE_DISABLED"));
         setPhase("disabled");
-        return;
+        return null;
       }
       if (text.length > activeCatalog.limits.maxMessageLength) {
         setError({
@@ -1110,7 +1123,7 @@ function useExploreChat(options = {}) {
           message: `That message is ${text.length} characters \u2014 the limit is ${activeCatalog.limits.maxMessageLength}.`,
           retryable: false
         });
-        return;
+        return null;
       }
       if (turnCountRef.current >= activeCatalog.limits.maxTurnsPerConversation) {
         setError({
@@ -1119,11 +1132,12 @@ function useExploreChat(options = {}) {
           message: `This conversation has reached its ${activeCatalog.limits.maxTurnsPerConversation}-message limit. Start a new chat to keep going.`,
           retryable: false
         });
-        return;
+        return null;
       }
       inFlightRef.current = true;
       lastSentTextRef.current = text;
       lastSentAttachmentsRef.current = attachments;
+      lastSentSurfaceRef.current = surface;
       setError(null);
       setPhase("sending");
       cancelPolling();
@@ -1142,21 +1156,47 @@ function useExploreChat(options = {}) {
         completedAt: (/* @__PURE__ */ new Date()).toISOString()
       };
       setMessages((prev) => [...prev, optimistic]);
+      if (replaces !== null) {
+        setResent({
+          replacedMessageIds: replaces,
+          sent: {
+            userMessageId: optimistic.id,
+            conversationToken: conversationTokenRef.current
+          }
+        });
+      }
       turnCountRef.current += 1;
       setTurnCount(turnCountRef.current);
       onSend?.(text);
+      let userMessageId = optimistic.id;
       try {
-        await submit(text, optimistic.id, 0, attachments);
+        userMessageId = await submit(
+          text,
+          optimistic.id,
+          0,
+          attachments,
+          surface,
+          replaces
+        ) ?? optimistic.id;
       } catch (err) {
-        if (!mountedRef.current) return;
+        if (!mountedRef.current) return null;
         console.error("[WebSDK] Explore send failed", err);
         inFlightRef.current = false;
         setError(classifyExploreError("NETWORK_ERROR"));
         setPhase("error");
       }
+      if (!mountedRef.current) return null;
+      return {
+        userMessageId,
+        conversationToken: conversationTokenRef.current
+      };
     },
     [cancelPolling, onSend, submit]
   );
+  const send = react.useCallback(
+    (message, attachments = [], options2 = {}) => sendQuestion(message, attachments, options2, null),
+    [sendQuestion]
+  );
   const stop = react.useCallback(() => {
     cancelPolling();
     inFlightRef.current = false;
@@ -1185,6 +1225,13 @@ function useExploreChat(options = {}) {
     if (!text) return;
     cancelPolling();
     inFlightRef.current = false;
+    const shown = [...messagesRef.current];
+    const lastShown = shown[shown.length - 1];
+    if (lastShown?.role === "ASSISTANT" && lastShown.status === "FAILED") {
+      shown.pop();
+    }
+    const priorShown = shown[shown.length - 1];
+    const replaces = priorShown?.role === "USER" && priorShown.content === text ? [priorShown.id] : null;
     setMessages((prev) => {
       const next = [...prev];
       const last = next[next.length - 1];
@@ -1195,8 +1242,14 @@ function useExploreChat(options = {}) {
     });
     turnCountRef.current = Math.max(0, turnCountRef.current - 1);
     setTurnCount(turnCountRef.current);
-    void send(text, lastSentAttachmentsRef.current);
-  }, [cancelPolling, send]);
+    const surface = lastSentSurfaceRef.current;
+    void sendQuestion(
+      text,
+      lastSentAttachmentsRef.current,
+      surface === null ? {} : { surface },
+      replaces
+    );
+  }, [cancelPolling, sendQuestion]);
   const reset = react.useCallback(() => {
     setArchive(
       upsertArchive(storageKey, {
@@ -1210,9 +1263,11 @@ function useExploreChat(options = {}) {
     rememberConversationToken(null);
     lastSentTextRef.current = null;
     lastSentAttachmentsRef.current = [];
+    lastSentSurfaceRef.current = null;
     turnCountRef.current = 0;
     setTurnCount(0);
     setMessages([]);
+    setResent(null);
     setError(null);
     setRemainingToday(null);
     setPhase(catalogRef.current.enabled ? "ready" : "disabled");
@@ -1415,6 +1470,7 @@ function useExploreChat(options = {}) {
     send,
     stop,
     retry,
+    resent,
     reset,
     canSend,
     history: archive,
@@ -2037,5 +2093,5 @@ exports.useExploreChat = useExploreChat;
 exports.useProgressiveReveal = useProgressiveReveal;
 exports.useSpeechInput = useSpeechInput;
 exports.useSpeechOutput = useSpeechOutput;
-//# sourceMappingURL=chunk-SK5UGG6A.js.map
-//# sourceMappingURL=chunk-SK5UGG6A.js.map
+//# sourceMappingURL=chunk-P5GMVPR6.js.map
+//# sourceMappingURL=chunk-P5GMVPR6.js.map