@hipnation-truth/sdk 0.2.0 → 0.3.0

package/dist/index.d.mts

@@ -65,6 +65,7 @@ interface AppointmentListOptions {
 declare const ENVIRONMENTS: {
     readonly local: "local";
     readonly staging: "staging";
+    readonly stg: "stg";
     readonly sandbox: "sandbox";
     readonly uat: "uat";
     readonly production: "production";
@@ -446,6 +447,37 @@ declare class PatientDetailsResource {
     getMedical(elationId: string): Promise<PatientMedicalDetailsResult>;
 }
 
+/**
+ * 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[]>;
+}
+
 /**
  * Patient interfaces for the Truth SDK.
  */
@@ -1066,6 +1098,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);
@@ -1193,4 +1227,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

@@ -65,6 +65,7 @@ interface AppointmentListOptions {
 declare const ENVIRONMENTS: {
     readonly local: "local";
     readonly staging: "staging";
+    readonly stg: "stg";
     readonly sandbox: "sandbox";
     readonly uat: "uat";
     readonly production: "production";
@@ -446,6 +447,37 @@ declare class PatientDetailsResource {
     getMedical(elationId: string): Promise<PatientMedicalDetailsResult>;
 }
 
+/**
+ * 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[]>;
+}
+
 /**
  * Patient interfaces for the Truth SDK.
  */
@@ -1066,6 +1098,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);
@@ -1193,4 +1227,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,
@@ -680,6 +681,58 @@ var PatientDetailsResource = 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/patients.ts
 var PatientResource = class {
   constructor(convexClient) {
@@ -968,8 +1021,9 @@ function generateUuidV7() {
 var API_URLS = {
   local: "http://localhost:3000",
   staging: "https://app.sandbox.communication-hub.com",
+  stg: "https://app.sandbox.communication-hub.com",
   sandbox: "https://app.sandbox.communication-hub.com",
-  uat: "https://app.sandbox.communication-hub.com",
+  uat: "https://app.truth.communication-hub.com",
   production: "https://app.truth.communication-hub.com"
 };
 var DEFAULT_BATCH_SIZE = 25;
@@ -1131,8 +1185,9 @@ function sleep(ms) {
 var CONVEX_URLS = {
   local: "https://courteous-duck-623.convex.cloud",
   staging: "https://courteous-duck-623.convex.cloud",
+  stg: "https://courteous-duck-623.convex.cloud",
   sandbox: "https://courteous-duck-623.convex.cloud",
-  uat: "https://courteous-duck-623.convex.cloud",
+  uat: "https://gallant-gecko-217.convex.cloud",
   production: "https://gallant-gecko-217.convex.cloud"
 };
 var TruthClient = class {
@@ -1165,6 +1220,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.
@@ -1298,6 +1354,7 @@ var EVENT_TYPES = {
 var ENVIRONMENTS = {
   local: "local",
   staging: "staging",
+  stg: "stg",
   sandbox: "sandbox",
   uat: "uat",
   production: "production"
@@ -1325,6 +1382,7 @@ var ENVIRONMENTS = {
   PatientDetailsError,
   PatientDetailsResource,
   PatientResource,
+  PhysiciansResource,
   REMINDER_EVENTS,
   RemindersResource,
   SECURITY_EVENTS,