vintasend 0.4.0 → 0.4.7

package/dist/examples/vintasend-medplum-example/bots/services/emails/send-task-assignment-email.ts

@@ -0,0 +1,113 @@
+import { MedplumClient } from '@medplum/core';
+import { Task } from '@medplum/fhirtypes';
+import { MedplumSingleton } from '../../../lib/medplum-singleton';
+import { getNotificationService, SendGridConfig } from '../../../lib/notification-service';
+import { formatPatientNameWithPreferredName } from '../../../lib/patients';
+import { getTaskAttachments } from '../../../lib/file-upload';
+
+export async function sendTaskAssignmentEmail(
+  medplum: MedplumClient,
+  task: Task,
+  taskLinkBaseUrl: string,
+  sendgridConfig: SendGridConfig
+) {
+  /* sends a task assignment email to a practitioner */
+
+  if (!task.owner?.reference) {
+    // eslint-disable-next-line no-console
+    console.error('[sendTaskAssignmentEmail] Task has no owner reference');
+    throw new Error('Task must have an owner reference');
+  }
+
+  const referenceString = task.owner.reference;
+
+  // Validate format (should be "ResourceType/id")
+  if (!referenceString.includes('/')) {
+    // eslint-disable-next-line no-console
+    console.error('[sendTaskAssignmentEmail] Invalid referenceString format:', referenceString);
+    throw new Error(`Invalid referenceString format: ${referenceString}`);
+  }
+
+  // Skip sending email if task is assigned to a Group
+  const [resourceType] = referenceString.split('/');
+  if (resourceType === 'Group') {
+    // eslint-disable-next-line no-console
+    console.log('[sendTaskAssignmentEmail] Task assigned to Group, skipping email notification');
+    return;
+  }
+
+  MedplumSingleton.setInstance(medplum);
+  const vintasend = getNotificationService(medplum, sendgridConfig);
+
+  try {
+    const taskTitle = task.code?.text || task.description || 'New Task';
+
+    if (!task.id) {
+      // eslint-disable-next-line no-console
+      console.error('[sendTaskAssignmentEmail] Task has no id');
+      throw new Error('Task must have an id to send task assignment email');
+    }
+
+    const taskLink = `${taskLinkBaseUrl}/Task/${task.id}`;
+    const taskIsUrgent = task.priority === 'urgent';
+
+    let requesterName = 'someone';
+    if (task.requester?.reference) {
+      try {
+        const requester = await medplum.readReference(task.requester);
+        if ('name' in requester && requester.name && Array.isArray(requester.name)) {
+          requesterName = formatPatientNameWithPreferredName(requester.name[0]);
+        }
+      } catch (error) {
+        // eslint-disable-next-line no-console
+        console.error('[sendTaskAssignmentEmail] Error fetching requester:', error);
+      }
+    }
+
+    // Retrieve task attachments
+    const taskAttachments = await getTaskAttachments(medplum, task);
+    
+    // eslint-disable-next-line no-console
+    console.log(`[sendTaskAssignmentEmail] Found ${taskAttachments.length} attachments for task ${task.id}`);
+
+    // Convert Media resources to VintaSend attachment references
+    // Use fileId to reference existing Media resources instead of re-uploading
+    const attachments = taskAttachments
+      .filter((media) => media.id) // Only include media with IDs
+      .map((media) => ({
+        fileId: media.id as string,
+        description: media.content?.title,
+      }));
+
+    // eslint-disable-next-line no-console
+    console.log(`[sendTaskAssignmentEmail] Prepared ${attachments.length} attachment references`);
+
+    await vintasend.createNotification({
+      userId: referenceString,
+      notificationType: 'EMAIL' as const,
+      title: 'Task Assignment',
+      contextName: 'taskAssignment' as const,
+      contextParameters: {
+        userId: referenceString,
+        taskTitle,
+        taskDescription: task.description || '',
+        taskIsUrgent,
+        taskLink,
+        requesterName,
+        attachmentCount: attachments.length,
+      },
+      sendAfter: new Date(),
+      bodyTemplate: 'emails/task-assignment/body.html.pug',
+      subjectTemplate: 'emails/task-assignment/subject.txt.pug',
+      attachments, // Add attachments to the notification
+      extraParams: {},
+    });
+
+    // eslint-disable-next-line no-console
+    console.log('[sendTaskAssignmentEmail] Email sent successfully to:', referenceString);
+  } catch (error) {
+    // eslint-disable-next-line no-console
+    console.error('[sendTaskAssignmentEmail] Error creating/sending notification:', error);
+    throw error;
+  }
+}

package/dist/examples/vintasend-medplum-example/bots/shared/task-due-soon-helpers.ts

@@ -0,0 +1,115 @@
+import { Task } from '@medplum/fhirtypes';
+
+export type TaskFinalStatus = 'completed' | 'cancelled' | 'failed' | 'rejected' | 'entered-in-error';
+
+export type TaskDueSoonCheck =
+  | { kind: 'ok'; hoursUntilDue: number }
+  | { kind: 'invalidResource' }
+  | { kind: 'noDueDate' }
+  | { kind: 'invalidDueDate'; dueDate: string }
+  | { kind: 'finalState'; status: string }
+  | { kind: 'noOwner' }
+  | { kind: 'tooSoon'; hoursUntilDue: number };
+
+const FINAL_STATES: readonly TaskFinalStatus[] = [
+  'completed',
+  'cancelled',
+  'failed',
+  'rejected',
+  'entered-in-error',
+] as const;
+
+export function getHoursUntil(date: string | Date): number {
+  const target = new Date(date);
+  const now = new Date();
+  return (target.getTime() - now.getTime()) / (1000 * 60 * 60);
+}
+
+export function getTaskDueSoonSchedulingReason(task: Task | undefined): TaskDueSoonCheck {
+  if (!task || task.resourceType !== 'Task') {
+    return { kind: 'invalidResource' };
+  }
+
+  const dueDate = task.restriction?.period?.end;
+  if (!dueDate) {
+    return { kind: 'noDueDate' };
+  }
+
+  if (task.status && FINAL_STATES.includes(task.status as TaskFinalStatus)) {
+    return { kind: 'finalState', status: task.status };
+  }
+
+  if (!task.owner) {
+    return { kind: 'noOwner' };
+  }
+
+  const hoursUntilDue = getHoursUntil(dueDate);
+  if (Number.isNaN(hoursUntilDue)) {
+    return { kind: 'invalidDueDate', dueDate };
+  }
+
+  if (hoursUntilDue < 24) {
+    return { kind: 'tooSoon', hoursUntilDue };
+  }
+
+  return { kind: 'ok', hoursUntilDue };
+}
+
+export function assertTaskOwnerReference(task: Task): string {
+  const reference = task.owner?.reference;
+  if (!reference) {
+    // eslint-disable-next-line no-console
+    console.error('[TaskDueSoonHelper] Task has no owner reference');
+    throw new Error('Task must have an owner reference');
+  }
+  return reference;
+}
+
+export function getValidTaskDueDate(task: Task): Date {
+  const raw = task.restriction?.period?.end;
+  if (!raw) {
+    // eslint-disable-next-line no-console
+    console.error('[TaskDueSoonHelper] Task has no due date');
+    throw new Error('Task must have a due date (restriction.period.end)');
+  }
+
+  const dueDate = new Date(raw);
+  if (Number.isNaN(dueDate.getTime())) {
+    // eslint-disable-next-line no-console
+    console.error('[TaskDueSoonHelper] Task has invalid due date:', raw);
+    throw new Error('Task must have a valid due date (restriction.period.end)');
+  }
+  return dueDate;
+}
+
+export function parseOwnerReference(
+  referenceString: string
+): { resourceType: string; id: string } | null {
+  if (!referenceString.includes('/')) {
+    // eslint-disable-next-line no-console
+    console.error('[TaskDueSoonHelper] Invalid referenceString format:', referenceString);
+    return null;
+  }
+  const [resourceType, id] = referenceString.split('/');
+  if (!resourceType || !id) {
+    // eslint-disable-next-line no-console
+    console.error('[TaskDueSoonHelper] Invalid referenceString components:', referenceString);
+    return null;
+  }
+  if (resourceType === 'Group') {
+    // eslint-disable-next-line no-console
+    console.log('[TaskDueSoonHelper] Task assigned to Group, skipping email notification');
+    return null;
+  }
+  return { resourceType, id };
+}
+
+export function computeReminderTime(dueDate: Date, hoursBefore: number): Date | null {
+  const sendAfter = new Date(dueDate.getTime() - hoursBefore * 60 * 60 * 1000);
+  if (sendAfter <= new Date()) {
+    // eslint-disable-next-line no-console
+    console.log('[TaskDueSoonHelper] Reminder time is in the past or within window, skipping');
+    return null;
+  }
+  return sendAfter;
+}

package/dist/examples/vintasend-medplum-example/bots/task-assignment-bot.ts

@@ -0,0 +1,41 @@
+import { BotEvent, MedplumClient } from '@medplum/core';
+import { Task } from '@medplum/fhirtypes';
+import { sendTaskAssignmentEmail } from './services/emails/send-task-assignment-email';
+import { buildSendGridConfig } from '../lib/notification-service';
+
+/**
+ * Medplum Bot: Task Assignment Email Notification
+ *
+ * This bot is triggered by a subscription when a Task is created or updated
+ * with an owner. It sends an email notification to the assigned practitioner.
+ *
+ * Subscription Criteria: Task?owner:exists=true
+ * Triggers: create, update
+ */
+
+export async function handler(medplum: MedplumClient, event: BotEvent): Promise<Task> {
+  const task = event.input as Task;
+  const sendGridVariables = buildSendGridConfig(event);
+
+  console.log(`[TaskAssignmentBot] Processing task: ${task.id}`);
+  console.log(`[TaskAssignmentBot] Owner: ${task.owner?.reference}`);
+
+  // Only send email if task has an owner
+  if (task.owner?.reference) {
+    const appBaseUrl = process.env.APP_BASE_URL || 'https://your-app-url.com';
+
+    try {
+      await sendTaskAssignmentEmail(medplum, task, appBaseUrl, sendGridVariables);
+      console.log(`[TaskAssignmentBot] Email notification sent successfully for task: ${task.id}`);
+    } catch (error) {
+      console.error(`[TaskAssignmentBot] Failed to send email for task: ${task.id}`, error);
+      // Don't throw - we don't want the subscription to fail
+      // The notification will be logged in Medplum as failed
+    }
+  } else {
+    console.log(`[TaskAssignmentBot] Task ${task.id} has no owner, skipping email notification`);
+  }
+
+  // Return the task unchanged
+  return task;
+}

package/dist/examples/vintasend-medplum-example/compiled-notification-templates.json

@@ -0,0 +1,6 @@
+{
+  "emails/task-assignment/body.html.pug": "doctype html\nhtml\n  head\n    meta(charset='utf-8')\n    style.\n      body {\n        white-space: pre-line;\n      }\n  body\n    h1 Task Assigned\n\n    p Hello #{firstName},\n\n    p You have been assigned a new task by #{requesterName}.\n\n    p\n      strong Task:\n      |  #{taskTitle}\n    if taskDescription\n      p\n        strong Description:\n        |  #{taskDescription}\n    \n    if attachmentCount > 0\n      p\n        strong Attachments:\n        |  #{attachmentCount} file(s) attached\n      p Files are attached to this email for your reference.\n    \n    if taskIsUrgent\n      p\n        strong URGENT\n\n    p\n      a(href=taskLink) View Task\n\n    p Please review the task details and take appropriate action.\n",
+  "emails/task-assignment/subject.txt.pug": "if taskIsUrgent\n  | [URGENT] Task assigned to you: #{taskTitle}\nelse\n  | Task assigned to you: #{taskTitle}",
+  "emails/task-due-soon/body.html.pug": "doctype html\nhtml\n  head\n    meta(charset='utf-8')\n    style.\n      body {\n        white-space: pre-line;\n      }\n  body\n    h1 Task Due Reminder\n\n    p Hello #{firstName},\n\n    p This is a reminder that you have a task that is due in approximately 24 hours.\n\n    p\n      strong Task:\n      |  #{taskTitle}\n    if taskDescription\n      p\n        strong Description:\n        |  #{taskDescription}\n    p\n      strong Due Date:\n      |  #{dueDate}\n    if taskIsUrgent\n      p\n        strong URGENT\n\n    p\n      a(href=taskLink) View Task\n\n    p Please make sure to complete this task before the due date.\n\n",
+  "emails/task-due-soon/subject.txt.pug": "if taskIsUrgent\n  | [URGENT] Task due soon: #{taskTitle}\nelse\n  | Reminder: Task due soon - #{taskTitle}\n"
+}

package/dist/examples/vintasend-medplum-example/esbuild-script.mjs

@@ -0,0 +1,71 @@
+/* global console */
+/* global process */
+/* eslint no-console: "off" */
+/*eslint no-process-exit: "off"*/
+
+import botLayer from '@medplum/bot-layer/package.json' with { type: 'json' };
+import { sentryEsbuildPlugin } from '@sentry/esbuild-plugin';
+import esbuild from 'esbuild';
+import fastGlob from 'fast-glob';
+import { gqlPlugin } from './plugins/gql-plugin.mjs';
+
+// Find all TypeScript files in your source directory
+const entryPoints = fastGlob
+  .sync(['./src/**/*.ts', './bots/**/*.ts', './lib/**/*.ts'])
+  .filter((file) => !file.endsWith('.test.ts') && !file.endsWith('.test.tsx') && !file.endsWith('test.ts') && !file.endsWith('test.setup.ts'));
+
+const botLayerDeps = Object.keys(botLayer.dependencies);
+
+const plugins = [gqlPlugin];
+
+// Only include Sentry plugin if environment variables are present
+if (process.env.SENTRY_ORG && process.env.SENTRY_PROJECT && process.env.SENTRY_AUTH_TOKEN) {
+  plugins.push(
+    sentryEsbuildPlugin({
+      org: process.env.SENTRY_ORG,
+      project: process.env.SENTRY_PROJECT,
+      authToken: process.env.SENTRY_AUTH_TOKEN,
+      sourcemaps: {
+        filesToDeleteAfterUpload: ['dist/**/*.map'],
+      },
+    })
+  );
+}
+
+// Add additional external packages
+const additionalExternals = [
+  'react-transition-group',
+  'react-remove-scroll',
+  'react-transition-group/*',
+  'react-remove-scroll/*',
+];
+
+// Define the esbuild options
+const esbuildOptions = {
+  entryPoints: entryPoints,
+  bundle: true, // Bundle imported functions
+  outdir: './dist', // Output directory for compiled files
+  platform: 'node', // or 'node', depending on your target platform
+  plugins: plugins,
+  loader: {
+    '.ts': 'ts', // Load TypeScript files
+  },
+  resolveExtensions: ['.ts', '.js', '.json'],
+  external: [...botLayerDeps, ...additionalExternals], // Add the additional externals here
+  format: 'cjs', // Set output format as ECMAScript modules
+  target: 'es2020', // Set the target ECMAScript version
+  tsconfig: 'tsconfig.json',
+  footer: { js: 'Object.assign(exports, module.exports);' }, // Required for VM Context Bots
+  sourcemap: true,
+};
+
+// Build using esbuild
+esbuild
+  .build(esbuildOptions)
+  .then(() => {
+    console.log('Build completed successfully!');
+  })
+  .catch((error) => {
+    console.error('Build failed:', JSON.stringify(error, null, 2));
+    process.exit(1);
+  });

package/dist/examples/vintasend-medplum-example/index.html

@@ -0,0 +1,14 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Medplum Provider</title>
+    <link rel="shortcut icon" type="image/x-icon" href="/favicon.ico" />
+  </head>
+  <body>
+    <div id="root"></div>
+    <script src="https://accounts.google.com/gsi/client" async></script>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/dist/examples/vintasend-medplum-example/lib/constants.ts

@@ -0,0 +1,32 @@
+export const BOTS_SYSTEM = 'http://vintasend-medplum-example.com/bots';
+
+/**
+ * Task attachment configuration
+ */
+export const TASK_ATTACHMENT_INPUT_TYPE = {
+  system: 'http://vintasend-medplum-example.com/task-input-types',
+  code: 'attachment',
+  display: 'File Attachment',
+};
+
+/**
+ * Maximum file size for attachments (10MB)
+ */
+export const MAX_ATTACHMENT_SIZE = 10 * 1024 * 1024;
+
+/**
+ * Allowed file types for task attachments
+ */
+export const ALLOWED_FILE_TYPES = [
+  'application/pdf',
+  'image/jpeg',
+  'image/png',
+  'image/gif',
+  'image/webp',
+  'application/msword',
+  'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+  'application/vnd.ms-excel',
+  'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+  'text/plain',
+  'text/csv',
+];

package/dist/examples/vintasend-medplum-example/lib/extensions.ts

@@ -0,0 +1 @@
+export const PREFERRED_NAME_EXTENSION_URL = 'http://vintasend-medplum-example.com/preferred-name';