@natoe/colab 0.1.28 → 0.1.31

package/dist/index.d.mts

@@ -119,25 +119,40 @@ interface PatientData {
     bodyParts?: string[];
 }
 /**
- * Which thread on a case this is.
+ * What a thread is about — and, crucially, what it is SCOPED to.
  *
- *  - `case`             — the shared discussion: lab, radiologist, physician, admin
- *  - `help_lab`         — imaging center <-> Natoe support, private to that side
- *  - `help_radiologist` — assigned radiologist <-> Natoe support, private to that side
+ *  - `case`     — the discussion about one clinical order. Scoped to an order,
+ *                 so `orderId` is always set. Lab, radiologist, physician, admin.
+ *  - `help_lab` — an imaging centre's help channel with Natoe support. Scoped to
+ *                 the LAB, not to any case: it has NO `orderId`, it outlives
+ *                 every order, and there is exactly one per imaging centre.
  *
- * The two help kinds are mutually invisible. That isolation is enforced by the
- * backend's participant seeding, never by anything in this package — treat this
- * as a label for rendering and for addressing the right thread, not as a
- * security boundary.
+ * `help_lab` was briefly modelled as per-case (one help thread per order). It is
+ * now per-lab, so support gets one continuous thread with each imaging centre
+ * rather than N short-lived ones scattered across cases. A case can still be
+ * referenced from inside the channel; it just no longer scopes it.
+ *
+ * Isolation — who can see a help channel — is enforced by the backend's
+ * participant seeding, never by anything in this package. Treat this as a label
+ * for rendering and for addressing the right thread, not as a security boundary.
  *
  * Optional everywhere, defaulting to `case`, so callers written before help
- * threads existed keep their exact previous behaviour.
+ * channels existed keep their exact previous behaviour.
  */
-type ConversationKind = 'case' | 'help_lab' | 'help_radiologist';
+type ConversationKind = 'case' | 'help_lab';
 declare function isHelpKind(kind?: ConversationKind | string): boolean;
+/**
+ * True when a thread is scoped to an order and therefore has patient context to
+ * render. Prefer this over testing `orderId` directly: a help channel has no
+ * order, so every patient-shaped affordance must be skipped for it.
+ */
+declare function isCaseKind(kind?: ConversationKind | string): boolean;
 interface Conversation {
     id: string;
-    orderId: string;
+    /** Absent on a help channel — that thread belongs to a lab, not an order. */
+    orderId?: string;
+    /** Set only on a help channel: the imaging centre that owns it. */
+    labUserId?: string;
     name: string;
     kind?: ConversationKind;
     picture?: string;
@@ -146,7 +161,8 @@ interface Conversation {
     unreadCount: number;
     createdAt: string;
     updatedAt: string;
-    /** Denormalized patient data snapshot — lets UI render without extra fetch */
+    /** Denormalized patient data snapshot — lets UI render without extra fetch.
+     *  Always absent on a help channel: there is no patient. */
     patientSnapshot?: PatientData;
     /** Currently pinned messages (max 3) */
     pinnedMessages?: Message[];
@@ -157,10 +173,12 @@ interface Conversation {
  */
 interface ConversationListItem$1 {
     id: string;
-    orderId: string;
+    /** Absent on a help channel — see `Conversation.orderId`. */
+    orderId?: string;
+    labUserId?: string;
     name: string;
-    /** Lets the inbox label help threads distinctly from the case thread on the
-     *  same patient — both appear as separate rows. */
+    /** Lets the inbox render the lab's help channel distinctly from its case
+     *  threads — they appear as separate rows. */
     kind?: ConversationKind;
     picture?: string;
     unreadCount: number;
@@ -285,10 +303,15 @@ interface InviteUserPayload {
 }
 
 interface CollabPanelProps {
-    /** Order ID — one conversation per study */
-    orderId: string;
-    /** Patient/study data displayed in the header */
-    patientData: PatientData;
+    /** Order this thread belongs to. Required for a `case` thread; omitted for a
+     *  help channel, which belongs to a lab rather than an order. */
+    orderId?: string;
+    /** A thread the caller already resolved — how a help channel is opened.
+     *  Skips the order-keyed preview lookup entirely. */
+    conversation?: Conversation | null;
+    /** Patient/study data displayed in the header. Absent on a help channel:
+     *  there is no patient, and the header renders its support variant instead. */
+    patientData?: PatientData;
     /** Participant user IDs — only used when creating a brand-new conversation */
     participantIds?: string[];
     /** Which thread on the case. Defaults to the shared `case` thread. */
@@ -343,13 +366,16 @@ interface CollabPanelProps {
  * Full collaboration panel: patient header + pinned bar + message thread + input.
  * Supports reply, pin/unpin, and (optionally) seen-by indicators.
  */
-declare function CollabPanel({ orderId, patientData, participantIds, kind, showSeenBy, onBack, hidePatientName, hideOpenCase, onConversationChange, themeMode, showSettings: controlledShowSettings, onSettingsChange, className, style, }: CollabPanelProps): react_jsx_runtime.JSX.Element;
+declare function CollabPanel({ orderId, conversation: providedConversation, patientData, participantIds, kind, showSeenBy, onBack, hidePatientName, hideOpenCase, onConversationChange, themeMode, showSettings: controlledShowSettings, onSettingsChange, className, style, }: CollabPanelProps): react_jsx_runtime.JSX.Element;
 
 interface CollabPopupProps {
-    /** Order ID for this conversation */
-    orderId: string;
+    /** Order this thread belongs to. Required for a `case` thread; omitted for a
+     *  help channel, which belongs to a lab rather than an order. */
+    orderId?: string;
+    /** A thread the caller already resolved — how a help channel is opened. */
+    conversation?: Conversation | null;
     /** Patient/study data */
-    patientData: PatientData;
+    patientData?: PatientData;
     /** Participant user IDs — only used when creating a brand-new conversation */
     participantIds?: string[];
     /** Which thread on the case. Defaults to the shared `case` thread. */
@@ -383,7 +409,7 @@ interface CollabPopupProps {
  * Draggable floating chat popup — drop-in replacement for DraggableChatPopup.
  * Renders a CollabPanel inside a movable, resizable container.
  */
-declare function CollabPopup({ orderId, patientData, participantIds, kind, isOpen, onClose, onBack, onMinimize, initialPosition, width, height, className, }: CollabPopupProps): react_jsx_runtime.JSX.Element | null;
+declare function CollabPopup({ orderId, conversation: providedConversation, patientData, participantIds, kind, isOpen, onClose, onBack, onMinimize, initialPosition, width, height, className, }: CollabPopupProps): react_jsx_runtime.JSX.Element | null;
 
 type ColabInlineMode = 'light' | 'dark';
 interface CollabInlineProps {
@@ -635,19 +661,36 @@ interface CollabProviderProps {
 declare function CollabProvider({ config, apiBaseUrl, children }: CollabProviderProps): react_jsx_runtime.JSX.Element | null;
 
 interface UseConversationOptions {
-    orderId: string;
-    patientData: PatientData;
+    /**
+     * The order this thread belongs to. Required for a `case` thread, which is
+     * created lazily on first message and resolved by an order-keyed preview.
+     * Omitted for a help channel — that belongs to a lab, not an order.
+     */
+    orderId?: string;
+    /**
+     * A thread the caller has ALREADY resolved, opened directly instead of being
+     * looked up by order.
+     *
+     * This is how a help channel opens. The backend's `GET /help_channel` does
+     * the get-or-create and hands back the conversation, so there is nothing to
+     * look up and nothing to lazily create — passing it here skips the preview
+     * request entirely. The preview endpoint is order-keyed and could not serve
+     * an order-less thread in any case.
+     */
+    conversation?: Conversation | null;
+    /** Patient/study context. Absent on a help channel — there is no patient. */
+    patientData?: PatientData;
     /** Participant user IDs used only when creating a brand-new conversation */
     participantIds?: string[];
     /** Load full history on mount (default true) */
     loadHistory?: boolean;
     /**
-     * Which thread on the case to open. Defaults to the shared `case` thread,
-     * so every existing caller is unaffected.
+     * What this thread is. Defaults to the shared `case` thread, so every
+     * existing caller is unaffected.
      *
-     * For a help kind the backend seats only the requesting side plus Natoe
-     * support, and `participantIds` is ignored server-side — a help thread
-     * must never be widened by the client.
+     * For `help_lab` the backend seats only the imaging centre plus Natoe
+     * support, and `participantIds` is ignored server-side — a help channel must
+     * never be widened by the client.
      */
     kind?: ConversationKind;
 }
@@ -684,7 +727,7 @@ interface UseConversationReturn {
  * when the user sends the first message. If a conversation already exists for
  * the given orderId, it's loaded and joined automatically.
  */
-declare function useConversation({ orderId, patientData, participantIds, loadHistory, kind, }: UseConversationOptions): UseConversationReturn;
+declare function useConversation({ orderId, conversation: providedConversation, patientData, participantIds, loadHistory, kind, }: UseConversationOptions): UseConversationReturn;
 
 interface UseConversationListOptions {
     /**
@@ -950,6 +993,13 @@ interface PatientHeaderProps {
     hideName?: boolean;
     /** Override the displayed name — use the stored conversation.name to avoid reconstructing from patientData components */
     displayName?: string;
+    /**
+     * Render the support variant: a help channel has no patient, no study and no
+     * case, so the demographics line and every case-level action are suppressed
+     * and the title is the channel name. Without this the header would show a
+     * row of empty fields and a dead "View DICOM" button.
+     */
+    isSupportChannel?: boolean;
     className?: string;
 }
 /**
@@ -967,7 +1017,7 @@ interface PatientHeaderProps {
  * When `hideName=true` (CollabPopup wraps the conversation in its own
  * window title), only the meta + actions row renders.
  */
-declare function PatientHeader({ patientData, participants, onOpenDicom, onOpenCase, onOpenSettings, onBack, hideName, displayName, className, }: PatientHeaderProps): react_jsx_runtime.JSX.Element;
+declare function PatientHeader({ patientData, participants, onOpenDicom, onOpenCase, onOpenSettings, onBack, hideName, displayName, isSupportChannel, className, }: PatientHeaderProps): react_jsx_runtime.JSX.Element;
 
 interface MessageListHandle {
     /** Scroll to a specific message by ID (used by pin jump-to) */
@@ -1230,4 +1280,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, 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, 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

@@ -119,25 +119,40 @@ interface PatientData {
     bodyParts?: string[];
 }
 /**
- * Which thread on a case this is.
+ * What a thread is about — and, crucially, what it is SCOPED to.
  *
- *  - `case`             — the shared discussion: lab, radiologist, physician, admin
- *  - `help_lab`         — imaging center <-> Natoe support, private to that side
- *  - `help_radiologist` — assigned radiologist <-> Natoe support, private to that side
+ *  - `case`     — the discussion about one clinical order. Scoped to an order,
+ *                 so `orderId` is always set. Lab, radiologist, physician, admin.
+ *  - `help_lab` — an imaging centre's help channel with Natoe support. Scoped to
+ *                 the LAB, not to any case: it has NO `orderId`, it outlives
+ *                 every order, and there is exactly one per imaging centre.
  *
- * The two help kinds are mutually invisible. That isolation is enforced by the
- * backend's participant seeding, never by anything in this package — treat this
- * as a label for rendering and for addressing the right thread, not as a
- * security boundary.
+ * `help_lab` was briefly modelled as per-case (one help thread per order). It is
+ * now per-lab, so support gets one continuous thread with each imaging centre
+ * rather than N short-lived ones scattered across cases. A case can still be
+ * referenced from inside the channel; it just no longer scopes it.
+ *
+ * Isolation — who can see a help channel — is enforced by the backend's
+ * participant seeding, never by anything in this package. Treat this as a label
+ * for rendering and for addressing the right thread, not as a security boundary.
  *
  * Optional everywhere, defaulting to `case`, so callers written before help
- * threads existed keep their exact previous behaviour.
+ * channels existed keep their exact previous behaviour.
  */
-type ConversationKind = 'case' | 'help_lab' | 'help_radiologist';
+type ConversationKind = 'case' | 'help_lab';
 declare function isHelpKind(kind?: ConversationKind | string): boolean;
+/**
+ * True when a thread is scoped to an order and therefore has patient context to
+ * render. Prefer this over testing `orderId` directly: a help channel has no
+ * order, so every patient-shaped affordance must be skipped for it.
+ */
+declare function isCaseKind(kind?: ConversationKind | string): boolean;
 interface Conversation {
     id: string;
-    orderId: string;
+    /** Absent on a help channel — that thread belongs to a lab, not an order. */
+    orderId?: string;
+    /** Set only on a help channel: the imaging centre that owns it. */
+    labUserId?: string;
     name: string;
     kind?: ConversationKind;
     picture?: string;
@@ -146,7 +161,8 @@ interface Conversation {
     unreadCount: number;
     createdAt: string;
     updatedAt: string;
-    /** Denormalized patient data snapshot — lets UI render without extra fetch */
+    /** Denormalized patient data snapshot — lets UI render without extra fetch.
+     *  Always absent on a help channel: there is no patient. */
     patientSnapshot?: PatientData;
     /** Currently pinned messages (max 3) */
     pinnedMessages?: Message[];
@@ -157,10 +173,12 @@ interface Conversation {
  */
 interface ConversationListItem$1 {
     id: string;
-    orderId: string;
+    /** Absent on a help channel — see `Conversation.orderId`. */
+    orderId?: string;
+    labUserId?: string;
     name: string;
-    /** Lets the inbox label help threads distinctly from the case thread on the
-     *  same patient — both appear as separate rows. */
+    /** Lets the inbox render the lab's help channel distinctly from its case
+     *  threads — they appear as separate rows. */
     kind?: ConversationKind;
     picture?: string;
     unreadCount: number;
@@ -285,10 +303,15 @@ interface InviteUserPayload {
 }
 
 interface CollabPanelProps {
-    /** Order ID — one conversation per study */
-    orderId: string;
-    /** Patient/study data displayed in the header */
-    patientData: PatientData;
+    /** Order this thread belongs to. Required for a `case` thread; omitted for a
+     *  help channel, which belongs to a lab rather than an order. */
+    orderId?: string;
+    /** A thread the caller already resolved — how a help channel is opened.
+     *  Skips the order-keyed preview lookup entirely. */
+    conversation?: Conversation | null;
+    /** Patient/study data displayed in the header. Absent on a help channel:
+     *  there is no patient, and the header renders its support variant instead. */
+    patientData?: PatientData;
     /** Participant user IDs — only used when creating a brand-new conversation */
     participantIds?: string[];
     /** Which thread on the case. Defaults to the shared `case` thread. */
@@ -343,13 +366,16 @@ interface CollabPanelProps {
  * Full collaboration panel: patient header + pinned bar + message thread + input.
  * Supports reply, pin/unpin, and (optionally) seen-by indicators.
  */
-declare function CollabPanel({ orderId, patientData, participantIds, kind, showSeenBy, onBack, hidePatientName, hideOpenCase, onConversationChange, themeMode, showSettings: controlledShowSettings, onSettingsChange, className, style, }: CollabPanelProps): react_jsx_runtime.JSX.Element;
+declare function CollabPanel({ orderId, conversation: providedConversation, patientData, participantIds, kind, showSeenBy, onBack, hidePatientName, hideOpenCase, onConversationChange, themeMode, showSettings: controlledShowSettings, onSettingsChange, className, style, }: CollabPanelProps): react_jsx_runtime.JSX.Element;
 
 interface CollabPopupProps {
-    /** Order ID for this conversation */
-    orderId: string;
+    /** Order this thread belongs to. Required for a `case` thread; omitted for a
+     *  help channel, which belongs to a lab rather than an order. */
+    orderId?: string;
+    /** A thread the caller already resolved — how a help channel is opened. */
+    conversation?: Conversation | null;
     /** Patient/study data */
-    patientData: PatientData;
+    patientData?: PatientData;
     /** Participant user IDs — only used when creating a brand-new conversation */
     participantIds?: string[];
     /** Which thread on the case. Defaults to the shared `case` thread. */
@@ -383,7 +409,7 @@ interface CollabPopupProps {
  * Draggable floating chat popup — drop-in replacement for DraggableChatPopup.
  * Renders a CollabPanel inside a movable, resizable container.
  */
-declare function CollabPopup({ orderId, patientData, participantIds, kind, isOpen, onClose, onBack, onMinimize, initialPosition, width, height, className, }: CollabPopupProps): react_jsx_runtime.JSX.Element | null;
+declare function CollabPopup({ orderId, conversation: providedConversation, patientData, participantIds, kind, isOpen, onClose, onBack, onMinimize, initialPosition, width, height, className, }: CollabPopupProps): react_jsx_runtime.JSX.Element | null;
 
 type ColabInlineMode = 'light' | 'dark';
 interface CollabInlineProps {
@@ -635,19 +661,36 @@ interface CollabProviderProps {
 declare function CollabProvider({ config, apiBaseUrl, children }: CollabProviderProps): react_jsx_runtime.JSX.Element | null;
 
 interface UseConversationOptions {
-    orderId: string;
-    patientData: PatientData;
+    /**
+     * The order this thread belongs to. Required for a `case` thread, which is
+     * created lazily on first message and resolved by an order-keyed preview.
+     * Omitted for a help channel — that belongs to a lab, not an order.
+     */
+    orderId?: string;
+    /**
+     * A thread the caller has ALREADY resolved, opened directly instead of being
+     * looked up by order.
+     *
+     * This is how a help channel opens. The backend's `GET /help_channel` does
+     * the get-or-create and hands back the conversation, so there is nothing to
+     * look up and nothing to lazily create — passing it here skips the preview
+     * request entirely. The preview endpoint is order-keyed and could not serve
+     * an order-less thread in any case.
+     */
+    conversation?: Conversation | null;
+    /** Patient/study context. Absent on a help channel — there is no patient. */
+    patientData?: PatientData;
     /** Participant user IDs used only when creating a brand-new conversation */
     participantIds?: string[];
     /** Load full history on mount (default true) */
     loadHistory?: boolean;
     /**
-     * Which thread on the case to open. Defaults to the shared `case` thread,
-     * so every existing caller is unaffected.
+     * What this thread is. Defaults to the shared `case` thread, so every
+     * existing caller is unaffected.
      *
-     * For a help kind the backend seats only the requesting side plus Natoe
-     * support, and `participantIds` is ignored server-side — a help thread
-     * must never be widened by the client.
+     * For `help_lab` the backend seats only the imaging centre plus Natoe
+     * support, and `participantIds` is ignored server-side — a help channel must
+     * never be widened by the client.
      */
     kind?: ConversationKind;
 }
@@ -684,7 +727,7 @@ interface UseConversationReturn {
  * when the user sends the first message. If a conversation already exists for
  * the given orderId, it's loaded and joined automatically.
  */
-declare function useConversation({ orderId, patientData, participantIds, loadHistory, kind, }: UseConversationOptions): UseConversationReturn;
+declare function useConversation({ orderId, conversation: providedConversation, patientData, participantIds, loadHistory, kind, }: UseConversationOptions): UseConversationReturn;
 
 interface UseConversationListOptions {
     /**
@@ -950,6 +993,13 @@ interface PatientHeaderProps {
     hideName?: boolean;
     /** Override the displayed name — use the stored conversation.name to avoid reconstructing from patientData components */
     displayName?: string;
+    /**
+     * Render the support variant: a help channel has no patient, no study and no
+     * case, so the demographics line and every case-level action are suppressed
+     * and the title is the channel name. Without this the header would show a
+     * row of empty fields and a dead "View DICOM" button.
+     */
+    isSupportChannel?: boolean;
     className?: string;
 }
 /**
@@ -967,7 +1017,7 @@ interface PatientHeaderProps {
  * When `hideName=true` (CollabPopup wraps the conversation in its own
  * window title), only the meta + actions row renders.
  */
-declare function PatientHeader({ patientData, participants, onOpenDicom, onOpenCase, onOpenSettings, onBack, hideName, displayName, className, }: PatientHeaderProps): react_jsx_runtime.JSX.Element;
+declare function PatientHeader({ patientData, participants, onOpenDicom, onOpenCase, onOpenSettings, onBack, hideName, displayName, isSupportChannel, className, }: PatientHeaderProps): react_jsx_runtime.JSX.Element;
 
 interface MessageListHandle {
     /** Scroll to a specific message by ID (used by pin jump-to) */
@@ -1230,4 +1280,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, 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, 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

@@ -891,6 +891,7 @@ function cleanChannelName(name) {
 // src/hooks/useConversation.ts
 function useConversation({
   orderId,
+  conversation: providedConversation,
   patientData,
   participantIds = [],
   loadHistory = true,
@@ -923,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 });
     },
@@ -1022,6 +1024,28 @@ function useConversation({
       setIsLoading(true);
       setError(null);
       try {
+        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) {
@@ -1083,6 +1107,12 @@ function useConversation({
   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 };
@@ -1570,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;
@@ -4535,6 +4569,7 @@ var DARK_THEME_OVERRIDES = {
 };
 function CollabPanel({
   orderId,
+  conversation: providedConversation,
   patientData,
   participantIds,
   kind,
@@ -4576,7 +4611,13 @@ function CollabPanel({
     loadMoreMessages,
     pinMessage,
     unpinMessage
-  } = useConversation({ orderId, patientData, participantIds, kind });
+  } = useConversation({
+    orderId,
+    conversation: providedConversation,
+    patientData,
+    participantIds,
+    kind
+  });
   React4.useEffect(() => {
     onConversationChange?.(conversation);
   }, [conversation, onConversationChange]);
@@ -4585,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);
   };
@@ -4662,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,
@@ -4793,6 +4835,7 @@ ensureGlobalStyles();
 var FOCUSABLE_SELECTOR = 'a[href], button:not([disabled]), textarea:not([disabled]), input:not([disabled]), select:not([disabled]), [tabindex]:not([tabindex="-1"])';
 function CollabPopup({
   orderId,
+  conversation: providedConversation,
   patientData,
   participantIds,
   kind,
@@ -4819,7 +4862,7 @@ function CollabPopup({
   const containerRef = React4.useRef(null);
   const previouslyFocused = React4.useRef(null);
   const titleId = React4.useId();
-  const titleText = cleanChannelName(loadedConversation?.name) || buildChannelName(patientData);
+  const titleText = cleanChannelName(loadedConversation?.name) || (patientData ? buildChannelName(patientData) : "Natoe Support");
   const handleMouseDown = React4.useCallback(
     (e) => {
       if (!e.target.closest("[data-drag-handle]")) return;
@@ -4924,8 +4967,9 @@ function CollabPopup({
             }
           ),
           /* @__PURE__ */ jsxRuntime.jsxs("div", { style: styles13.titleCenter, children: [
-            /* @__PURE__ */ jsxRuntime.jsx("h2", { id: titleId, style: styles13.patientName, children: patientData.patientName || titleText }),
+            /* @__PURE__ */ jsxRuntime.jsx("h2", { id: titleId, style: styles13.patientName, children: patientData?.patientName || titleText }),
             (() => {
+              if (!patientData) return /* @__PURE__ */ jsxRuntime.jsx("div", { style: styles13.subRow, children: /* @__PURE__ */ jsxRuntime.jsx("span", { style: styles13.metaText, children: "Help and support" }) });
               const parts = [];
               if (patientData.patientAge) parts.push(String(patientData.patientAge));
               if (patientData.patientSex) parts.push(String(patientData.patientSex));
@@ -4982,6 +5026,7 @@ function CollabPopup({
           CollabPanel,
           {
             orderId,
+            conversation: providedConversation,
             patientData,
             participantIds,
             kind,
@@ -5901,7 +5946,10 @@ function useConversationList(options) {
 
 // src/core/types.ts
 function isHelpKind(kind) {
-  return kind === "help_lab" || kind === "help_radiologist";
+  return kind === "help_lab";
+}
+function isCaseKind(kind) {
+  return kind === void 0 || kind === "case";
 }
 function ConversationListItem({
   item,
@@ -6537,6 +6585,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 {
@@ -6874,6 +6923,7 @@ 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;