@natoe/colab 0.1.27 → 0.1.30

package/dist/index.mjs

@@ -576,6 +576,16 @@ function applyThemeOverrides(theme) {
     }
   });
 }
+function previewKey(orderId, kind) {
+  return `${kind}|${orderId}`;
+}
+function parsePreviewKey(key) {
+  const separator = key.indexOf("|");
+  return {
+    kind: key.slice(0, separator),
+    orderId: key.slice(separator + 1)
+  };
+}
 var CollabContext = createContext(null);
 function useCollab() {
   const context = useContext(CollabContext);
@@ -591,7 +601,7 @@ function CollabProvider({ config, apiBaseUrl, children }) {
   });
   const [unreadCounts, setUnreadCounts] = useState({});
   const [unreadCountsByOrder, setUnreadCountsByOrder] = useState({});
-  const pendingOrderIds = useRef(/* @__PURE__ */ new Set());
+  const pendingKeys = useRef(/* @__PURE__ */ new Set());
   const pendingResolvers = useRef(/* @__PURE__ */ new Map());
   const previewCache = useRef(/* @__PURE__ */ new Map());
   const batchScheduled = useRef(false);
@@ -622,47 +632,61 @@ function CollabProvider({ config, apiBaseUrl, children }) {
     [config]
   );
   const flushPreviewBatch = useCallback(async () => {
-    const orderIds = Array.from(pendingOrderIds.current);
+    const keys = Array.from(pendingKeys.current);
     const resolvers = new Map(pendingResolvers.current);
-    pendingOrderIds.current.clear();
+    pendingKeys.current.clear();
     pendingResolvers.current.clear();
     batchScheduled.current = false;
-    if (orderIds.length === 0) return;
-    try {
-      const query = orderIds.map((id) => `order_ids[]=${encodeURIComponent(id)}`).join("&");
-      const response = await fetch(`${apiBaseUrl}/api/natoe-colab/conversations/previews?${query}`, {
-        headers: authHeaders()
-      });
-      if (!response.ok) throw new Error(`Preview batch failed: ${response.status}`);
-      const data = snakeToCamel(await response.json());
-      orderIds.forEach((orderId) => {
-        const preview = data.previews[orderId] ?? null;
-        if (preview !== null) {
-          previewCache.current.set(orderId, preview);
-        }
-        resolvers.get(orderId)?.forEach((resolve) => resolve(preview));
-      });
-    } catch (error) {
-      config.onError?.({
-        code: "PREVIEW_BATCH_ERROR",
-        message: "Failed to fetch conversation previews",
-        details: error
-      });
-      orderIds.forEach((orderId) => {
-        resolvers.get(orderId)?.forEach((resolve) => resolve(null));
-      });
+    if (keys.length === 0) return;
+    const byKind = /* @__PURE__ */ new Map();
+    for (const key of keys) {
+      const { orderId, kind } = parsePreviewKey(key);
+      const list = byKind.get(kind) ?? [];
+      list.push(orderId);
+      byKind.set(kind, list);
     }
+    await Promise.all(
+      Array.from(byKind.entries()).map(async ([kind, orderIds]) => {
+        try {
+          const query = orderIds.map((id) => `order_ids[]=${encodeURIComponent(id)}`).join("&");
+          const response = await fetch(
+            `${apiBaseUrl}/api/natoe-colab/conversations/previews?${query}&kind=${encodeURIComponent(kind)}`,
+            { headers: authHeaders() }
+          );
+          if (!response.ok) throw new Error(`Preview batch failed: ${response.status}`);
+          const data = snakeToCamel(await response.json());
+          orderIds.forEach((orderId) => {
+            const key = previewKey(orderId, kind);
+            const preview = data.previews[orderId] ?? null;
+            if (preview !== null) {
+              previewCache.current.set(key, preview);
+            }
+            resolvers.get(key)?.forEach((resolve) => resolve(preview));
+          });
+        } catch (error) {
+          config.onError?.({
+            code: "PREVIEW_BATCH_ERROR",
+            message: "Failed to fetch conversation previews",
+            details: error
+          });
+          orderIds.forEach((orderId) => {
+            resolvers.get(previewKey(orderId, kind))?.forEach((resolve) => resolve(null));
+          });
+        }
+      })
+    );
   }, [apiBaseUrl, authHeaders, config]);
   const requestPreview = useCallback(
-    (orderId) => {
-      if (previewCache.current.has(orderId)) {
-        return Promise.resolve(previewCache.current.get(orderId) ?? null);
+    (orderId, kind = "case") => {
+      const key = previewKey(orderId, kind);
+      if (previewCache.current.has(key)) {
+        return Promise.resolve(previewCache.current.get(key) ?? null);
       }
       return new Promise((resolve) => {
-        pendingOrderIds.current.add(orderId);
-        const existing = pendingResolvers.current.get(orderId) || [];
+        pendingKeys.current.add(key);
+        const existing = pendingResolvers.current.get(key) || [];
         existing.push(resolve);
-        pendingResolvers.current.set(orderId, existing);
+        pendingResolvers.current.set(key, existing);
         if (!batchScheduled.current) {
           batchScheduled.current = true;
           queueMicrotask(flushPreviewBatch);
@@ -671,8 +695,16 @@ function CollabProvider({ config, apiBaseUrl, children }) {
     },
     [flushPreviewBatch]
   );
-  const invalidatePreview = useCallback((orderId) => {
-    previewCache.current.delete(orderId);
+  const invalidatePreview = useCallback((orderId, kind) => {
+    if (kind) {
+      previewCache.current.delete(previewKey(orderId, kind));
+      return;
+    }
+    for (const key of Array.from(previewCache.current.keys())) {
+      if (parsePreviewKey(key).orderId === orderId) {
+        previewCache.current.delete(key);
+      }
+    }
   }, []);
   const fetchMessages = useCallback(
     async (conversationId, options = {}) => {
@@ -699,11 +731,17 @@ function CollabProvider({ config, apiBaseUrl, children }) {
           message: "Cannot create conversation: orderId is empty. Host app passed an order with no orderId/mainOrderId set."
         };
       }
+      const kind = options.kind ?? "case";
       const response = await fetch(`${apiBaseUrl}/api/natoe-colab/orders/${orderId}/messages`, {
         method: "POST",
         headers: authHeaders(),
         body: JSON.stringify({
           message,
+          // Top-level, matching the backend's `params["kind"]`. It selects
+          // BOTH which thread is addressed and which authorization path runs
+          // — help kinds go through Access.can_access_help?/5, not the
+          // broader case-chat check.
+          kind,
           conversation: {
             name: options.name,
             participant_ids: options.participantIds ?? []
@@ -715,7 +753,7 @@ function CollabProvider({ config, apiBaseUrl, children }) {
         throw { code: "CREATE_ERROR", message: "Failed to create conversation", details: error };
       }
       const data = snakeToCamel(await response.json());
-      previewCache.current.delete(orderId);
+      previewCache.current.delete(previewKey(orderId, kind));
       return data;
     },
     [apiBaseUrl, authHeaders]
@@ -847,9 +885,11 @@ function cleanChannelName(name) {
 // src/hooks/useConversation.ts
 function useConversation({
   orderId,
+  conversation: providedConversation,
   patientData,
   participantIds = [],
-  loadHistory = true
+  loadHistory = true,
+  kind = "case"
 }) {
   const {
     socket,
@@ -878,6 +918,7 @@ function useConversation({
   const markedReadIdsRef = useRef(/* @__PURE__ */ new Set());
   const buildName = useCallback(
     () => {
+      if (!patientData) return "";
       const labName = patientData.labName ?? (config.userRole === "lab" ? config.userName : void 0);
       return buildChannelName({ ...patientData, labName });
     },
@@ -977,7 +1018,29 @@ function useConversation({
       setIsLoading(true);
       setError(null);
       try {
-        const preview = await requestPreview(orderId);
+        if (providedConversation) {
+          setConversation(providedConversation);
+          setParticipants(providedConversation.participants ?? []);
+          joinChannel(providedConversation);
+          if (loadHistory) {
+            const history = await fetchMessages(providedConversation.id);
+            if (cancelled) return;
+            setMessages(history);
+            setHasMore(history.length >= MESSAGES_PAGE_SIZE);
+            setPinnedMessages(history.filter((m) => m.isPinned));
+          }
+          if (!cancelled) setIsLoading(false);
+          return;
+        }
+        if (!orderId) {
+          setConversation(null);
+          setMessages([]);
+          setParticipants([]);
+          setHasMore(false);
+          setIsLoading(false);
+          return;
+        }
+        const preview = await requestPreview(orderId, kind);
         if (cancelled) return;
         if (!preview) {
           setConversation(null);
@@ -1034,10 +1097,16 @@ function useConversation({
       markedReadIdsRef.current.clear();
       setIsConnected(false);
     };
-  }, [orderId]);
+  }, [orderId, kind]);
   const ensureConversation = useCallback(
     async (payload) => {
       if (conversation) return { conv: conversation, persistedByCreate: false };
+      if (!orderId) {
+        throw {
+          code: "NO_CONVERSATION",
+          message: "This conversation is not available yet. Please reopen it and try again."
+        };
+      }
       if (ensureConversationInFlight.current) {
         const conv = await ensureConversationInFlight.current;
         return { conv, persistedByCreate: false };
@@ -1045,13 +1114,14 @@ function useConversation({
       const inflight = (async () => {
         const result = await createConversationWithMessage(orderId, payload, {
           name: buildName(),
-          participantIds
+          participantIds,
+          kind
         });
         setConversation(result.conversation);
         setParticipants(result.conversation.participants);
         setMessages([result.message]);
         joinChannel(result.conversation);
-        invalidatePreview(orderId);
+        invalidatePreview(orderId, kind);
         if (loadHistory) {
           fetchMessages(result.conversation.id).then((history) => {
             setMessages((prev) => {
@@ -1081,6 +1151,7 @@ function useConversation({
       conversation,
       createConversationWithMessage,
       orderId,
+      kind,
       buildName,
       participantIds,
       joinChannel,
@@ -1523,15 +1594,19 @@ function PatientHeader({
   onBack,
   hideName = false,
   displayName,
+  isSupportChannel = false,
   className
 }) {
-  const hasDicom = !!(patientData.studyId && patientData.storageId);
-  const resolvedName = resolveDisplayName(patientData, displayName);
+  const hasDicom = !isSupportChannel && !!(patientData.studyId && patientData.storageId);
+  const resolvedName = isSupportChannel ? displayName || patientData.patientName || "Natoe Support" : resolveDisplayName(patientData, displayName);
   const metaParts = [];
-  if (patientData.patientAge) metaParts.push(String(patientData.patientAge));
-  if (patientData.patientSex) metaParts.push(String(patientData.patientSex));
-  if (patientData.studyType) metaParts.push(patientData.studyType);
-  if (patientData.bodyParts && patientData.bodyParts.length > 0) {
+  if (isSupportChannel) {
+    metaParts.push("Help and support");
+  }
+  if (!isSupportChannel && patientData.patientAge) metaParts.push(String(patientData.patientAge));
+  if (!isSupportChannel && patientData.patientSex) metaParts.push(String(patientData.patientSex));
+  if (!isSupportChannel && patientData.studyType) metaParts.push(patientData.studyType);
+  if (!isSupportChannel && patientData.bodyParts && patientData.bodyParts.length > 0) {
     metaParts.push(patientData.bodyParts.join(", "));
   }
   const hasPrimaryActions = hasDicom && onOpenDicom || onOpenCase;
@@ -4488,8 +4563,10 @@ var DARK_THEME_OVERRIDES = {
 };
 function CollabPanel({
   orderId,
+  conversation: providedConversation,
   patientData,
   participantIds,
+  kind,
   showSeenBy = true,
   onBack,
   hidePatientName = false,
@@ -4528,7 +4605,13 @@ function CollabPanel({
     loadMoreMessages,
     pinMessage,
     unpinMessage
-  } = useConversation({ orderId, patientData, participantIds });
+  } = useConversation({
+    orderId,
+    conversation: providedConversation,
+    patientData,
+    participantIds,
+    kind
+  });
   useEffect(() => {
     onConversationChange?.(conversation);
   }, [conversation, onConversationChange]);
@@ -4537,11 +4620,11 @@ function CollabPanel({
   });
   const { handleDeepLink } = useDeepLinks();
   const handleOpenDicom = () => {
-    if (patientData.studyId && patientData.storageId && config.onOpenDicom) {
+    if (patientData?.studyId && patientData.storageId && config.onOpenDicom) {
       config.onOpenDicom(patientData.studyId, patientData.storageId);
     }
   };
-  const handleOpenCase = !hideOpenCase && config.onOpenCase ? () => config.onOpenCase?.(patientData.orderId, patientData.displayOrderId) : void 0;
+  const handleOpenCase = !hideOpenCase && config.onOpenCase && patientData?.orderId ? () => config.onOpenCase?.(patientData.orderId, patientData.displayOrderId) : void 0;
   const handleJumpToMessage = (messageId) => {
     messageListRef.current?.scrollToMessage(messageId);
   };
@@ -4614,7 +4697,8 @@ function CollabPanel({
       /* @__PURE__ */ jsx(
         PatientHeader,
         {
-          patientData,
+          patientData: patientData ?? { orderId: "", patientName: conversation?.name ?? "Natoe Support" },
+          isSupportChannel: !patientData,
           participants,
           onOpenDicom: handleOpenDicom,
           onOpenCase: handleOpenCase,
@@ -4747,6 +4831,7 @@ function CollabPopup({
   orderId,
   patientData,
   participantIds,
+  kind,
   isOpen,
   onClose,
   onBack,
@@ -4935,6 +5020,7 @@ function CollabPopup({
             orderId,
             patientData,
             participantIds,
+            kind,
             hidePatientName: true,
             onConversationChange: setLoadedConversation,
             showSettings,
@@ -5052,7 +5138,8 @@ function useInlineCollab({
   orderId,
   patientData,
   participantIds = [],
-  messageLimit = 5
+  messageLimit = 5,
+  kind = "case"
 }) {
   const {
     socket,
@@ -5100,7 +5187,7 @@ function useInlineCollab({
       setIsLoading(true);
       setError(null);
       try {
-        const result = await requestPreview(orderId);
+        const result = await requestPreview(orderId, kind);
         if (cancelled) return;
         setPreview(result);
         if (result) {
@@ -5196,7 +5283,8 @@ function useInlineCollab({
         try {
           const result = await createConversationWithMessage(orderId, payload, {
             name: buildName(),
-            participantIds
+            participantIds,
+            kind
           });
           const newPreview = {
             conversationId: result.conversation.id,
@@ -5210,7 +5298,7 @@ function useInlineCollab({
           setPreview(newPreview);
           setMessages([result.message]);
           setParticipants(result.conversation.participants);
-          invalidatePreview(orderId);
+          invalidatePreview(orderId, kind);
           if (elementRef.current) {
             subscribe(result.conversation.id);
           }
@@ -5335,6 +5423,7 @@ function CollabInline({
   orderId,
   patientData,
   participantIds,
+  kind,
   onExpand,
   messageLimit = 1,
   placeholder = "Discuss this case\u2026",
@@ -5353,7 +5442,7 @@ function CollabInline({
     sendMessage,
     sendAudioMessage,
     containerRef
-  } = useInlineCollab({ orderId, patientData, participantIds, messageLimit });
+  } = useInlineCollab({ orderId, patientData, participantIds, messageLimit, kind });
   const containerStyle = {
     ...styles14.container,
     backgroundColor: pal.bg,
@@ -5845,6 +5934,14 @@ function useConversationList(options) {
     totalUnread
   };
 }
+
+// src/core/types.ts
+function isHelpKind(kind) {
+  return kind === "help_lab";
+}
+function isCaseKind(kind) {
+  return kind === void 0 || kind === "case";
+}
 function ConversationListItem({
   item,
   isSelected,
@@ -5881,6 +5978,10 @@ function ConversationListItem({
                 children: displayName
               }
             ),
+            isHelpKind(item.kind) && /* A case can show two rows with the same patient name — the shared
+               case thread and a private help thread. Without this the two are
+               indistinguishable in the inbox. */
+            /* @__PURE__ */ jsx("span", { style: styles15.helpPill, "aria-label": "Help thread", children: "Help" }),
             /* @__PURE__ */ jsx(
               "span",
               {
@@ -6027,6 +6128,17 @@ var styles15 = {
   nameUnread: {
     fontWeight: FONT_WEIGHT.bold
   },
+  helpPill: {
+    fontSize: FONT_SIZE.xs,
+    fontWeight: FONT_WEIGHT.semibold,
+    color: COLOR.primary,
+    background: COLOR.primaryBg,
+    borderRadius: RADIUS.sm,
+    padding: `0 ${SPACE.S2}`,
+    lineHeight: "16px",
+    flexShrink: 0,
+    whiteSpace: "nowrap"
+  },
   time: {
     fontSize: FONT_SIZE.xs,
     color: COLOR.neutral500,
@@ -6464,6 +6576,7 @@ function CollabInbox({
   );
 }
 function buildPatientData(item) {
+  if (isHelpKind(item.kind) || !item.orderId) return void 0;
   const parsed = parseChannelName(item.name, item.orderId);
   if (item.patientSnapshot) {
     return {
@@ -6770,6 +6883,6 @@ function usePinnedMessages({
   };
 }
 
-export { AUDIO_MIME_TYPE, ChannelSettings, CollabInbox, CollabInline, CollabPanel, CollabPopup, CollabProvider, CollabSocket, ConversationList, ConversationListItem, DEEP_LINK_PREFIX, EVENTS, MAX_FILE_SIZE, MAX_PINNED_MESSAGES, MESSAGES_PAGE_SIZE, MESSAGE_TYPES, MessageActionsMenu, MessageBubble, MessageInput, MessageList, ParticipantsList, PatientHeader, PinnedMessagesBar, ReplyPreview, ReplyQuoteBlock, SUPPORTED_IMAGE_TYPES, SeenByIndicator, THEME_DEFAULTS, THEME_VAR, TYPING_DEBOUNCE_MS, applyThemeOverrides, useAudioRecorder, useChannelSettings, useCollab, useConversation, useConversationList, useDeepLinks, useInlineCollab, useMessages, usePinnedMessages, useUnreadCount };
+export { AUDIO_MIME_TYPE, ChannelSettings, CollabInbox, CollabInline, CollabPanel, CollabPopup, CollabProvider, CollabSocket, ConversationList, ConversationListItem, DEEP_LINK_PREFIX, EVENTS, MAX_FILE_SIZE, MAX_PINNED_MESSAGES, MESSAGES_PAGE_SIZE, MESSAGE_TYPES, MessageActionsMenu, MessageBubble, MessageInput, MessageList, ParticipantsList, PatientHeader, PinnedMessagesBar, ReplyPreview, ReplyQuoteBlock, SUPPORTED_IMAGE_TYPES, SeenByIndicator, THEME_DEFAULTS, THEME_VAR, TYPING_DEBOUNCE_MS, applyThemeOverrides, isCaseKind, isHelpKind, useAudioRecorder, useChannelSettings, useCollab, useConversation, useConversationList, useDeepLinks, useInlineCollab, useMessages, usePinnedMessages, useUnreadCount };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map