@natoe/colab 0.1.31 → 0.1.36

package/dist/index.d.mts

@@ -465,6 +465,49 @@ interface CollabInboxProps {
  */
 declare function CollabInbox({ initialConversationId, onSelectConversation, className, style, }: CollabInboxProps): react_jsx_runtime.JSX.Element;
 
+interface HelpPanelProps {
+    /**
+     * The lab's help channel, already resolved by the host from
+     * `GET /help_channel`. Required — unlike a case thread there is nothing to
+     * look up and nothing to lazily create, so a HelpPanel without a channel has
+     * nothing to render.
+     */
+    conversation: Conversation;
+    /** Show "seen by" under own messages (default true) */
+    showSeenBy?: boolean;
+    /** Rendered above the composer — the host's case-reference control lives here. */
+    composerAccessory?: React.ReactNode;
+    className?: string;
+    style?: React.CSSProperties;
+}
+/**
+ * The imaging centre's support thread.
+ *
+ * A deliberately SEPARATE shell from CollabPanel rather than CollabPanel with
+ * flags. The two surfaces only look similar — CollabPanel is case-shaped, and
+ * serving support through it meant suppressing the patient header, the DICOM
+ * button, the open-case action, the participant roster and channel settings one
+ * at a time. Every case-oriented feature added another thing to suppress, and
+ * missing one is not cosmetic: a roster control that slipped through crashed
+ * the whole tree on an unmapped participant role.
+ *
+ * Building additively instead means a support thread can never inherit a
+ * case affordance by accident. What IS shared is the part worth sharing — the
+ * engine. useConversation, MessageList and MessageInput are identical here, so
+ * socket lifecycle, optimistic sends, read receipts, typing, attachments,
+ * audio and pagination all behave exactly as they do on a case thread, with no
+ * second implementation to drift.
+ *
+ * Deliberately absent, and none of it by oversight:
+ *   - patient / study header  — there is no patient
+ *   - View DICOM, Open case   — there is no order
+ *   - participant roster      — the roster is fixed by the backend (this lab
+ *                               plus Natoe support) and is not editable
+ *   - channel settings        — invite / remove / leave do not apply
+ *   - pinned messages         — a support thread is chronological
+ */
+declare function HelpPanel({ conversation, showSeenBy, composerAccessory, className, style, }: HelpPanelProps): react_jsx_runtime.JSX.Element;
+
 type MessageCallback = (message: Message) => void;
 type TypingCallback = (event: TypingEvent) => void;
 type ParticipantCallback = (participant: Participant) => void;
@@ -616,6 +659,15 @@ interface CollabContextValue {
     config: CollabConfig;
     apiBaseUrl: string;
     totalUnread: number;
+    /**
+     * Increments on EVERY `unread_update` push from the user-notifications
+     * channel, whether or not the totals changed. `totalUnread` alone cannot
+     * signal "something happened": your own sent message never counts toward
+     * your unread total, so after you send, the counts arrive unchanged and a
+     * value-keyed effect never fires. Consumers that resync on activity (the
+     * inbox's last-message previews) should depend on this instead.
+     */
+    unreadUpdateSeq: number;
     /**
      * Per-conversation unread counts, keyed by conversation ID. Updated
      * live via the user_notifications channel's unread_update push, so
@@ -1280,4 +1332,4 @@ declare const SUPPORTED_IMAGE_TYPES: string[];
 /** Max file size in bytes (20MB) */
 declare const MAX_FILE_SIZE: number;
 
-export { AUDIO_MIME_TYPE, type ChannelEvent, ChannelSettings, type ChannelUpdatePayload, type CollabConfig, type CollabError, CollabInbox, CollabInline, CollabPanel, CollabPopup, CollabProvider, CollabSocket, type Conversation, type ConversationKind, ConversationList, ConversationListItem, type ConversationListItem$1 as ConversationListItemData, type ConversationPreview, type CreateConversationResponse, DEEP_LINK_PREFIX, EVENTS, type InviteUserPayload, MAX_FILE_SIZE, MAX_PINNED_MESSAGES, MESSAGES_PAGE_SIZE, MESSAGE_TYPES, type Message, MessageActionsMenu, MessageBubble, MessageInput, MessageList, type MessageListHandle, type MessageSnapshot, type MessageType, type Participant, ParticipantsList, type PatientData, PatientHeader, PinnedMessagesBar, type PreviewBatchResponse, ReplyPreview, ReplyQuoteBlock, SUPPORTED_IMAGE_TYPES, SeenByIndicator, type SendMessagePayload, THEME_DEFAULTS, THEME_VAR, TYPING_DEBOUNCE_MS, type Theme, type TypingEvent, type UserRole, applyThemeOverrides, isCaseKind, isHelpKind, useAudioRecorder, useChannelSettings, useCollab, useConversation, useConversationList, useDeepLinks, useInlineCollab, useMessages, usePinnedMessages, useUnreadCount };
+export { AUDIO_MIME_TYPE, type ChannelEvent, ChannelSettings, type ChannelUpdatePayload, type CollabConfig, type CollabError, CollabInbox, CollabInline, CollabPanel, CollabPopup, CollabProvider, CollabSocket, type Conversation, type ConversationKind, ConversationList, ConversationListItem, type ConversationListItem$1 as ConversationListItemData, type ConversationPreview, type CreateConversationResponse, DEEP_LINK_PREFIX, EVENTS, HelpPanel, type InviteUserPayload, MAX_FILE_SIZE, MAX_PINNED_MESSAGES, MESSAGES_PAGE_SIZE, MESSAGE_TYPES, type Message, MessageActionsMenu, MessageBubble, MessageInput, MessageList, type MessageListHandle, type MessageSnapshot, type MessageType, type Participant, ParticipantsList, type PatientData, PatientHeader, PinnedMessagesBar, type PreviewBatchResponse, ReplyPreview, ReplyQuoteBlock, SUPPORTED_IMAGE_TYPES, SeenByIndicator, type SendMessagePayload, THEME_DEFAULTS, THEME_VAR, TYPING_DEBOUNCE_MS, type Theme, type TypingEvent, type UserRole, applyThemeOverrides, isCaseKind, isHelpKind, useAudioRecorder, useChannelSettings, useCollab, useConversation, useConversationList, useDeepLinks, useInlineCollab, useMessages, usePinnedMessages, useUnreadCount };

package/dist/index.d.ts

@@ -465,6 +465,49 @@ interface CollabInboxProps {
  */
 declare function CollabInbox({ initialConversationId, onSelectConversation, className, style, }: CollabInboxProps): react_jsx_runtime.JSX.Element;
 
+interface HelpPanelProps {
+    /**
+     * The lab's help channel, already resolved by the host from
+     * `GET /help_channel`. Required — unlike a case thread there is nothing to
+     * look up and nothing to lazily create, so a HelpPanel without a channel has
+     * nothing to render.
+     */
+    conversation: Conversation;
+    /** Show "seen by" under own messages (default true) */
+    showSeenBy?: boolean;
+    /** Rendered above the composer — the host's case-reference control lives here. */
+    composerAccessory?: React.ReactNode;
+    className?: string;
+    style?: React.CSSProperties;
+}
+/**
+ * The imaging centre's support thread.
+ *
+ * A deliberately SEPARATE shell from CollabPanel rather than CollabPanel with
+ * flags. The two surfaces only look similar — CollabPanel is case-shaped, and
+ * serving support through it meant suppressing the patient header, the DICOM
+ * button, the open-case action, the participant roster and channel settings one
+ * at a time. Every case-oriented feature added another thing to suppress, and
+ * missing one is not cosmetic: a roster control that slipped through crashed
+ * the whole tree on an unmapped participant role.
+ *
+ * Building additively instead means a support thread can never inherit a
+ * case affordance by accident. What IS shared is the part worth sharing — the
+ * engine. useConversation, MessageList and MessageInput are identical here, so
+ * socket lifecycle, optimistic sends, read receipts, typing, attachments,
+ * audio and pagination all behave exactly as they do on a case thread, with no
+ * second implementation to drift.
+ *
+ * Deliberately absent, and none of it by oversight:
+ *   - patient / study header  — there is no patient
+ *   - View DICOM, Open case   — there is no order
+ *   - participant roster      — the roster is fixed by the backend (this lab
+ *                               plus Natoe support) and is not editable
+ *   - channel settings        — invite / remove / leave do not apply
+ *   - pinned messages         — a support thread is chronological
+ */
+declare function HelpPanel({ conversation, showSeenBy, composerAccessory, className, style, }: HelpPanelProps): react_jsx_runtime.JSX.Element;
+
 type MessageCallback = (message: Message) => void;
 type TypingCallback = (event: TypingEvent) => void;
 type ParticipantCallback = (participant: Participant) => void;
@@ -616,6 +659,15 @@ interface CollabContextValue {
     config: CollabConfig;
     apiBaseUrl: string;
     totalUnread: number;
+    /**
+     * Increments on EVERY `unread_update` push from the user-notifications
+     * channel, whether or not the totals changed. `totalUnread` alone cannot
+     * signal "something happened": your own sent message never counts toward
+     * your unread total, so after you send, the counts arrive unchanged and a
+     * value-keyed effect never fires. Consumers that resync on activity (the
+     * inbox's last-message previews) should depend on this instead.
+     */
+    unreadUpdateSeq: number;
     /**
      * Per-conversation unread counts, keyed by conversation ID. Updated
      * live via the user_notifications channel's unread_update push, so
@@ -1280,4 +1332,4 @@ declare const SUPPORTED_IMAGE_TYPES: string[];
 /** Max file size in bytes (20MB) */
 declare const MAX_FILE_SIZE: number;
 
-export { AUDIO_MIME_TYPE, type ChannelEvent, ChannelSettings, type ChannelUpdatePayload, type CollabConfig, type CollabError, CollabInbox, CollabInline, CollabPanel, CollabPopup, CollabProvider, CollabSocket, type Conversation, type ConversationKind, ConversationList, ConversationListItem, type ConversationListItem$1 as ConversationListItemData, type ConversationPreview, type CreateConversationResponse, DEEP_LINK_PREFIX, EVENTS, type InviteUserPayload, MAX_FILE_SIZE, MAX_PINNED_MESSAGES, MESSAGES_PAGE_SIZE, MESSAGE_TYPES, type Message, MessageActionsMenu, MessageBubble, MessageInput, MessageList, type MessageListHandle, type MessageSnapshot, type MessageType, type Participant, ParticipantsList, type PatientData, PatientHeader, PinnedMessagesBar, type PreviewBatchResponse, ReplyPreview, ReplyQuoteBlock, SUPPORTED_IMAGE_TYPES, SeenByIndicator, type SendMessagePayload, THEME_DEFAULTS, THEME_VAR, TYPING_DEBOUNCE_MS, type Theme, type TypingEvent, type UserRole, applyThemeOverrides, isCaseKind, isHelpKind, useAudioRecorder, useChannelSettings, useCollab, useConversation, useConversationList, useDeepLinks, useInlineCollab, useMessages, usePinnedMessages, useUnreadCount };
+export { AUDIO_MIME_TYPE, type ChannelEvent, ChannelSettings, type ChannelUpdatePayload, type CollabConfig, type CollabError, CollabInbox, CollabInline, CollabPanel, CollabPopup, CollabProvider, CollabSocket, type Conversation, type ConversationKind, ConversationList, ConversationListItem, type ConversationListItem$1 as ConversationListItemData, type ConversationPreview, type CreateConversationResponse, DEEP_LINK_PREFIX, EVENTS, HelpPanel, type InviteUserPayload, MAX_FILE_SIZE, MAX_PINNED_MESSAGES, MESSAGES_PAGE_SIZE, MESSAGE_TYPES, type Message, MessageActionsMenu, MessageBubble, MessageInput, MessageList, type MessageListHandle, type MessageSnapshot, type MessageType, type Participant, ParticipantsList, type PatientData, PatientHeader, PinnedMessagesBar, type PreviewBatchResponse, ReplyPreview, ReplyQuoteBlock, SUPPORTED_IMAGE_TYPES, SeenByIndicator, type SendMessagePayload, THEME_DEFAULTS, THEME_VAR, TYPING_DEBOUNCE_MS, type Theme, type TypingEvent, type UserRole, applyThemeOverrides, isCaseKind, isHelpKind, useAudioRecorder, useChannelSettings, useCollab, useConversation, useConversationList, useDeepLinks, useInlineCollab, useMessages, usePinnedMessages, useUnreadCount };

package/dist/index.js

@@ -607,6 +607,7 @@ function CollabProvider({ config, apiBaseUrl, children }) {
   });
   const [unreadCounts, setUnreadCounts] = React4.useState({});
   const [unreadCountsByOrder, setUnreadCountsByOrder] = React4.useState({});
+  const [unreadUpdateSeq, setUnreadUpdateSeq] = React4.useState(0);
   const pendingKeys = React4.useRef(/* @__PURE__ */ new Set());
   const pendingResolvers = React4.useRef(/* @__PURE__ */ new Map());
   const previewCache = React4.useRef(/* @__PURE__ */ new Map());
@@ -625,6 +626,7 @@ function CollabProvider({ config, apiBaseUrl, children }) {
       setUnreadCounts(counts.conversation);
       setUnreadCountsByOrder(counts.order);
       previewCache.current.clear();
+      setUnreadUpdateSeq((n) => n + 1);
     });
     if (!s.isConnected()) {
       s.connect(config);
@@ -858,6 +860,7 @@ function CollabProvider({ config, apiBaseUrl, children }) {
         config,
         apiBaseUrl,
         totalUnread,
+        unreadUpdateSeq,
         unreadCounts,
         unreadCountsByOrder,
         requestPreview,
@@ -1645,7 +1648,7 @@ function PatientHeader({
       }
     )
   ] }) : null;
-  const settingsButton = onOpenSettings ? /* @__PURE__ */ jsxRuntime.jsxs(
+  const settingsButton = onOpenSettings && !isSupportChannel ? /* @__PURE__ */ jsxRuntime.jsxs(
     "button",
     {
       onClick: onOpenSettings,
@@ -3937,6 +3940,7 @@ function fallbackName(role) {
       return "User";
   }
 }
+var FALLBACK_ROLE_COLOR = { bg: "#f1f5f9", text: "#64748b" };
 function RoleBadge({ role }) {
   const colors = {
     radiologist: { bg: "#eef2ff", text: "#4f46e5" },
@@ -3948,8 +3952,8 @@ function RoleBadge({ role }) {
     admin: { bg: "#f1f5f9", text: "#64748b" }
     // slate
   };
-  const color = colors[role];
-  return /* @__PURE__ */ jsxRuntime.jsx("span", { style: { ...styles9.roleBadge, backgroundColor: color.bg, color: color.text }, children: role });
+  const color = colors[role] ?? FALLBACK_ROLE_COLOR;
+  return /* @__PURE__ */ jsxRuntime.jsx("span", { style: { ...styles9.roleBadge, backgroundColor: color.bg, color: color.text }, children: fallbackName(role) });
 }
 var styles9 = {
   list: {
@@ -4863,6 +4867,7 @@ function CollabPopup({
   const previouslyFocused = React4.useRef(null);
   const titleId = React4.useId();
   const titleText = cleanChannelName(loadedConversation?.name) || (patientData ? buildChannelName(patientData) : "Natoe Support");
+  const isSupportChannel = !patientData;
   const handleMouseDown = React4.useCallback(
     (e) => {
       if (!e.target.closest("[data-drag-handle]")) return;
@@ -4981,7 +4986,7 @@ function CollabPopup({
             })()
           ] }),
           /* @__PURE__ */ jsxRuntime.jsxs("div", { style: styles13.titleActions, children: [
-            loadedConversation && /* @__PURE__ */ jsxRuntime.jsxs(
+            loadedConversation && !isSupportChannel && /* @__PURE__ */ jsxRuntime.jsxs(
               "button",
               {
                 type: "button",
@@ -5874,7 +5879,7 @@ var styles14 = {
   }};
 function useConversationList(options) {
   const enabled = options?.enabled ?? true;
-  const { fetchConversationList, config, totalUnread: serverTotalUnread } = useCollab();
+  const { fetchConversationList, config, unreadUpdateSeq } = useCollab();
   const [conversations, setConversations] = React4.useState([]);
   const [isLoading, setIsLoading] = React4.useState(enabled);
   const [error, setError] = React4.useState(null);
@@ -5912,15 +5917,16 @@ function useConversationList(options) {
     if (!enabled) return;
     refresh();
   }, [enabled, refresh]);
-  const hasHandledInitialUnreadRef = React4.useRef(false);
+  const hasHandledInitialSeqRef = React4.useRef(false);
   React4.useEffect(() => {
     if (!enabled) return;
-    if (!hasHandledInitialUnreadRef.current) {
-      hasHandledInitialUnreadRef.current = true;
+    if (!hasHandledInitialSeqRef.current) {
+      hasHandledInitialSeqRef.current = true;
       return;
     }
-    silentRefresh();
-  }, [serverTotalUnread, enabled]);
+    const t = setTimeout(silentRefresh, 250);
+    return () => clearTimeout(t);
+  }, [unreadUpdateSeq, enabled]);
   const filter = React4.useCallback(
     (query) => {
       const q = query.trim().toLowerCase();
@@ -6687,6 +6693,143 @@ var styles17 = {
     maxWidth: "320px"
   }
 };
+ensureGlobalStyles();
+function HelpPanel({
+  conversation,
+  showSeenBy = true,
+  composerAccessory,
+  className,
+  style
+}) {
+  const { config } = useCollab();
+  const { handleDeepLink } = useDeepLinks();
+  const messageListRef = React4.useRef(null);
+  const {
+    messages,
+    typingUsers,
+    isLoading,
+    hasMore,
+    error,
+    replyTo,
+    setReplyTo,
+    sendMessage,
+    retryMessage,
+    sendAudioMessage,
+    sendFileMessage,
+    sendTyping,
+    markAsRead,
+    loadMoreMessages
+  } = useConversation({ conversation, kind: "help_lab" });
+  return /* @__PURE__ */ jsxRuntime.jsxs(
+    "div",
+    {
+      className: [ROOT_CLASS, className].filter(Boolean).join(" "),
+      style: { ...styles18.container, ...style },
+      children: [
+        /* @__PURE__ */ jsxRuntime.jsxs("header", { style: styles18.header, children: [
+          /* @__PURE__ */ jsxRuntime.jsx("span", { style: styles18.avatar, "aria-hidden": "true", children: "N" }),
+          /* @__PURE__ */ jsxRuntime.jsxs("span", { style: styles18.headerText, children: [
+            /* @__PURE__ */ jsxRuntime.jsx("span", { style: styles18.title, children: "Natoe Support" }),
+            /* @__PURE__ */ jsxRuntime.jsx("span", { style: styles18.subtitle, children: "Questions about your account, billing or a case" })
+          ] })
+        ] }),
+        error && /* @__PURE__ */ jsxRuntime.jsx("div", { style: styles18.error, role: "alert", children: error }),
+        isLoading && messages.length === 0 ? /* @__PURE__ */ jsxRuntime.jsx("div", { style: styles18.loading, children: /* @__PURE__ */ jsxRuntime.jsx(Spinner, {}) }) : /* @__PURE__ */ jsxRuntime.jsx(
+          MessageList,
+          {
+            ref: messageListRef,
+            messages,
+            currentUserId: config.userId,
+            showSeenBy,
+            typingUsers,
+            hasMore,
+            isLoading,
+            onLoadMore: loadMoreMessages,
+            onDeepLinkClick: handleDeepLink,
+            onMessageVisible: markAsRead,
+            onReply: setReplyTo,
+            onRetry: retryMessage,
+            pinDisabled: true
+          }
+        ),
+        composerAccessory,
+        /* @__PURE__ */ jsxRuntime.jsx(
+          MessageInput,
+          {
+            onSendText: sendMessage,
+            onSendAudio: sendAudioMessage,
+            onSendFile: sendFileMessage,
+            onTyping: sendTyping,
+            replyTo,
+            onCancelReply: () => setReplyTo(null),
+            placeholder: "Ask Natoe support\u2026"
+          }
+        )
+      ]
+    }
+  );
+}
+var styles18 = {
+  container: {
+    display: "flex",
+    flexDirection: "column",
+    height: "100%",
+    minHeight: 0,
+    fontFamily: FONT_STACK,
+    background: COLOR.white
+  },
+  header: {
+    display: "flex",
+    alignItems: "center",
+    gap: SPACE.S3,
+    padding: `${SPACE.S3} ${SPACE.S4}`,
+    borderBottom: `1px solid ${COLOR.neutral200}`,
+    flex: "0 0 auto"
+  },
+  avatar: {
+    flex: "0 0 auto",
+    width: 32,
+    height: 32,
+    borderRadius: RADIUS.full,
+    background: COLOR.primary,
+    color: COLOR.white,
+    display: "flex",
+    alignItems: "center",
+    justifyContent: "center",
+    fontSize: FONT_SIZE.md,
+    fontWeight: FONT_WEIGHT.semibold
+  },
+  headerText: {
+    display: "flex",
+    flexDirection: "column",
+    minWidth: 0
+  },
+  title: {
+    fontSize: FONT_SIZE.md,
+    fontWeight: FONT_WEIGHT.semibold,
+    color: COLOR.neutral900
+  },
+  subtitle: {
+    fontSize: FONT_SIZE.sm,
+    color: COLOR.neutral500,
+    overflow: "hidden",
+    textOverflow: "ellipsis",
+    whiteSpace: "nowrap"
+  },
+  error: {
+    padding: `${SPACE.S2} ${SPACE.S4}`,
+    fontSize: FONT_SIZE.sm,
+    color: COLOR.danger,
+    background: COLOR.dangerBg,
+    flex: "0 0 auto"
+  },
+  loading: {
+    flex: "1 1 auto",
+    display: "flex",
+    alignItems: "center",
+    justifyContent: "center"
+  }
+};
 function useMessages({
   conversationId,
   initialLimit = MESSAGES_PAGE_SIZE
@@ -6904,6 +7047,7 @@ exports.ConversationList = ConversationList;
 exports.ConversationListItem = ConversationListItem;
 exports.DEEP_LINK_PREFIX = DEEP_LINK_PREFIX;
 exports.EVENTS = EVENTS;
+exports.HelpPanel = HelpPanel;
 exports.MAX_FILE_SIZE = MAX_FILE_SIZE;
 exports.MAX_PINNED_MESSAGES = MAX_PINNED_MESSAGES;
 exports.MESSAGES_PAGE_SIZE = MESSAGES_PAGE_SIZE;