vintasend 0.4.0 → 0.4.7

package/dist/examples/vintasend-medplum-example/src/pages/patient/PatientPage.utils.test.ts

@@ -0,0 +1,223 @@
+// SPDX-FileCopyrightText: Copyright Orangebot, Inc. and Medplum contributors
+// SPDX-License-Identifier: Apache-2.0
+import type { Patient } from '@medplum/fhirtypes';
+import { describe, expect, test } from 'vitest';
+import {
+  formatPatientPageTabUrl,
+  getPatientPageTabOrThrow,
+  patientPathPrefix,
+  PatientPageTabs,
+  prependPatientPath,
+} from './PatientPage.utils';
+
+describe('PatientPage.utils', () => {
+  describe('patientPathPrefix', () => {
+    test('returns correct path prefix for patient ID', () => {
+      expect(patientPathPrefix('123')).toBe('/Patient/123');
+      expect(patientPathPrefix('patient-456')).toBe('/Patient/patient-456');
+      expect(patientPathPrefix('abc-def-ghi')).toBe('/Patient/abc-def-ghi');
+    });
+
+    test('handles empty string patient ID', () => {
+      expect(patientPathPrefix('')).toBe('/Patient/');
+    });
+  });
+
+  describe('prependPatientPath', () => {
+    const mockPatient: Patient = {
+      resourceType: 'Patient',
+      id: 'patient-123',
+    };
+
+    test('prepends patient path when patient has ID', () => {
+      expect(prependPatientPath(mockPatient, 'edit')).toBe('/Patient/patient-123/edit');
+      expect(prependPatientPath(mockPatient, '/edit')).toBe('/Patient/patient-123/edit');
+      expect(prependPatientPath(mockPatient, 'Encounter')).toBe('/Patient/patient-123/Encounter');
+    });
+
+    test('handles path without leading slash', () => {
+      expect(prependPatientPath(mockPatient, 'edit')).toBe('/Patient/patient-123/edit');
+      expect(prependPatientPath(mockPatient, 'Task')).toBe('/Patient/patient-123/Task');
+    });
+
+    test('handles path with leading slash', () => {
+      expect(prependPatientPath(mockPatient, '/edit')).toBe('/Patient/patient-123/edit');
+      expect(prependPatientPath(mockPatient, '/Encounter')).toBe('/Patient/patient-123/Encounter');
+    });
+
+    test('returns original path when patient is undefined', () => {
+      expect(prependPatientPath(undefined, 'edit')).toBe('edit');
+      expect(prependPatientPath(undefined, '/edit')).toBe('/edit');
+      expect(prependPatientPath(undefined, 'Encounter')).toBe('Encounter');
+    });
+
+    test('returns original path when patient has no ID', () => {
+      const patientWithoutId: Patient = {
+        resourceType: 'Patient',
+      };
+      expect(prependPatientPath(patientWithoutId, 'edit')).toBe('edit');
+      expect(prependPatientPath(patientWithoutId, '/edit')).toBe('/edit');
+    });
+
+    test('handles empty path string', () => {
+      expect(prependPatientPath(mockPatient, '')).toBe('/Patient/patient-123/');
+      expect(prependPatientPath(undefined, '')).toBe('');
+    });
+  });
+
+  describe('formatPatientPageTabUrl', () => {
+    test('formats URL with patient ID replacement', () => {
+      const tab = {
+        id: 'encounter',
+        url: 'Encounter?patient=%patient.id',
+        label: 'Visits',
+      };
+      expect(formatPatientPageTabUrl('patient-123', tab)).toBe('/Patient/patient-123/Encounter?patient=patient-123');
+    });
+
+    test('handles tab with empty URL', () => {
+      const tab = {
+        id: 'timeline',
+        url: '',
+        label: 'Timeline',
+      };
+      expect(formatPatientPageTabUrl('patient-456', tab)).toBe('/Patient/patient-456/');
+    });
+
+    test('handles tab URL without patient.id placeholder', () => {
+      const tab = {
+        id: 'labs',
+        url: 'labs',
+        label: 'Labs',
+      };
+      expect(formatPatientPageTabUrl('patient-789', tab)).toBe('/Patient/patient-789/labs');
+    });
+
+    test('handles multiple patient.id placeholders (replaces only first)', () => {
+      const tab = {
+        id: 'test',
+        url: 'Resource?patient=%patient.id&other=%patient.id',
+        label: 'Test',
+      };
+      // replace() only replaces the first occurrence
+      expect(formatPatientPageTabUrl('patient-123', tab)).toBe(
+        '/Patient/patient-123/Resource?patient=patient-123&other=%patient.id'
+      );
+    });
+
+    test('handles complex query string with patient.id placeholder', () => {
+      const tab = PatientPageTabs.find((t) => t.id === 'encounter');
+      if (tab) {
+        const result = formatPatientPageTabUrl('patient-123', tab);
+        expect(result).toContain('/Patient/patient-123/Encounter');
+        expect(result).toContain('patient=patient-123');
+        expect(result).not.toContain('%patient.id');
+      }
+    });
+  });
+
+  describe('getPatientPageTabOrThrow', () => {
+    test('returns tab when found', () => {
+      const timelineTab = getPatientPageTabOrThrow('timeline');
+      expect(timelineTab.id).toBe('timeline');
+      expect(timelineTab.url).toBe('');
+      expect(timelineTab.label).toBe('Timeline');
+
+      const editTab = getPatientPageTabOrThrow('edit');
+      expect(editTab.id).toBe('edit');
+      expect(editTab.url).toBe('edit');
+      expect(editTab.label).toBe('Edit');
+
+      const medsTab = getPatientPageTabOrThrow('meds');
+      expect(medsTab.id).toBe('meds');
+      expect(medsTab.label).toBe('Meds');
+    });
+
+    test('throws error when tab not found', () => {
+      expect(() => getPatientPageTabOrThrow('nonexistent')).toThrow(
+        'Could not find patient page tab with id nonexistent'
+      );
+      expect(() => getPatientPageTabOrThrow('invalid-tab')).toThrow(
+        'Could not find patient page tab with id invalid-tab'
+      );
+    });
+
+    test('finds all defined tabs', () => {
+      const tabIds = [
+        'timeline',
+        'edit',
+        'encounter',
+        'tasks',
+        'meds',
+        'labs',
+        'devices',
+        'documentreference',
+        'careplan',
+        'message',
+        'dosespot',
+        'export',
+      ];
+      for (const tabId of tabIds) {
+        const tab = getPatientPageTabOrThrow(tabId);
+        expect(tab).toBeDefined();
+        expect(tab.id).toBe(tabId);
+        expect(tab.url).toBeDefined();
+        expect(tab.label).toBeDefined();
+      }
+    });
+  });
+
+  describe('PatientPageTabs', () => {
+    test('is an array', () => {
+      expect(Array.isArray(PatientPageTabs)).toBe(true);
+    });
+
+    test('contains expected tabs', () => {
+      const tabIds = PatientPageTabs.map((tab) => tab.id);
+      expect(tabIds).toContain('timeline');
+      expect(tabIds).toContain('edit');
+      expect(tabIds).toContain('encounter');
+      expect(tabIds).toContain('tasks');
+      expect(tabIds).toContain('meds');
+      expect(tabIds).toContain('labs');
+      expect(tabIds).toContain('devices');
+      expect(tabIds).toContain('documentreference');
+      expect(tabIds).toContain('careplan');
+      expect(tabIds).toContain('message');
+      expect(tabIds).toContain('dosespot');
+      expect(tabIds).toContain('export');
+    });
+
+    test('all tabs have required properties', () => {
+      for (const tab of PatientPageTabs) {
+        expect(tab).toHaveProperty('id');
+        expect(tab).toHaveProperty('url');
+        expect(tab).toHaveProperty('label');
+        expect(typeof tab.id).toBe('string');
+        expect(typeof tab.url).toBe('string');
+        expect(typeof tab.label).toBe('string');
+      }
+    });
+
+    test('timeline tab has empty URL', () => {
+      const timelineTab = PatientPageTabs.find((tab) => tab.id === 'timeline');
+      expect(timelineTab).toBeDefined();
+      expect(timelineTab?.url).toBe('');
+    });
+
+    test('tabs with patient.id placeholder contain the placeholder', () => {
+      const tabsWithPlaceholder = PatientPageTabs.filter((tab) => tab.url.includes('%patient.id'));
+      expect(tabsWithPlaceholder.length).toBeGreaterThan(0);
+      for (const tab of tabsWithPlaceholder) {
+        expect(tab.url).toContain('%patient.id');
+      }
+    });
+
+    test('tasks tab has correct URL', () => {
+      const tasksTab = PatientPageTabs.find((tab) => tab.id === 'tasks');
+      expect(tasksTab).toBeDefined();
+      expect(tasksTab?.url).toBe('Task');
+      expect(tasksTab?.label).toBe('Tasks');
+    });
+  });
+});

package/dist/examples/vintasend-medplum-example/src/pages/patient/PatientPage.utils.ts

@@ -0,0 +1,89 @@
+// SPDX-FileCopyrightText: Copyright Orangebot, Inc. and Medplum contributors
+// SPDX-License-Identifier: Apache-2.0
+import type { Patient, ProjectMembership } from '@medplum/fhirtypes';
+import { hasDoseSpotIdentifier } from '../../components/utils';
+
+export function patientPathPrefix(patientId: string): string {
+  return `/Patient/${patientId}`;
+}
+
+export function prependPatientPath(patient: Patient | undefined, path: string): string {
+  if (patient?.id) {
+    return `${patientPathPrefix(patient.id)}${!path.startsWith('/') ? '/' : ''}${path}`;
+  }
+
+  return path;
+}
+
+export function formatPatientPageTabUrl(patientId: string, tab: PatientPageTabInfo): string {
+  return `${patientPathPrefix(patientId)}/${tab.url.replace('%patient.id', patientId)}`;
+}
+
+export type PatientPageTabInfo = {
+  id: string;
+  url: string;
+  label: string;
+};
+
+export function getPatientPageTabOrThrow(tabId: string): PatientPageTabInfo {
+  const result = PatientPageTabs.find((tab) => tab.id === tabId);
+
+  if (!result) {
+    throw new Error(`Could not find patient page tab with id ${tabId}`);
+  }
+  return result;
+}
+
+/**
+ * Returns the patient page tabs filtered based on user permissions.
+ * Currently filters out the DoseSpot tab if the user doesn't have DoseSpot access.
+ * @param membership - The current user's project membership.
+ * @returns Filtered array of patient page tabs.
+ */
+export function getPatientPageTabs(membership: ProjectMembership | undefined): PatientPageTabInfo[] {
+  const hasDoseSpot = hasDoseSpotIdentifier(membership);
+  return PatientPageTabs.filter((tab) => tab.id !== 'dosespot' || hasDoseSpot);
+}
+
+export const PatientPageTabs: PatientPageTabInfo[] = [
+  { id: 'timeline', url: '', label: 'Timeline' },
+  { id: 'edit', url: 'edit', label: 'Edit' },
+  {
+    id: 'encounter',
+    url: 'Encounter?_count=20&_fields=_lastUpdated,period,status,serviceType&_sort=-_lastUpdated&patient=%patient.id',
+    label: 'Visits',
+  },
+  {
+    id: 'tasks',
+    url: 'Task',
+    label: 'Tasks',
+  },
+  {
+    id: 'meds',
+    url: 'MedicationRequest?_fields=medication[x],intent,status&_offset=0&_sort=-_lastUpdated&patient=%patient.id',
+    label: 'Meds',
+  },
+  {
+    id: 'labs',
+    url: 'ServiceRequest',
+    label: 'Labs',
+  },
+  {
+    id: 'devices',
+    url: 'Device?_fields=manufacturer,deviceName,status,distinctIdentifier,serialNumber&_offset=0&_sort=-_lastUpdated&patient=%patient.id',
+    label: 'Devices',
+  },
+  {
+    id: 'documentreference',
+    url: 'DocumentReference?_fields=_lastUpdated,category,type,status,author&_offset=0&_sort=-_lastUpdated&patient=%patient.id',
+    label: 'Documents',
+  },
+  {
+    id: 'careplan',
+    url: 'CarePlan?_fields=_lastUpdated,status,intent,category,period&_sort=-_lastUpdated&patient=%patient.id',
+    label: 'Care Plans',
+  },
+  { id: 'message', url: 'Communication', label: 'Messages' },
+  { id: 'dosespot', url: 'dosespot', label: 'DoseSpot' },
+  { id: 'export', url: 'export', label: 'Export' },
+];

package/dist/examples/vintasend-medplum-example/src/pages/patient/PatientSearchPage.test.tsx

@@ -0,0 +1,147 @@
+// SPDX-FileCopyrightText: Copyright Orangebot, Inc. and Medplum contributors
+// SPDX-License-Identifier: Apache-2.0
+import { MantineProvider } from '@mantine/core';
+import { Notifications } from '@mantine/notifications';
+import { HomerSimpson, MockClient } from '@medplum/mock';
+import { MedplumProvider } from '@medplum/react';
+import { act, fireEvent, render, screen, waitFor } from '@testing-library/react';
+import { MemoryRouter, Routes, Route } from 'react-router';
+import { describe, expect, test, vi, beforeEach } from 'vitest';
+import { PatientSearchPage } from './PatientSearchPage';
+
+async function setup(url: string, medplum = new MockClient()): Promise<void> {
+  await act(async () => {
+    render(
+      <MedplumProvider medplum={medplum}>
+        <MemoryRouter initialEntries={[url]} initialIndex={0}>
+          <MantineProvider>
+            <Notifications />
+            <Routes>
+              <Route path="/Patient/:patientId/:resourceType" element={<PatientSearchPage />} />
+              <Route path="/Patient/:patientId/:resourceType/:resourceId" element={<div>Resource Detail</div>} />
+              <Route path="/Patient/:patientId/:resourceType/new" element={<div>New Resource</div>} />
+            </Routes>
+          </MantineProvider>
+        </MemoryRouter>
+      </MedplumProvider>
+    );
+  });
+}
+
+describe('PatientSearchPage', () => {
+  beforeEach(async () => {
+    vi.clearAllMocks();
+  });
+
+  test('Renders default page with Patient resource type', async () => {
+    await setup(`/Patient/${HomerSimpson.id}/Patient`);
+    expect(await screen.findByTestId('search-control')).toBeInTheDocument();
+  });
+
+  test('Renders with Encounter resource type', async () => {
+    await setup(`/Patient/${HomerSimpson.id}/Encounter`);
+    expect(await screen.findByTestId('search-control')).toBeInTheDocument();
+  });
+
+  test('Renders with Task resource type', async () => {
+    await setup(`/Patient/${HomerSimpson.id}/Task`);
+    expect(await screen.findByTestId('search-control')).toBeInTheDocument();
+  });
+
+  test('Renders with resourceType and fields query params', async () => {
+    await setup(`/Patient/${HomerSimpson.id}/Patient?_fields=id,_lastUpdated,name,birthDate,gender`);
+    expect(await screen.findByTestId('search-control')).toBeInTheDocument();
+  });
+
+  test('Shows loading state when patient is not available', async () => {
+    await setup('/Patient/non-existent-patient/Patient');
+    // Loading component doesn't have a test ID, check for loading indicator by class
+    await waitFor(() => {
+      const loader = document.querySelector('.mantine-Loader-root');
+      expect(loader).toBeInTheDocument();
+    });
+  });
+
+  test('Navigates to correct URL when resourceType changes', async () => {
+    await setup(`/Patient/${HomerSimpson.id}/Patient`);
+
+    await waitFor(() => {
+      expect(screen.getByTestId('search-control')).toBeInTheDocument();
+    });
+
+    // The component should navigate to the correct URL format
+    // This is tested implicitly by the component's useEffect logic
+  });
+
+  test('Next page button', async () => {
+    await setup(`/Patient/${HomerSimpson.id}/Patient`);
+    expect(await screen.findByLabelText('Next page')).toBeInTheDocument();
+
+    await act(async () => {
+      fireEvent.click(screen.getByLabelText('Next page'));
+    });
+  });
+
+  test('Prev page button', async () => {
+    await setup(`/Patient/${HomerSimpson.id}/Patient`);
+    expect(await screen.findByLabelText('Previous page')).toBeInTheDocument();
+
+    await act(async () => {
+      fireEvent.click(screen.getByLabelText('Previous page'));
+    });
+  });
+
+  test('New button navigates to new resource page', async () => {
+    await setup(`/Patient/${HomerSimpson.id}/Task`);
+    expect(await screen.findByText('New...')).toBeInTheDocument();
+
+    await act(async () => {
+      fireEvent.click(screen.getByText('New...'));
+    });
+
+    await waitFor(() => {
+      expect(screen.getByText('New Resource')).toBeInTheDocument();
+    });
+  });
+
+  test('SearchControl renders and is clickable', async () => {
+    window.open = vi.fn();
+
+    await setup(`/Patient/${HomerSimpson.id}/Patient`);
+    await waitFor(() => {
+      expect(screen.getByTestId('search-control')).toBeInTheDocument();
+    });
+
+    // Verify SearchControl is rendered and functional
+    const searchControl = screen.getByTestId('search-control');
+    expect(searchControl).toBeInTheDocument();
+  });
+
+  test('SearchControl renders with toolbar buttons', async () => {
+    await setup(`/Patient/${HomerSimpson.id}/Patient`);
+    await waitFor(() => {
+      expect(screen.getByTestId('search-control')).toBeInTheDocument();
+    });
+
+    // Verify SearchControl is rendered (toolbar buttons may or may not be visible)
+    const searchControl = screen.getByTestId('search-control');
+    expect(searchControl).toBeInTheDocument();
+  });
+
+  test('Search control has checkboxes enabled', async () => {
+    await setup(`/Patient/${HomerSimpson.id}/Patient`);
+    const searchControl = await screen.findByTestId('search-control');
+    expect(searchControl).toBeInTheDocument();
+    // Checkboxes should be enabled (tested implicitly through SearchControl rendering)
+  });
+
+  test('Handles search with offset and count', async () => {
+    await setup(`/Patient/${HomerSimpson.id}/Patient?_offset=10&_count=20`);
+    expect(await screen.findByTestId('search-control')).toBeInTheDocument();
+  });
+
+  test('Handles search with filters', async () => {
+    await setup(`/Patient/${HomerSimpson.id}/Patient?name=Homer`);
+    expect(await screen.findByTestId('search-control')).toBeInTheDocument();
+  });
+});

package/dist/examples/vintasend-medplum-example/src/pages/patient/PatientSearchPage.tsx

@@ -0,0 +1,79 @@
+// SPDX-FileCopyrightText: Copyright Orangebot, Inc. and Medplum contributors
+// SPDX-License-Identifier: Apache-2.0
+import { Paper } from '@mantine/core';
+import { DEFAULT_SEARCH_COUNT, formatSearchQuery, parseSearchRequest } from '@medplum/core';
+import type { SearchRequest } from '@medplum/core';
+import { Loading, SearchControl, useMedplum } from '@medplum/react';
+import { useEffect, useState } from 'react';
+import type { JSX } from 'react';
+import { useLocation, useNavigate } from 'react-router';
+import { usePatient } from '../../hooks/usePatient';
+import { useResourceType } from '../resource/useResourceType';
+import { prependPatientPath } from './PatientPage.utils';
+
+export function PatientSearchPage(): JSX.Element {
+  const medplum = useMedplum();
+  const patient = usePatient();
+  const navigate = useNavigate();
+  const location = useLocation();
+  const [search, setSearch] = useState<SearchRequest>();
+
+  useResourceType(search?.resourceType, { onInvalidResourceType: () => navigate('..')?.catch(console.error) });
+
+  useEffect(() => {
+    if (!patient) {
+      return;
+    }
+
+    const parsedSearch = parseSearchRequest(location.pathname + location.search);
+    const populatedSearch = addDefaultSearchValues(parsedSearch);
+
+    if (
+      location.pathname === `/Patient/${patient.id}/${populatedSearch.resourceType}` &&
+      location.search === formatSearchQuery(populatedSearch)
+    ) {
+      setSearch(populatedSearch);
+    } else {
+      navigate(`/Patient/${patient.id}/${populatedSearch.resourceType}${formatSearchQuery(populatedSearch)}`)?.catch(
+        console.error
+      );
+    }
+  }, [medplum, patient, navigate, location]);
+
+  if (!patient || !search?.resourceType || !search.fields || search.fields.length === 0) {
+    return <Loading />;
+  }
+
+  return (
+    <Paper shadow="xs" m="md" p="xs">
+      <SearchControl
+        checkboxesEnabled={true}
+        search={search}
+        onClick={(e) =>
+          navigate(`/Patient/${patient.id}/${e.resource.resourceType}/${e.resource.id}`)?.catch(console.error)
+        }
+        onAuxClick={(e) => window.open(`/Patient/${patient.id}/${e.resource.resourceType}/${e.resource.id}`, '_blank')}
+        onNew={() => {
+          navigate(prependPatientPath(patient, `/${search.resourceType}/new`))?.catch(console.error);
+        }}
+        onChange={(e) => {
+          navigate(`/Patient/${patient.id}/${search.resourceType}${formatSearchQuery(e.definition)}`)?.catch(
+            console.error
+          );
+        }}
+      />
+    </Paper>
+  );
+}
+
+function addDefaultSearchValues(search: SearchRequest): SearchRequest {
+  const fields = search.fields ?? ['_id', '_lastUpdated'];
+  const offset = search.offset ?? 0;
+  const count = search.count ?? DEFAULT_SEARCH_COUNT;
+  return {
+    ...search,
+    fields,
+    offset,
+    count,
+  };
+}

package/dist/examples/vintasend-medplum-example/src/pages/patient/PatientTabsNavigation.tsx

@@ -0,0 +1,35 @@
+// SPDX-FileCopyrightText: Copyright Orangebot, Inc. and Medplum contributors
+// SPDX-License-Identifier: Apache-2.0
+import { Paper, Tabs } from '@mantine/core';
+import type { JSX } from 'react';
+import type { PatientPageTabInfo } from './PatientPage.utils';
+
+interface PatientTabsNavigationProps {
+  tabs: PatientPageTabInfo[];
+  currentTab: string;
+  onTabChange: (value: string | null) => void;
+}
+
+export function PatientTabsNavigation({ tabs, currentTab, onTabChange }: PatientTabsNavigationProps): JSX.Element {
+  return (
+    <Paper w="100%">
+      <Tabs value={currentTab.toLowerCase()} onChange={onTabChange}>
+        <Tabs.List
+          style={{
+            display: 'flex',
+            width: '100%',
+            overflowX: 'auto',
+            overflowY: 'hidden',
+            flexWrap: 'nowrap',
+          }}
+        >
+          {tabs.map((t) => (
+            <Tabs.Tab key={t.id} value={t.id}>
+              {t.label}
+            </Tabs.Tab>
+          ))}
+        </Tabs.List>
+      </Tabs>
+    </Paper>
+  );
+}