vintasend 0.4.0 → 0.4.7

package/dist/examples/vintasend-medplum-example/src/pages/integrations/FavoriteMedicationsTable.tsx

@@ -0,0 +1,76 @@
+// SPDX-FileCopyrightText: Copyright Orangebot, Inc. and Medplum contributors
+// SPDX-License-Identifier: Apache-2.0
+import React from 'react';
+import { Table, Card, Text, LoadingOverlay } from '@mantine/core';
+import type { MedicationKnowledge } from '@medplum/fhirtypes';
+import { getCodeBySystem, NDC, RXNORM } from '@medplum/core';
+import { getMedicationName } from '@medplum/dosespot-react';
+
+interface FavoriteMedicationsTableProps {
+  clinicFavoriteMedications: MedicationKnowledge[] | undefined;
+  loadingFavorites?: boolean;
+}
+
+/**
+ * This is a demo component for how you could display your favorite Medications
+ * from DoseSpot.
+ *
+ * The page is refreshed when a medication is added to the favorites list.
+ *
+ * @param props - The props for the component.
+ * @param props.clinicFavoriteMedications - The clinic favorite medications to display.
+ * @param props.loadingFavorites - Whether the table is loading.
+ * @returns A React component that displays the favorite medications.
+ */
+export function FavoriteMedicationsTable({
+  clinicFavoriteMedications,
+  loadingFavorites,
+}: FavoriteMedicationsTableProps): React.JSX.Element {
+  if (loadingFavorites) {
+    return (
+      <Card withBorder p="xl">
+        <LoadingOverlay visible={true} />
+      </Card>
+    );
+  }
+
+  if (!clinicFavoriteMedications || clinicFavoriteMedications.length === 0) {
+    return (
+      <Text c="dimmed" ta="center" py="xl">
+        No favorite medications found
+      </Text>
+    );
+  }
+
+  return (
+    <Table>
+      <Table.Thead>
+        <Table.Tr>
+          <Table.Th>Medication</Table.Th>
+          <Table.Th>NDC</Table.Th>
+          <Table.Th>RxNorm</Table.Th>
+          <Table.Th>Directions</Table.Th>
+        </Table.Tr>
+      </Table.Thead>
+      <Table.Tbody>
+        {clinicFavoriteMedications.map((clinicFavoriteMedication, index) => (
+          <Table.Tr key={clinicFavoriteMedication.id || index}>
+            <Table.Td>
+              <Text fw={500}>{getMedicationName(clinicFavoriteMedication)}</Text>
+            </Table.Td>
+            <Table.Td>
+              {clinicFavoriteMedication.code ? getCodeBySystem(clinicFavoriteMedication.code, NDC) : ''}
+            </Table.Td>
+            <Table.Td>
+              {clinicFavoriteMedication.code ? getCodeBySystem(clinicFavoriteMedication.code, RXNORM) : ''}
+            </Table.Td>
+            <Table.Td>
+              {clinicFavoriteMedication.administrationGuidelines?.[0]?.dosage?.[0]?.dosage?.[0]?.patientInstruction ||
+                ''}
+            </Table.Td>
+          </Table.Tr>
+        ))}
+      </Table.Tbody>
+    </Table>
+  );
+}

package/dist/examples/vintasend-medplum-example/src/pages/integrations/IntegrationsPage.test.tsx

@@ -0,0 +1,234 @@
+// SPDX-FileCopyrightText: Copyright Orangebot, Inc. and Medplum contributors
+// SPDX-License-Identifier: Apache-2.0
+import { describe, expect, test, beforeEach, afterEach, vi } from 'vitest';
+import { IntegrationsPage } from './IntegrationsPage';
+import { render, screen, fireEvent } from '../../test-utils/render';
+
+describe('IntegrationsPage', () => {
+  let mockLocationHref: string;
+  const originalLocation = window.location;
+
+  beforeEach(() => {
+    vi.clearAllMocks();
+
+    // Mock window.location.href
+    mockLocationHref = '';
+    Object.defineProperty(window, 'location', {
+      value: {
+        ...originalLocation,
+        get href() {
+          return mockLocationHref;
+        },
+        set href(value: string) {
+          mockLocationHref = value;
+        },
+      },
+      writable: true,
+      configurable: true,
+    });
+  });
+
+  afterEach(() => {
+    Object.defineProperty(window, 'location', {
+      value: originalLocation,
+      writable: true,
+      configurable: true,
+    });
+  });
+
+  function setup(): void {
+    render(<IntegrationsPage />);
+  }
+
+  test('Renders all integrations', () => {
+    setup();
+
+    // Check that all integration names are rendered
+    expect(screen.getByText('Okta')).toBeInTheDocument();
+    expect(screen.getByText('Auth0')).toBeInTheDocument();
+    expect(screen.getByText('Google Authentication')).toBeInTheDocument();
+    expect(screen.getByText('Microsoft Entra SSO')).toBeInTheDocument();
+    expect(screen.getByText('Labcorp')).toBeInTheDocument();
+    expect(screen.getByText('Quest Diagnostics')).toBeInTheDocument();
+    expect(screen.getByText('Health Gorilla')).toBeInTheDocument();
+    expect(screen.getByText('Candid Health')).toBeInTheDocument();
+    expect(screen.getByText('Particle')).toBeInTheDocument();
+    expect(screen.getByText('Epic Systems')).toBeInTheDocument();
+    expect(screen.getByText('reCAPTCHA')).toBeInTheDocument();
+    expect(screen.getByText('Datadog')).toBeInTheDocument();
+    expect(screen.getByText('Sumo Logic')).toBeInTheDocument();
+    expect(screen.getByText('Snowflake')).toBeInTheDocument();
+    expect(screen.getByText('OpenAI')).toBeInTheDocument();
+    expect(screen.getByText('Stripe')).toBeInTheDocument();
+    expect(screen.getByText('Acuity Scheduling')).toBeInTheDocument();
+    expect(screen.getByText('Cal.com')).toBeInTheDocument();
+    expect(screen.getByText('Claude')).toBeInTheDocument();
+    expect(screen.getByText('DeepSeek')).toBeInTheDocument();
+    expect(screen.getByText('Azure')).toBeInTheDocument();
+    expect(screen.getByText('Healthie')).toBeInTheDocument();
+  });
+
+  test('Renders integration descriptions', () => {
+    setup();
+
+    expect(
+      screen.getByText(/Implement SSO for healthcare staff with HIPAA-compliant authentication protocols/)
+    ).toBeInTheDocument();
+    expect(screen.getByText(/Manage identity access for patient portals/)).toBeInTheDocument();
+    expect(
+      screen.getByText(/Place orders and receive lab results directly in your EHR from Labcorp/)
+    ).toBeInTheDocument();
+  });
+
+  test('Renders integration tags', () => {
+    setup();
+
+    // Check for various tags
+    expect(screen.getAllByText('Authentication').length).toBeGreaterThan(0);
+    expect(screen.getAllByText('Diagnostics').length).toBeGreaterThan(0);
+    expect(screen.getAllByText('Billing').length).toBeGreaterThan(0);
+    expect(screen.getAllByText('HIE').length).toBeGreaterThan(0);
+    expect(screen.getAllByText('EHR').length).toBeGreaterThan(0);
+    expect(screen.getAllByText('Security').length).toBeGreaterThan(0);
+    expect(screen.getAllByText('Observability').length).toBeGreaterThan(0);
+    expect(screen.getAllByText('AI').length).toBeGreaterThan(0);
+    expect(screen.getAllByText('Scheduling').length).toBeGreaterThan(0);
+  });
+
+  test('Renders Request Integration buttons for all integrations', () => {
+    setup();
+
+    // There should be 22 integration cards, each with a "Request Integration" button
+    const requestButtons = screen.getAllByRole('button', { name: 'Request Integration' });
+    expect(requestButtons.length).toBe(22);
+  });
+
+  test('Clicking Request Integration opens mailto link with correct subject', () => {
+    setup();
+
+    const oktaButton = screen.getAllByRole('button', { name: 'Request Integration' })[0];
+    fireEvent.click(oktaButton);
+
+    expect(mockLocationHref).toContain('mailto:hello@medplum.com');
+    expect(mockLocationHref).toContain('subject=');
+    expect(decodeURIComponent(mockLocationHref)).toContain('Integration Request: Okta');
+  });
+
+  test('Clicking Request Integration opens mailto link with correct body', () => {
+    setup();
+
+    const oktaButton = screen.getAllByRole('button', { name: 'Request Integration' })[0];
+    fireEvent.click(oktaButton);
+
+    const decodedHref = decodeURIComponent(mockLocationHref);
+    expect(decodedHref).toContain('Hello Medplum team');
+    expect(decodedHref).toContain('I would like to request an integration with Okta');
+    expect(decodedHref).toContain('Name: Okta');
+    expect(decodedHref).toContain(
+      'Description: Implement SSO for healthcare staff with HIPAA-compliant authentication protocols.'
+    );
+    expect(decodedHref).toContain('URL: https://www.okta.com');
+    expect(decodedHref).toContain('Thank you!');
+  });
+
+  test('Clicking different integration opens mailto with correct integration details', () => {
+    setup();
+
+    // Find Health Gorilla button (should be one of the later ones)
+    const buttons = screen.getAllByRole('button', { name: 'Request Integration' });
+    const healthGorillaButton = buttons.find((button) => {
+      const card = button.closest('[class*="Paper"]');
+      return card?.textContent?.includes('Health Gorilla');
+    });
+
+    expect(healthGorillaButton).toBeDefined();
+
+    if (healthGorillaButton) {
+      fireEvent.click(healthGorillaButton);
+
+      const decodedHref = decodeURIComponent(mockLocationHref);
+      expect(decodedHref).toContain('Integration Request: Health Gorilla');
+      expect(decodedHref).toContain('I would like to request an integration with Health Gorilla');
+      expect(decodedHref).toContain('Name: Health Gorilla');
+      expect(decodedHref).toContain('URL: https://www.healthgorilla.com');
+    }
+  });
+
+  test('Mailto link properly encodes special characters', () => {
+    setup();
+
+    // Find an integration with special characters in description
+    const buttons = screen.getAllByRole('button', { name: 'Request Integration' });
+    const microsoftButton = buttons.find((button) => {
+      const card = button.closest('[class*="Paper"]');
+      return card?.textContent?.includes('Microsoft Entra SSO');
+    });
+
+    expect(microsoftButton).toBeDefined();
+
+    if (microsoftButton) {
+      fireEvent.click(microsoftButton);
+
+      // The URL should be properly encoded
+      expect(mockLocationHref).toContain('mailto:hello@medplum.com');
+      expect(mockLocationHref).toContain('subject=');
+      expect(mockLocationHref).toContain('body=');
+
+      // Decoded should contain the correct content
+      const decodedHref = decodeURIComponent(mockLocationHref);
+      expect(decodedHref).toContain("Integrate Microsoft's identity platform");
+    }
+  });
+
+  test('Renders integration display URLs', () => {
+    setup();
+
+    // Check that display URLs are rendered as links
+    expect(screen.getByText('okta.com')).toBeInTheDocument();
+    expect(screen.getByText('auth0.com')).toBeInTheDocument();
+    expect(screen.getByText('labcorp.com')).toBeInTheDocument();
+  });
+
+  test('Integration links open in new tab', () => {
+    setup();
+
+    const oktaLink = screen.getByText('okta.com').closest('a');
+    expect(oktaLink).toHaveAttribute('href', 'https://www.okta.com');
+    expect(oktaLink).toHaveAttribute('target', '_blank');
+    expect(oktaLink).toHaveAttribute('rel', 'noopener noreferrer');
+  });
+
+  test('Renders correct number of integrations', () => {
+    setup();
+
+    // Count unique integration names
+    const integrationNames = [
+      'Okta',
+      'Auth0',
+      'Google Authentication',
+      'Microsoft Entra SSO',
+      'Labcorp',
+      'Quest Diagnostics',
+      'Health Gorilla',
+      'Candid Health',
+      'Particle',
+      'Epic Systems',
+      'reCAPTCHA',
+      'Datadog',
+      'Sumo Logic',
+      'Snowflake',
+      'OpenAI',
+      'Stripe',
+      'Acuity Scheduling',
+      'Cal.com',
+      'Claude',
+      'DeepSeek',
+      'Azure',
+      'Healthie',
+    ];
+
+    integrationNames.forEach((name) => {
+      expect(screen.getByText(name)).toBeInTheDocument();
+    });
+  });
+});

package/dist/examples/vintasend-medplum-example/src/pages/integrations/IntegrationsPage.tsx

@@ -0,0 +1,222 @@
+// SPDX-FileCopyrightText: Copyright Orangebot, Inc. and Medplum contributors
+// SPDX-License-Identifier: Apache-2.0
+import { Flex } from '@mantine/core';
+import type { JSX } from 'react';
+import { IntegrationCard } from '../../components/IntegrationCard';
+
+interface Integration {
+  name: string;
+  tags: string[];
+  description: string;
+  displayUrl: string;
+  url: string;
+  imageUrl: string;
+}
+
+const integrations = [
+  {
+    name: 'Okta',
+    tags: ['Authentication'],
+    description: 'Implement SSO for healthcare staff with HIPAA-compliant authentication protocols.',
+    displayUrl: 'okta.com',
+    url: 'https://www.okta.com',
+    imageUrl: 'okta.png',
+  },
+  {
+    name: 'Auth0',
+    tags: ['Authentication'],
+    description: 'Manage identity access for patient portals and provider applications across multiple platforms.',
+    displayUrl: 'auth0.com',
+    url: 'https://auth0.com',
+    imageUrl: 'auth0.png',
+  },
+  {
+    name: 'Google Authentication',
+    tags: ['Authentication'],
+    description: "Add Google's authentication system to your EHR for standardized sign-in.",
+    displayUrl: 'cloud.google.com',
+    url: 'https://cloud.google.com/identity',
+    imageUrl: 'google.png',
+  },
+  {
+    name: 'Microsoft Entra SSO',
+    tags: ['Authentication'],
+    description: "Integrate Microsoft's identity platform with clinical systems for centralized access management.",
+    displayUrl: 'microsoft.com',
+    url: 'https://learn.microsoft.com/en-us/entra/identity-platform',
+    imageUrl: 'entra.png',
+  },
+  {
+    name: 'Labcorp',
+    tags: ['Diagnostics'],
+    description: 'Place orders and receive lab results directly in your EHR from Labcorp.',
+    displayUrl: 'labcorp.com',
+    url: 'https://www.labcorp.com',
+    imageUrl: 'labcorp.png',
+  },
+  {
+    name: 'Quest Diagnostics',
+    tags: ['Diagnostics'],
+    description: 'Place orders and receive lab results directly in your EHR from Quest.',
+    displayUrl: 'questdiagnostics.com',
+    url: 'https://www.questdiagnostics.com',
+    imageUrl: 'quest.png',
+  },
+  {
+    name: 'Health Gorilla',
+    tags: ['HIE', 'Diagnostics'],
+    description:
+      'Access nationwide clinical data networks for patient records diagnostic reports and ADT notifications.',
+    displayUrl: 'healthgorilla.com',
+    url: 'https://www.healthgorilla.com',
+    imageUrl: 'healthgorilla.png',
+  },
+  {
+    name: 'Candid Health',
+    tags: ['Billing'],
+    description:
+      'Integrate automated eligibility verification and claims processing with your practice management system.',
+    displayUrl: 'candidhealth.com',
+    url: 'https://www.candidhealth.com',
+    imageUrl: 'candid.png',
+  },
+  {
+    name: 'Particle',
+    tags: ['HIE'],
+    description: 'Import and export clinical data with other healthcare organizations through standardized models.',
+    displayUrl: 'particlehealth.com',
+    url: 'https://www.particlehealth.com',
+    imageUrl: 'particle.png',
+  },
+  {
+    name: 'Epic Systems',
+    tags: ['EHR'],
+    description: 'Connect to your existing Epic EHR through FHIR APIs to exchange clinical data.',
+    displayUrl: 'epic.com',
+    url: 'https://www.epic.com',
+    imageUrl: 'epic.png',
+  },
+  {
+    name: 'reCAPTCHA',
+    tags: ['Security'],
+    description: 'Implement bot protection for online patient registration forms while maintaining usability.',
+    displayUrl: 'google.com/recaptcha',
+    url: 'https://www.google.com/recaptcha',
+    imageUrl: 'recaptcha.png',
+  },
+  {
+    name: 'Datadog',
+    tags: ['Observability'],
+    description: 'Monitor healthcare application performance to identify issues before they impact clinical workflows.',
+    displayUrl: 'datadog.com',
+    url: 'https://www.datadog.com',
+    imageUrl: 'datadog.png',
+  },
+  {
+    name: 'Sumo Logic',
+    tags: ['Observability'],
+    description: 'Analyze system logs and user activities across healthcare IT systems for compliance verification.',
+    displayUrl: 'sumologic.com',
+    url: 'https://www.sumologic.com',
+    imageUrl: 'sumo.png',
+  },
+  {
+    name: 'Snowflake',
+    tags: ['Data warehouse'],
+    description:
+      'Store clinical and operational data in a cloud database with access controls, allowing for analysis and reporting without managing physical servers.',
+    displayUrl: 'snowflake.com',
+    url: 'https://www.snowflake.com',
+    imageUrl: 'snowflake.png',
+  },
+  {
+    name: 'OpenAI',
+    tags: ['AI'],
+    description: 'Implement AI-powered features for clinical documentation and workflow management.',
+    displayUrl: 'openai.com',
+    url: 'https://openai.com',
+    imageUrl: 'openai.png',
+  },
+  {
+    name: 'Stripe',
+    tags: ['Billing'],
+    description:
+      'Send invoices, process payments, and automate reconciliation to complement your revenue cycle management.',
+    displayUrl: 'stripe.com',
+    url: 'https://stripe.com',
+    imageUrl: 'stripe.png',
+  },
+  {
+    name: 'Acuity Scheduling',
+    tags: ['Scheduling'],
+    description: 'Manage your clinical availability and appointments with comprehensive scheduling tools.',
+    displayUrl: 'acuityscheduling.com',
+    url: 'https://www.acuityscheduling.com',
+    imageUrl: 'acuity.png',
+  },
+  {
+    name: 'Cal.com',
+    tags: ['Scheduling'],
+    description: 'Open source scheduling platform for managing availability and appointments.',
+    displayUrl: 'cal.com',
+    url: 'https://cal.com',
+    imageUrl: 'calcom.png',
+  },
+  {
+    name: 'Claude',
+    tags: ['AI'],
+    description: 'Implement AI-powered features for clinical documentation and workflow management.',
+    displayUrl: 'anthropic.com/claude',
+    url: 'https://www.anthropic.com/claude',
+    imageUrl: 'claude.png',
+  },
+  {
+    name: 'DeepSeek',
+    tags: ['AI'],
+    description: 'Implement AI-powered features for clinical documentation and workflow management.',
+    displayUrl: 'deepseek.com',
+    url: 'https://www.deepseek.com',
+    imageUrl: 'deepseek.png',
+  },
+  {
+    name: 'Azure',
+    tags: ['Cloud Services'],
+    description: 'Deploy HIPAA-compliant applications with specialized services for protected health information.',
+    displayUrl: 'azure.microsoft.com',
+    url: 'https://azure.microsoft.com',
+    imageUrl: 'azure.png',
+  },
+  {
+    name: 'Healthie',
+    tags: ['EHR', 'Practice Management'],
+    description: 'Connect to your existing Healthie account to exchange clinical data.',
+    displayUrl: 'gethealthie.com',
+    url: 'https://gethealthie.com',
+    imageUrl: 'healthie.png',
+  },
+];
+
+export function IntegrationsPage(): JSX.Element {
+  function requestIntegration(integration: Integration): void {
+    const subject = `Integration Request: ${integration.name}`;
+    const body = `Hello Medplum team,\n\nI would like to request an integration with ${integration.name}.\n\nHere are the details:\n\nName: ${integration.name}\nDescription: ${integration.description}\nURL: ${integration.url}\n\nThank you!`;
+    window.location.href = `mailto:hello@medplum.com?subject=${encodeURIComponent(subject)}&body=${encodeURIComponent(body)}`;
+  }
+
+  return (
+    <Flex mih={50} gap="md" justify="center" align="flex-end" direction="row" wrap="wrap" m="xl">
+      {integrations.map((i) => (
+        <IntegrationCard
+          key={i.name}
+          name={i.name}
+          displayUrl={i.displayUrl}
+          url={i.url}
+          tags={i.tags}
+          description={i.description}
+          imageUrl={`/img/integrations/${i.imageUrl}`}
+          onClick={() => requestIntegration(i)}
+        />
+      ))}
+    </Flex>
+  );
+}