@hipnation-truth/sdk 0.2.1 → 0.4.0

package/dist/index.d.mts

@@ -445,6 +445,20 @@ declare class PatientDetailsResource {
     get(input: PatientDetailsInput): Promise<PatientDetailsResult>;
     getBasic(input: PatientDetailsInput): Promise<PatientBasicDetailsResult>;
     getMedical(elationId: string): Promise<PatientMedicalDetailsResult>;
+    /**
+     * Trigger a server-side refresh of the patient's Elation medical
+     * records (medications, problems, allergies, appointments) into the
+     * Convex cache. Fire-and-forget — the UI should read via the Convex-
+     * reactive `usePatientMedical` hook.
+     */
+    refreshMedical(elationId: number): Promise<{
+        totals: {
+            medications: number;
+            problems: number;
+            allergies: number;
+            appointments: number;
+        };
+    }>;
 }
 
 /**
@@ -519,6 +533,37 @@ declare class PatientResource {
     list(options?: PatientListOptions): Promise<PaginatedResult<Patient>>;
 }
 
+/**
+ * PhysiciansResource — Convex-backed physician lookups.
+ *
+ * Populated from Elation by Truth's daily PhysiciansBackfillCron. Replaces
+ * per-physician Elation HTTP hops with a single Convex batch query.
+ */
+
+interface Physician {
+    _id: string;
+    elationId: number;
+    firstName?: string;
+    lastName?: string;
+    npi?: string;
+    credentials?: string;
+    specialties?: string[];
+    practice?: number;
+    email?: string;
+    phone?: string;
+    lastSyncedAt: string;
+}
+declare class PhysiciansResource {
+    private readonly convex;
+    constructor(convex: ConvexHttpClient);
+    /**
+     * Resolve a batch of physicians by Elation IDs. Missing ids are dropped.
+     */
+    getByElationIds(ids: number[]): Promise<Physician[]>;
+    getByElationId(id: number): Promise<Physician | null>;
+    listByPractice(practice: number, limit?: number): Promise<Physician[]>;
+}
+
 /**
  * Reminder types — scheduled conversation reminders.
  */
@@ -1067,6 +1112,8 @@ declare class TruthClient {
     readonly attachments: AttachmentsResource;
     /** Notes — push formatted notes to Elation */
     readonly notes: NotesResource;
+    /** Physicians (Convex-backed cache from Elation) */
+    readonly physicians: PhysiciansResource;
     private readonly convex;
     private readonly tracker;
     constructor(config: TruthClientConfig);
@@ -1194,4 +1241,4 @@ declare class Tracker {
     private registerShutdownHooks;
 }
 
-export { AUTH_EVENTS, type ActorContext, type Appointment, type AppointmentListOptions, AppointmentResource, type Attachment, AttachmentsError, AttachmentsResource, type AuthEventType, type AuthLoginFailedPayload, type AuthLoginSucceededPayload, CALL_EVENTS, CONVERSATION_EVENTS, type CallConnectedPayload, type CallEndedPayload, type CallEventType, type CallInitiatedPayload, type CallMissedPayload, type CallStatusResponse, type ConversationAttachmentDownloadedPayload, type ConversationAttachmentUploadedPayload, type ConversationCreatedPayload, type ConversationEventType, type ConversationMarkedReadPayload, type ConversationMessageReceivedPayload, type ConversationMessageSentPayload, type CreateTaskInput, type CreateUploadUrlInput, type CreateUploadUrlResult, type DetectionResult, type DialpadNumberInfo, DialpadProxyError, DialpadResource, type DialpadUser, ENVIRONMENTS, EVENT_TYPES, EhrProviderProxy, EhrProxyError, EhrResource, type Environment, type EventActor, type EventCompliance, type EventEnvelope, type EventPayloadMap, type EventSubject, type EventType, type GetDownloadUrlResult, type InitiateCallResponse, MessagesResource, NOTIFICATION_EVENTS, type NonVisitNoteBullet, NotesError, NotesResource, type NotificationDeliveredPayload, type NotificationEventType, type NotificationOpenedPayload, type NotificationSentPayload, PROVIDER_EVENTS, type PaginatedResult, type Patient, type PatientBasicDetailsResult, PatientDetailsError, type PatientDetailsInput, PatientDetailsResource, type PatientDetailsResult, type PatientListOptions, type PatientMedicalDetailsResult, PatientResource, type ProviderEventType, type ProviderSyncFailedPayload, type ProviderSyncStartedPayload, type ProviderSyncSucceededPayload, type PushNoteToElationInput, type PushNoteToElationResult, REMINDER_EVENTS, type RecordAttachmentInput, type Reminder, type ReminderEventType, type ReminderScheduledPayload, type ReminderStatus, type ReminderTriggeredPayload, RemindersResource, SECURITY_EVENTS, type ScheduleReminderInput, type ScheduleReminderResult, type SecurityAccessDeniedPayload, type SecurityEventType, type SendSmsParams, type SendSmsResponse, TASK_EVENTS, TRANSLATION_EVENTS, type Task, type TaskAssignedPayload, type TaskCreatedPayload, type TaskEventType, type TaskStatus, type TaskStatusChangedPayload, TasksResource, type TrackOptions, Tracker, type TranslateBatchInput, type TranslateTextInput, type TranslationCompletedPayload, TranslationError, type TranslationEventType, type TranslationRequestedPayload, TranslationResource, type TranslationResult, TruthClient, type TruthClientConfig, type UpdateTaskStatusInput, type VoicemailAuthResponse, generateUuidV7 };
+export { AUTH_EVENTS, type ActorContext, type Appointment, type AppointmentListOptions, AppointmentResource, type Attachment, AttachmentsError, AttachmentsResource, type AuthEventType, type AuthLoginFailedPayload, type AuthLoginSucceededPayload, CALL_EVENTS, CONVERSATION_EVENTS, type CallConnectedPayload, type CallEndedPayload, type CallEventType, type CallInitiatedPayload, type CallMissedPayload, type CallStatusResponse, type ConversationAttachmentDownloadedPayload, type ConversationAttachmentUploadedPayload, type ConversationCreatedPayload, type ConversationEventType, type ConversationMarkedReadPayload, type ConversationMessageReceivedPayload, type ConversationMessageSentPayload, type CreateTaskInput, type CreateUploadUrlInput, type CreateUploadUrlResult, type DetectionResult, type DialpadNumberInfo, DialpadProxyError, DialpadResource, type DialpadUser, ENVIRONMENTS, EVENT_TYPES, EhrProviderProxy, EhrProxyError, EhrResource, type Environment, type EventActor, type EventCompliance, type EventEnvelope, type EventPayloadMap, type EventSubject, type EventType, type GetDownloadUrlResult, type InitiateCallResponse, MessagesResource, NOTIFICATION_EVENTS, type NonVisitNoteBullet, NotesError, NotesResource, type NotificationDeliveredPayload, type NotificationEventType, type NotificationOpenedPayload, type NotificationSentPayload, PROVIDER_EVENTS, type PaginatedResult, type Patient, type PatientBasicDetailsResult, PatientDetailsError, type PatientDetailsInput, PatientDetailsResource, type PatientDetailsResult, type PatientListOptions, type PatientMedicalDetailsResult, PatientResource, type Physician, PhysiciansResource, type ProviderEventType, type ProviderSyncFailedPayload, type ProviderSyncStartedPayload, type ProviderSyncSucceededPayload, type PushNoteToElationInput, type PushNoteToElationResult, REMINDER_EVENTS, type RecordAttachmentInput, type Reminder, type ReminderEventType, type ReminderScheduledPayload, type ReminderStatus, type ReminderTriggeredPayload, RemindersResource, SECURITY_EVENTS, type ScheduleReminderInput, type ScheduleReminderResult, type SecurityAccessDeniedPayload, type SecurityEventType, type SendSmsParams, type SendSmsResponse, TASK_EVENTS, TRANSLATION_EVENTS, type Task, type TaskAssignedPayload, type TaskCreatedPayload, type TaskEventType, type TaskStatus, type TaskStatusChangedPayload, TasksResource, type TrackOptions, Tracker, type TranslateBatchInput, type TranslateTextInput, type TranslationCompletedPayload, TranslationError, type TranslationEventType, type TranslationRequestedPayload, TranslationResource, type TranslationResult, TruthClient, type TruthClientConfig, type UpdateTaskStatusInput, type VoicemailAuthResponse, generateUuidV7 };

package/dist/index.d.ts

@@ -445,6 +445,20 @@ declare class PatientDetailsResource {
     get(input: PatientDetailsInput): Promise<PatientDetailsResult>;
     getBasic(input: PatientDetailsInput): Promise<PatientBasicDetailsResult>;
     getMedical(elationId: string): Promise<PatientMedicalDetailsResult>;
+    /**
+     * Trigger a server-side refresh of the patient's Elation medical
+     * records (medications, problems, allergies, appointments) into the
+     * Convex cache. Fire-and-forget — the UI should read via the Convex-
+     * reactive `usePatientMedical` hook.
+     */
+    refreshMedical(elationId: number): Promise<{
+        totals: {
+            medications: number;
+            problems: number;
+            allergies: number;
+            appointments: number;
+        };
+    }>;
 }
 
 /**
@@ -519,6 +533,37 @@ declare class PatientResource {
     list(options?: PatientListOptions): Promise<PaginatedResult<Patient>>;
 }
 
+/**
+ * PhysiciansResource — Convex-backed physician lookups.
+ *
+ * Populated from Elation by Truth's daily PhysiciansBackfillCron. Replaces
+ * per-physician Elation HTTP hops with a single Convex batch query.
+ */
+
+interface Physician {
+    _id: string;
+    elationId: number;
+    firstName?: string;
+    lastName?: string;
+    npi?: string;
+    credentials?: string;
+    specialties?: string[];
+    practice?: number;
+    email?: string;
+    phone?: string;
+    lastSyncedAt: string;
+}
+declare class PhysiciansResource {
+    private readonly convex;
+    constructor(convex: ConvexHttpClient);
+    /**
+     * Resolve a batch of physicians by Elation IDs. Missing ids are dropped.
+     */
+    getByElationIds(ids: number[]): Promise<Physician[]>;
+    getByElationId(id: number): Promise<Physician | null>;
+    listByPractice(practice: number, limit?: number): Promise<Physician[]>;
+}
+
 /**
  * Reminder types — scheduled conversation reminders.
  */
@@ -1067,6 +1112,8 @@ declare class TruthClient {
     readonly attachments: AttachmentsResource;
     /** Notes — push formatted notes to Elation */
     readonly notes: NotesResource;
+    /** Physicians (Convex-backed cache from Elation) */
+    readonly physicians: PhysiciansResource;
     private readonly convex;
     private readonly tracker;
     constructor(config: TruthClientConfig);
@@ -1194,4 +1241,4 @@ declare class Tracker {
     private registerShutdownHooks;
 }
 
-export { AUTH_EVENTS, type ActorContext, type Appointment, type AppointmentListOptions, AppointmentResource, type Attachment, AttachmentsError, AttachmentsResource, type AuthEventType, type AuthLoginFailedPayload, type AuthLoginSucceededPayload, CALL_EVENTS, CONVERSATION_EVENTS, type CallConnectedPayload, type CallEndedPayload, type CallEventType, type CallInitiatedPayload, type CallMissedPayload, type CallStatusResponse, type ConversationAttachmentDownloadedPayload, type ConversationAttachmentUploadedPayload, type ConversationCreatedPayload, type ConversationEventType, type ConversationMarkedReadPayload, type ConversationMessageReceivedPayload, type ConversationMessageSentPayload, type CreateTaskInput, type CreateUploadUrlInput, type CreateUploadUrlResult, type DetectionResult, type DialpadNumberInfo, DialpadProxyError, DialpadResource, type DialpadUser, ENVIRONMENTS, EVENT_TYPES, EhrProviderProxy, EhrProxyError, EhrResource, type Environment, type EventActor, type EventCompliance, type EventEnvelope, type EventPayloadMap, type EventSubject, type EventType, type GetDownloadUrlResult, type InitiateCallResponse, MessagesResource, NOTIFICATION_EVENTS, type NonVisitNoteBullet, NotesError, NotesResource, type NotificationDeliveredPayload, type NotificationEventType, type NotificationOpenedPayload, type NotificationSentPayload, PROVIDER_EVENTS, type PaginatedResult, type Patient, type PatientBasicDetailsResult, PatientDetailsError, type PatientDetailsInput, PatientDetailsResource, type PatientDetailsResult, type PatientListOptions, type PatientMedicalDetailsResult, PatientResource, type ProviderEventType, type ProviderSyncFailedPayload, type ProviderSyncStartedPayload, type ProviderSyncSucceededPayload, type PushNoteToElationInput, type PushNoteToElationResult, REMINDER_EVENTS, type RecordAttachmentInput, type Reminder, type ReminderEventType, type ReminderScheduledPayload, type ReminderStatus, type ReminderTriggeredPayload, RemindersResource, SECURITY_EVENTS, type ScheduleReminderInput, type ScheduleReminderResult, type SecurityAccessDeniedPayload, type SecurityEventType, type SendSmsParams, type SendSmsResponse, TASK_EVENTS, TRANSLATION_EVENTS, type Task, type TaskAssignedPayload, type TaskCreatedPayload, type TaskEventType, type TaskStatus, type TaskStatusChangedPayload, TasksResource, type TrackOptions, Tracker, type TranslateBatchInput, type TranslateTextInput, type TranslationCompletedPayload, TranslationError, type TranslationEventType, type TranslationRequestedPayload, TranslationResource, type TranslationResult, TruthClient, type TruthClientConfig, type UpdateTaskStatusInput, type VoicemailAuthResponse, generateUuidV7 };
+export { AUTH_EVENTS, type ActorContext, type Appointment, type AppointmentListOptions, AppointmentResource, type Attachment, AttachmentsError, AttachmentsResource, type AuthEventType, type AuthLoginFailedPayload, type AuthLoginSucceededPayload, CALL_EVENTS, CONVERSATION_EVENTS, type CallConnectedPayload, type CallEndedPayload, type CallEventType, type CallInitiatedPayload, type CallMissedPayload, type CallStatusResponse, type ConversationAttachmentDownloadedPayload, type ConversationAttachmentUploadedPayload, type ConversationCreatedPayload, type ConversationEventType, type ConversationMarkedReadPayload, type ConversationMessageReceivedPayload, type ConversationMessageSentPayload, type CreateTaskInput, type CreateUploadUrlInput, type CreateUploadUrlResult, type DetectionResult, type DialpadNumberInfo, DialpadProxyError, DialpadResource, type DialpadUser, ENVIRONMENTS, EVENT_TYPES, EhrProviderProxy, EhrProxyError, EhrResource, type Environment, type EventActor, type EventCompliance, type EventEnvelope, type EventPayloadMap, type EventSubject, type EventType, type GetDownloadUrlResult, type InitiateCallResponse, MessagesResource, NOTIFICATION_EVENTS, type NonVisitNoteBullet, NotesError, NotesResource, type NotificationDeliveredPayload, type NotificationEventType, type NotificationOpenedPayload, type NotificationSentPayload, PROVIDER_EVENTS, type PaginatedResult, type Patient, type PatientBasicDetailsResult, PatientDetailsError, type PatientDetailsInput, PatientDetailsResource, type PatientDetailsResult, type PatientListOptions, type PatientMedicalDetailsResult, PatientResource, type Physician, PhysiciansResource, type ProviderEventType, type ProviderSyncFailedPayload, type ProviderSyncStartedPayload, type ProviderSyncSucceededPayload, type PushNoteToElationInput, type PushNoteToElationResult, REMINDER_EVENTS, type RecordAttachmentInput, type Reminder, type ReminderEventType, type ReminderScheduledPayload, type ReminderStatus, type ReminderTriggeredPayload, RemindersResource, SECURITY_EVENTS, type ScheduleReminderInput, type ScheduleReminderResult, type SecurityAccessDeniedPayload, type SecurityEventType, type SendSmsParams, type SendSmsResponse, TASK_EVENTS, TRANSLATION_EVENTS, type Task, type TaskAssignedPayload, type TaskCreatedPayload, type TaskEventType, type TaskStatus, type TaskStatusChangedPayload, TasksResource, type TrackOptions, Tracker, type TranslateBatchInput, type TranslateTextInput, type TranslationCompletedPayload, TranslationError, type TranslationEventType, type TranslationRequestedPayload, TranslationResource, type TranslationResult, TruthClient, type TruthClientConfig, type UpdateTaskStatusInput, type VoicemailAuthResponse, generateUuidV7 };

package/dist/index.js

@@ -76,6 +76,7 @@ __export(src_exports, {
   PatientDetailsError: () => PatientDetailsError,
   PatientDetailsResource: () => PatientDetailsResource,
   PatientResource: () => PatientResource,
+  PhysiciansResource: () => PhysiciansResource,
   REMINDER_EVENTS: () => REMINDER_EVENTS,
   RemindersResource: () => RemindersResource,
   SECURITY_EVENTS: () => SECURITY_EVENTS,
@@ -678,6 +679,17 @@ var PatientDetailsResource = class {
       );
     });
   }
+  /**
+   * Trigger a server-side refresh of the patient's Elation medical
+   * records (medications, problems, allergies, appointments) into the
+   * Convex cache. Fire-and-forget — the UI should read via the Convex-
+   * reactive `usePatientMedical` hook.
+   */
+  refreshMedical(elationId) {
+    return __async(this, null, function* () {
+      return yield this.post("/patients/medical/refresh", { elationId });
+    });
+  }
 };
 
 // src/resources/patients.ts
@@ -760,6 +772,58 @@ var PatientResource = class {
   }
 };
 
+// src/resources/physicians.ts
+var PhysiciansResource = class {
+  constructor(convex) {
+    this.convex = convex;
+  }
+  /**
+   * Resolve a batch of physicians by Elation IDs. Missing ids are dropped.
+   */
+  getByElationIds(ids) {
+    return __async(this, null, function* () {
+      if (ids.length === 0) {
+        return [];
+      }
+      try {
+        const rows = yield this.convex.query(
+          "physicians:getByElationIds",
+          { ids }
+        );
+        return rows != null ? rows : [];
+      } catch (e) {
+        return [];
+      }
+    });
+  }
+  getByElationId(id) {
+    return __async(this, null, function* () {
+      try {
+        const row = yield this.convex.query(
+          "physicians:getByElationId",
+          { id }
+        );
+        return row != null ? row : null;
+      } catch (e) {
+        return null;
+      }
+    });
+  }
+  listByPractice(practice, limit) {
+    return __async(this, null, function* () {
+      try {
+        const rows = yield this.convex.query(
+          "physicians:listByPractice",
+          { practice, limit }
+        );
+        return rows != null ? rows : [];
+      } catch (e) {
+        return [];
+      }
+    });
+  }
+};
+
 // src/resources/reminders.ts
 var RemindersResource = class {
   constructor(convexClient) {
@@ -1167,6 +1231,7 @@ var TruthClient = class {
       this.convex
     );
     this.notes = new NotesResource(apiUrl, config.apiKey);
+    this.physicians = new PhysiciansResource(this.convex);
   }
   /**
    * The resolved Truth API base URL for this environment.
@@ -1328,6 +1393,7 @@ var ENVIRONMENTS = {
   PatientDetailsError,
   PatientDetailsResource,
   PatientResource,
+  PhysiciansResource,
   REMINDER_EVENTS,
   RemindersResource,
   SECURITY_EVENTS,