keystone-design-bootstrap 1.0.105-dev.0 → 1.0.105

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "keystone-design-bootstrap",
-  "version": "1.0.105-dev.0",
+  "version": "1.0.105",
   "description": "Keystone Design Bootstrap - Sections, Elements, and Theme System for customer websites",
   "type": "module",
   "main": "./src/index.ts",

package/src/design_system/components/ChatWidget.tsx

@@ -7,7 +7,7 @@ import { cx } from '../../utils/cx';
 import { captureEvent } from '../../tracking/captureEvent';
 import { useRealtimeReplyOrchestrator, type RealtimeSubscriptionData } from '../chat/useRealtimeReplyOrchestrator';
 import { error as logError } from '../../tracking/logging';
-import { RAILS_BACKEND, SOR_BACKEND, type ChatBackend } from '../../lib/chat-backend';
+import { RAILS_BACKEND, SOR_BACKEND, type ChatBackend } from '../../lib/chat-backend-constants';
 
 interface Message {
   id: string;

package/src/lib/chat-backend-constants.ts

@@ -0,0 +1,8 @@
+/**
+ * Chat backend identifiers — isomorphic (safe to import from client
+ * components; no server-only dependencies). Backend *resolution* lives in
+ * ./chat-backend (server-only: reads env, logs via server-log).
+ */
+export const RAILS_BACKEND = 'rails' as const;
+export const SOR_BACKEND = 'sor' as const;
+export type ChatBackend = typeof RAILS_BACKEND | typeof SOR_BACKEND;

package/src/lib/chat-backend.ts

@@ -1,5 +1,7 @@
 /**
- * Which chat backend the site's /api/chat proxy targets.
+ * Which chat backend the site's /api/chat proxy targets. SERVER-ONLY module
+ * (reads env, logs via server-log) — client components import the constants
+ * from ./chat-backend-constants instead.
  *
  * The two backends have architecturally different webchat contracts:
  * - 'rails' (keystone-mono-proto): /public/messages + ActionCable realtime.
@@ -16,10 +18,9 @@
  * backend; flip the default to 'sor' once the Rails backend is scrapped.
  */
 import { serverError } from './server-log';
+import { RAILS_BACKEND, SOR_BACKEND, type ChatBackend } from './chat-backend-constants';
 
-export const RAILS_BACKEND = 'rails' as const;
-export const SOR_BACKEND = 'sor' as const;
-export type ChatBackend = typeof RAILS_BACKEND | typeof SOR_BACKEND;
+export { RAILS_BACKEND, SOR_BACKEND, type ChatBackend };
 
 export function resolveChatBackend(): ChatBackend {
   const explicit = process.env.CHAT_BACKEND;

package/src/next/layouts/root-layout.tsx

@@ -11,7 +11,7 @@ import {
   KeystoneAnalyticsTracker,
 } from '../../tracking';
 import { ChatWidget } from '../../design_system/components/ChatWidget';
-import { resolveChatBackend } from '../../lib/chat-backend';
+import { resolveChatBackend, type ChatBackend } from '../../lib/chat-backend';
 import { FormDefinitionsProvider } from '../contexts/form-definitions';
 import { KeystoneSSRProvider } from '../providers/ssr-provider';
 import {
@@ -56,6 +56,15 @@ export type KeystoneRootLayoutOptions = {
   headerOverrides?: KeystoneRootLayoutHeaderOverrides;
   /** Chat widget position */
   chatPosition?: 'bottom-right' | 'bottom-left';
+  /**
+   * Which backend the site's /api/chat proxy targets. MUST match the route's
+   * `createChatRouteHandlers({ backend })` selection — if you pass an explicit
+   * backend to the route factory, pass the same value here, or the widget's
+   * reply delivery (realtime vs polling) diverges from the route's wire shape
+   * and the typing indicator can hang. When omitted, both sides derive the
+   * same value from CHAT_BACKEND / API_URL (see lib/chat-backend).
+   */
+  chatBackend?: ChatBackend;
   /**
    * PostHog ingest host. Defaults to `https://us.i.posthog.com`.
    * Override when self-hosting or using the EU cloud (`https://eu.i.posthog.com`).
@@ -185,7 +194,7 @@ j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
   const chatEnabled = Boolean(ci?.chat_enabled);
   // Which backend the site's /api/chat proxy targets — same resolution as the
   // route handlers (CHAT_BACKEND override, else derived from API_URL).
-  const chatBackend = resolveChatBackend();
+  const chatBackend = options?.chatBackend ?? resolveChatBackend();
 
   const headerOverrides = options?.headerOverrides;
   const posthogHost = options?.posthogHost?.trim() || undefined;