@natoe/colab 0.1.27 → 0.1.30

package/dist/index.js

@@ -582,6 +582,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 = React4.createContext(null);
 function useCollab() {
   const context = React4.useContext(CollabContext);
@@ -597,7 +607,7 @@ function CollabProvider({ config, apiBaseUrl, children }) {
   });
   const [unreadCounts, setUnreadCounts] = React4.useState({});
   const [unreadCountsByOrder, setUnreadCountsByOrder] = React4.useState({});
-  const pendingOrderIds = React4.useRef(/* @__PURE__ */ new Set());
+  const pendingKeys = React4.useRef(/* @__PURE__ */ new Set());
   const pendingResolvers = React4.useRef(/* @__PURE__ */ new Map());
   const previewCache = React4.useRef(/* @__PURE__ */ new Map());
   const batchScheduled = React4.useRef(false);
@@ -628,47 +638,61 @@ function CollabProvider({ config, apiBaseUrl, children }) {
     [config]
   );
   const flushPreviewBatch = React4.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 = React4.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);
@@ -677,8 +701,16 @@ function CollabProvider({ config, apiBaseUrl, children }) {
     },
     [flushPreviewBatch]
   );
-  const invalidatePreview = React4.useCallback((orderId) => {
-    previewCache.current.delete(orderId);
+  const invalidatePreview = React4.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 = React4.useCallback(
     async (conversationId, options = {}) => {
@@ -705,11 +737,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 ?? []
@@ -721,7 +759,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]
@@ -853,9 +891,11 @@ function cleanChannelName(name) {
 // src/hooks/useConversation.ts
 function useConversation({
   orderId,
+  conversation: providedConversation,
   patientData,
   participantIds = [],
-  loadHistory = true
+  loadHistory = true,
+  kind = "case"
 }) {
   const {
     socket,
@@ -884,6 +924,7 @@ function useConversation({
   const markedReadIdsRef = React4.useRef(/* @__PURE__ */ new Set());
   const buildName = React4.useCallback(
     () => {
+      if (!patientData) return "";
       const labName = patientData.labName ?? (config.userRole === "lab" ? config.userName : void 0);
       return buildChannelName({ ...patientData, labName });
     },
@@ -983,7 +1024,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);
@@ -1040,10 +1103,16 @@ function useConversation({
       markedReadIdsRef.current.clear();
       setIsConnected(false);
     };
-  }, [orderId]);
+  }, [orderId, kind]);
   const ensureConversation = React4.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 };
@@ -1051,13 +1120,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) => {
@@ -1087,6 +1157,7 @@ function useConversation({
       conversation,
       createConversationWithMessage,
       orderId,
+      kind,
       buildName,
       participantIds,
       joinChannel,
@@ -1529,15 +1600,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;
@@ -4494,8 +4569,10 @@ var DARK_THEME_OVERRIDES = {
 };
 function CollabPanel({
   orderId,
+  conversation: providedConversation,
   patientData,
   participantIds,
+  kind,
   showSeenBy = true,
   onBack,
   hidePatientName = false,
@@ -4534,7 +4611,13 @@ function CollabPanel({
     loadMoreMessages,
     pinMessage,
     unpinMessage
-  } = useConversation({ orderId, patientData, participantIds });
+  } = useConversation({
+    orderId,
+    conversation: providedConversation,
+    patientData,
+    participantIds,
+    kind
+  });
   React4.useEffect(() => {
     onConversationChange?.(conversation);
   }, [conversation, onConversationChange]);
@@ -4543,11 +4626,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);
   };
@@ -4620,7 +4703,8 @@ function CollabPanel({
       /* @__PURE__ */ jsxRuntime.jsx(
         PatientHeader,
         {
-          patientData,
+          patientData: patientData ?? { orderId: "", patientName: conversation?.name ?? "Natoe Support" },
+          isSupportChannel: !patientData,
           participants,
           onOpenDicom: handleOpenDicom,
           onOpenCase: handleOpenCase,
@@ -4753,6 +4837,7 @@ function CollabPopup({
   orderId,
   patientData,
   participantIds,
+  kind,
   isOpen,
   onClose,
   onBack,
@@ -4941,6 +5026,7 @@ function CollabPopup({
             orderId,
             patientData,
             participantIds,
+            kind,
             hidePatientName: true,
             onConversationChange: setLoadedConversation,
             showSettings,
@@ -5058,7 +5144,8 @@ function useInlineCollab({
   orderId,
   patientData,
   participantIds = [],
-  messageLimit = 5
+  messageLimit = 5,
+  kind = "case"
 }) {
   const {
     socket,
@@ -5106,7 +5193,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) {
@@ -5202,7 +5289,8 @@ function useInlineCollab({
         try {
           const result = await createConversationWithMessage(orderId, payload, {
             name: buildName(),
-            participantIds
+            participantIds,
+            kind
           });
           const newPreview = {
             conversationId: result.conversation.id,
@@ -5216,7 +5304,7 @@ function useInlineCollab({
           setPreview(newPreview);
           setMessages([result.message]);
           setParticipants(result.conversation.participants);
-          invalidatePreview(orderId);
+          invalidatePreview(orderId, kind);
           if (elementRef.current) {
             subscribe(result.conversation.id);
           }
@@ -5341,6 +5429,7 @@ function CollabInline({
   orderId,
   patientData,
   participantIds,
+  kind,
   onExpand,
   messageLimit = 1,
   placeholder = "Discuss this case\u2026",
@@ -5359,7 +5448,7 @@ function CollabInline({
     sendMessage,
     sendAudioMessage,
     containerRef
-  } = useInlineCollab({ orderId, patientData, participantIds, messageLimit });
+  } = useInlineCollab({ orderId, patientData, participantIds, messageLimit, kind });
   const containerStyle = {
     ...styles14.container,
     backgroundColor: pal.bg,
@@ -5851,6 +5940,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,
@@ -5887,6 +5984,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__ */ jsxRuntime.jsx("span", { style: styles15.helpPill, "aria-label": "Help thread", children: "Help" }),
             /* @__PURE__ */ jsxRuntime.jsx(
               "span",
               {
@@ -6033,6 +6134,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,
@@ -6470,6 +6582,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 {
@@ -6807,6 +6920,8 @@ exports.THEME_DEFAULTS = THEME_DEFAULTS;
 exports.THEME_VAR = THEME_VAR;
 exports.TYPING_DEBOUNCE_MS = TYPING_DEBOUNCE_MS;
 exports.applyThemeOverrides = applyThemeOverrides;
+exports.isCaseKind = isCaseKind;
+exports.isHelpKind = isHelpKind;
 exports.useAudioRecorder = useAudioRecorder;
 exports.useChannelSettings = useChannelSettings;
 exports.useCollab = useCollab;