@hipnation-truth/sdk 0.15.2 → 0.16.0

package/dist/index.d.mts

@@ -1,3 +1,4 @@
+import * as convex_browser from 'convex/browser';
 import { ConvexHttpClient } from 'convex/browser';
 
 /**
@@ -320,7 +321,38 @@ declare class ConversationsResource {
     private static readonly REQUEST_TIMEOUT_MS;
     private readonly baseUrl;
     private readonly apiKey;
-    constructor(apiBaseUrl: string, apiKey: string);
+    private readonly convex;
+    constructor(apiBaseUrl: string, apiKey: string, convex?: convex_browser.ConvexHttpClient);
+    /**
+     * Mark a conversation read for the calling user (zeroes unreadCount,
+     * stamps `lastReadAt`). Calls the public Convex `markRead` mutation
+     * which enforces self-tenancy on the auth identity.
+     */
+    markRead(input: {
+        conversationId: string;
+        userId: string;
+    }): Promise<{
+        ok: true;
+    }>;
+    /**
+     * Mark a conversation unread for the calling user (sets unreadCount=1).
+     */
+    markUnread(input: {
+        conversationId: string;
+        userId: string;
+    }): Promise<{
+        updated: true;
+    }>;
+    /**
+     * Zero unread on every conversation the user has reads for, except
+     * those whose `providerPhone` is in `excludedProviderPhones`.
+     */
+    clearAllUnread(input: {
+        userId: string;
+        excludedProviderPhones?: string[];
+    }): Promise<{
+        cleared: number;
+    }>;
     private postRequest;
 }
 
@@ -440,6 +472,23 @@ declare class MessagesResource {
     private readonly baseUrl;
     private readonly apiKey;
     constructor(apiBaseUrl: string, apiKey: string);
+    /**
+     * Get an authenticated URL for a Dialpad voicemail recording.
+     *
+     * Replaces CommHub's `getAuthenticatedVoicemailUrl` Hasura mutation
+     * (which proxied to the legacy NestJS backend). Truth appends the
+     * Dialpad API key, follows redirects, strips the key from the final
+     * URL, and returns it for client-side audio playback.
+     *
+     * @param voicemailLink  The raw Dialpad voicemail download URL (value
+     *   of the `voicemail_link` field on the call event row).
+     * @returns An object with `url` (clean playback URL) and `expiresAt`
+     *   (ISO-8601 timestamp, ~5 min from request time, informational only).
+     */
+    getVoicemailUrl(voicemailLink: string): Promise<{
+        url: string;
+        expiresAt: string;
+    }>;
     /**
      * End a Dialpad call via the typed oRPC procedure (POST hangup, with
      * 404→`alreadyEnded` so the UI doesn't flash an error on a natural
@@ -1085,6 +1134,43 @@ declare class TranslationResource {
     detect(text: string): Promise<DetectionResult>;
 }
 
+/**
+ * UserSettingsResource — typed client for the Truth `userSettings` Convex
+ * table. Exposes the one mutation CommHub's Settings screen needs:
+ * `updateNotifications({ userId, notificationsEnabled })`.
+ *
+ * Server-side / imperative use:
+ *   truth.userSettings.updateNotifications({ userId, notificationsEnabled: true })
+ *
+ * Reactive React use lives in `@hipnation-truth/sdk/react` via
+ * `useUserSettings`.
+ */
+
+interface UserSettings {
+    _id: string;
+    userId: string;
+    notificationsEnabled: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+interface UpdateNotificationsInput {
+    userId: string;
+    notificationsEnabled: boolean;
+}
+interface UpdateNotificationsResult {
+    action: "inserted" | "updated";
+    id: string;
+}
+declare class UserSettingsResource {
+    private readonly convex;
+    constructor(convex: ConvexHttpClient);
+    /**
+     * Upsert notification preferences for a user. Creates the row if it
+     * doesn't exist; patches `notificationsEnabled` + `updatedAt` otherwise.
+     */
+    updateNotifications(input: UpdateNotificationsInput): Promise<UpdateNotificationsResult>;
+}
+
 /**
  * Typed event definitions for the Truth Platform event store.
  *
@@ -1476,6 +1562,8 @@ declare class TruthClient {
     readonly notifications: NotificationsResource;
     /** Conversation-tied writes — notes, tasks, outbound messages. */
     readonly conversations: ConversationsResource;
+    /** User settings — notification preferences (Convex-backed) */
+    readonly userSettings: UserSettingsResource;
     private readonly convex;
     private readonly tracker;
     private _vapidPublicKey;
@@ -1631,4 +1719,4 @@ declare function subscriptionToJSON(sub: PushSubscription): {
 };
 declare function onServiceWorkerMessage(type: string, callback: (payload: unknown) => void): () => void;
 
-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 CancelScheduledNotificationResult, type ConversationAddress, type ConversationAttachmentDownloadedPayload, type ConversationAttachmentUploadedPayload, type ConversationCreatedPayload, type ConversationEventType, type ConversationMarkedReadPayload, type ConversationMessageReceivedPayload, type ConversationMessageSentPayload, type ConversationTaskPriority, type ConversationTaskStatus, ConversationsError, ConversationsResource, type CreateConversationNoteInput, type CreateConversationTaskInput, 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 NotificationPlatform, type NotificationPreferences, type NotificationSentPayload, NotificationsError, NotificationsResource, 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 PushEventPayload, type PushNoteToElationInput, type PushNoteToElationResult, REMINDER_EVENTS, type RecordAttachmentInput, type RegisterDeviceInput, type RegisterDeviceResult, type Reminder, type ReminderEventType, type ReminderScheduledPayload, type ReminderStatus, type ReminderTriggeredPayload, RemindersResource, SECURITY_EVENTS, type ScheduleNotificationInput, type ScheduleNotificationResult, type ScheduleReminderInput, type ScheduleReminderResult, type ScheduledJobStatus, type ScheduledNotification, type SecurityAccessDeniedPayload, type SecurityEventType, type SendConversationMessageInput, type SendConversationMessageResult, type SendNotificationInput, type SendNotificationResult, type SendSmsParams, type SendSmsResponse, type SetConversationTaskStatusInput, 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 UnregisterDeviceInput, type UpdatePreferencesInput, type UpdateTaskStatusInput, type VoicemailAuthResponse, type WebPushConfig, generateUuidV7, isWebPushSupported, onServiceWorkerMessage, registerServiceWorker, subscribeToPush, subscriptionToJSON };
+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 CancelScheduledNotificationResult, type ConversationAddress, type ConversationAttachmentDownloadedPayload, type ConversationAttachmentUploadedPayload, type ConversationCreatedPayload, type ConversationEventType, type ConversationMarkedReadPayload, type ConversationMessageReceivedPayload, type ConversationMessageSentPayload, type ConversationTaskPriority, type ConversationTaskStatus, ConversationsError, ConversationsResource, type CreateConversationNoteInput, type CreateConversationTaskInput, 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 NotificationPlatform, type NotificationPreferences, type NotificationSentPayload, NotificationsError, NotificationsResource, 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 PushEventPayload, type PushNoteToElationInput, type PushNoteToElationResult, REMINDER_EVENTS, type RecordAttachmentInput, type RegisterDeviceInput, type RegisterDeviceResult, type Reminder, type ReminderEventType, type ReminderScheduledPayload, type ReminderStatus, type ReminderTriggeredPayload, RemindersResource, SECURITY_EVENTS, type ScheduleNotificationInput, type ScheduleNotificationResult, type ScheduleReminderInput, type ScheduleReminderResult, type ScheduledJobStatus, type ScheduledNotification, type SecurityAccessDeniedPayload, type SecurityEventType, type SendConversationMessageInput, type SendConversationMessageResult, type SendNotificationInput, type SendNotificationResult, type SendSmsParams, type SendSmsResponse, type SetConversationTaskStatusInput, 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 UnregisterDeviceInput, type UpdateNotificationsInput, type UpdateNotificationsResult, type UpdatePreferencesInput, type UpdateTaskStatusInput, type UserSettings, UserSettingsResource, type VoicemailAuthResponse, type WebPushConfig, generateUuidV7, isWebPushSupported, onServiceWorkerMessage, registerServiceWorker, subscribeToPush, subscriptionToJSON };

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import * as convex_browser from 'convex/browser';
 import { ConvexHttpClient } from 'convex/browser';
 
 /**
@@ -320,7 +321,38 @@ declare class ConversationsResource {
     private static readonly REQUEST_TIMEOUT_MS;
     private readonly baseUrl;
     private readonly apiKey;
-    constructor(apiBaseUrl: string, apiKey: string);
+    private readonly convex;
+    constructor(apiBaseUrl: string, apiKey: string, convex?: convex_browser.ConvexHttpClient);
+    /**
+     * Mark a conversation read for the calling user (zeroes unreadCount,
+     * stamps `lastReadAt`). Calls the public Convex `markRead` mutation
+     * which enforces self-tenancy on the auth identity.
+     */
+    markRead(input: {
+        conversationId: string;
+        userId: string;
+    }): Promise<{
+        ok: true;
+    }>;
+    /**
+     * Mark a conversation unread for the calling user (sets unreadCount=1).
+     */
+    markUnread(input: {
+        conversationId: string;
+        userId: string;
+    }): Promise<{
+        updated: true;
+    }>;
+    /**
+     * Zero unread on every conversation the user has reads for, except
+     * those whose `providerPhone` is in `excludedProviderPhones`.
+     */
+    clearAllUnread(input: {
+        userId: string;
+        excludedProviderPhones?: string[];
+    }): Promise<{
+        cleared: number;
+    }>;
     private postRequest;
 }
 
@@ -440,6 +472,23 @@ declare class MessagesResource {
     private readonly baseUrl;
     private readonly apiKey;
     constructor(apiBaseUrl: string, apiKey: string);
+    /**
+     * Get an authenticated URL for a Dialpad voicemail recording.
+     *
+     * Replaces CommHub's `getAuthenticatedVoicemailUrl` Hasura mutation
+     * (which proxied to the legacy NestJS backend). Truth appends the
+     * Dialpad API key, follows redirects, strips the key from the final
+     * URL, and returns it for client-side audio playback.
+     *
+     * @param voicemailLink  The raw Dialpad voicemail download URL (value
+     *   of the `voicemail_link` field on the call event row).
+     * @returns An object with `url` (clean playback URL) and `expiresAt`
+     *   (ISO-8601 timestamp, ~5 min from request time, informational only).
+     */
+    getVoicemailUrl(voicemailLink: string): Promise<{
+        url: string;
+        expiresAt: string;
+    }>;
     /**
      * End a Dialpad call via the typed oRPC procedure (POST hangup, with
      * 404→`alreadyEnded` so the UI doesn't flash an error on a natural
@@ -1085,6 +1134,43 @@ declare class TranslationResource {
     detect(text: string): Promise<DetectionResult>;
 }
 
+/**
+ * UserSettingsResource — typed client for the Truth `userSettings` Convex
+ * table. Exposes the one mutation CommHub's Settings screen needs:
+ * `updateNotifications({ userId, notificationsEnabled })`.
+ *
+ * Server-side / imperative use:
+ *   truth.userSettings.updateNotifications({ userId, notificationsEnabled: true })
+ *
+ * Reactive React use lives in `@hipnation-truth/sdk/react` via
+ * `useUserSettings`.
+ */
+
+interface UserSettings {
+    _id: string;
+    userId: string;
+    notificationsEnabled: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+interface UpdateNotificationsInput {
+    userId: string;
+    notificationsEnabled: boolean;
+}
+interface UpdateNotificationsResult {
+    action: "inserted" | "updated";
+    id: string;
+}
+declare class UserSettingsResource {
+    private readonly convex;
+    constructor(convex: ConvexHttpClient);
+    /**
+     * Upsert notification preferences for a user. Creates the row if it
+     * doesn't exist; patches `notificationsEnabled` + `updatedAt` otherwise.
+     */
+    updateNotifications(input: UpdateNotificationsInput): Promise<UpdateNotificationsResult>;
+}
+
 /**
  * Typed event definitions for the Truth Platform event store.
  *
@@ -1476,6 +1562,8 @@ declare class TruthClient {
     readonly notifications: NotificationsResource;
     /** Conversation-tied writes — notes, tasks, outbound messages. */
     readonly conversations: ConversationsResource;
+    /** User settings — notification preferences (Convex-backed) */
+    readonly userSettings: UserSettingsResource;
     private readonly convex;
     private readonly tracker;
     private _vapidPublicKey;
@@ -1631,4 +1719,4 @@ declare function subscriptionToJSON(sub: PushSubscription): {
 };
 declare function onServiceWorkerMessage(type: string, callback: (payload: unknown) => void): () => void;
 
-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 CancelScheduledNotificationResult, type ConversationAddress, type ConversationAttachmentDownloadedPayload, type ConversationAttachmentUploadedPayload, type ConversationCreatedPayload, type ConversationEventType, type ConversationMarkedReadPayload, type ConversationMessageReceivedPayload, type ConversationMessageSentPayload, type ConversationTaskPriority, type ConversationTaskStatus, ConversationsError, ConversationsResource, type CreateConversationNoteInput, type CreateConversationTaskInput, 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 NotificationPlatform, type NotificationPreferences, type NotificationSentPayload, NotificationsError, NotificationsResource, 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 PushEventPayload, type PushNoteToElationInput, type PushNoteToElationResult, REMINDER_EVENTS, type RecordAttachmentInput, type RegisterDeviceInput, type RegisterDeviceResult, type Reminder, type ReminderEventType, type ReminderScheduledPayload, type ReminderStatus, type ReminderTriggeredPayload, RemindersResource, SECURITY_EVENTS, type ScheduleNotificationInput, type ScheduleNotificationResult, type ScheduleReminderInput, type ScheduleReminderResult, type ScheduledJobStatus, type ScheduledNotification, type SecurityAccessDeniedPayload, type SecurityEventType, type SendConversationMessageInput, type SendConversationMessageResult, type SendNotificationInput, type SendNotificationResult, type SendSmsParams, type SendSmsResponse, type SetConversationTaskStatusInput, 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 UnregisterDeviceInput, type UpdatePreferencesInput, type UpdateTaskStatusInput, type VoicemailAuthResponse, type WebPushConfig, generateUuidV7, isWebPushSupported, onServiceWorkerMessage, registerServiceWorker, subscribeToPush, subscriptionToJSON };
+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 CancelScheduledNotificationResult, type ConversationAddress, type ConversationAttachmentDownloadedPayload, type ConversationAttachmentUploadedPayload, type ConversationCreatedPayload, type ConversationEventType, type ConversationMarkedReadPayload, type ConversationMessageReceivedPayload, type ConversationMessageSentPayload, type ConversationTaskPriority, type ConversationTaskStatus, ConversationsError, ConversationsResource, type CreateConversationNoteInput, type CreateConversationTaskInput, 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 NotificationPlatform, type NotificationPreferences, type NotificationSentPayload, NotificationsError, NotificationsResource, 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 PushEventPayload, type PushNoteToElationInput, type PushNoteToElationResult, REMINDER_EVENTS, type RecordAttachmentInput, type RegisterDeviceInput, type RegisterDeviceResult, type Reminder, type ReminderEventType, type ReminderScheduledPayload, type ReminderStatus, type ReminderTriggeredPayload, RemindersResource, SECURITY_EVENTS, type ScheduleNotificationInput, type ScheduleNotificationResult, type ScheduleReminderInput, type ScheduleReminderResult, type ScheduledJobStatus, type ScheduledNotification, type SecurityAccessDeniedPayload, type SecurityEventType, type SendConversationMessageInput, type SendConversationMessageResult, type SendNotificationInput, type SendNotificationResult, type SendSmsParams, type SendSmsResponse, type SetConversationTaskStatusInput, 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 UnregisterDeviceInput, type UpdateNotificationsInput, type UpdateNotificationsResult, type UpdatePreferencesInput, type UpdateTaskStatusInput, type UserSettings, UserSettingsResource, type VoicemailAuthResponse, type WebPushConfig, generateUuidV7, isWebPushSupported, onServiceWorkerMessage, registerServiceWorker, subscribeToPush, subscriptionToJSON };

package/dist/index.js

@@ -91,6 +91,7 @@ __export(src_exports, {
   TranslationError: () => TranslationError,
   TranslationResource: () => TranslationResource,
   TruthClient: () => TruthClient,
+  UserSettingsResource: () => UserSettingsResource,
   generateUuidV7: () => generateUuidV7,
   isWebPushSupported: () => isWebPushSupported,
   onServiceWorkerMessage: () => onServiceWorkerMessage,
@@ -373,14 +374,72 @@ var ConversationMessagesSubresource = class {
   }
 };
 var _ConversationsResource = class _ConversationsResource {
-  constructor(apiBaseUrl, apiKey) {
+  constructor(apiBaseUrl, apiKey, convex) {
     this.baseUrl = apiBaseUrl;
     this.apiKey = apiKey;
+    this.convex = convex != null ? convex : null;
     const post = (path, body) => this.postRequest(path, body);
     this.notes = new ConversationNotesSubresource(post);
     this.tasks = new ConversationTasksSubresource(post);
     this.messages = new ConversationMessagesSubresource(post);
   }
+  /**
+   * Mark a conversation read for the calling user (zeroes unreadCount,
+   * stamps `lastReadAt`). Calls the public Convex `markRead` mutation
+   * which enforces self-tenancy on the auth identity.
+   */
+  markRead(input) {
+    return __async(this, null, function* () {
+      if (!this.convex) {
+        throw new ConversationsError(
+          "/markRead",
+          0,
+          "ConversationsResource missing Convex client"
+        );
+      }
+      return yield this.convex.mutation(
+        "conversations:markRead",
+        input
+      );
+    });
+  }
+  /**
+   * Mark a conversation unread for the calling user (sets unreadCount=1).
+   */
+  markUnread(input) {
+    return __async(this, null, function* () {
+      if (!this.convex) {
+        throw new ConversationsError(
+          "/markUnread",
+          0,
+          "ConversationsResource missing Convex client"
+        );
+      }
+      return yield this.convex.mutation(
+        "conversations:markUnread",
+        input
+      );
+    });
+  }
+  /**
+   * Zero unread on every conversation the user has reads for, except
+   * those whose `providerPhone` is in `excludedProviderPhones`.
+   */
+  clearAllUnread(input) {
+    return __async(this, null, function* () {
+      if (!this.convex) {
+        throw new ConversationsError(
+          "/clearAllUnread",
+          0,
+          "ConversationsResource missing Convex client"
+        );
+      }
+      return yield this.convex.mutation(
+        "conversations:clearAllUnread",
+        input
+      );
+    });
+  }
   postRequest(path, body) {
     return __async(this, null, function* () {
       if (!this.apiKey) {
@@ -657,6 +716,42 @@ var MessagesResource = class {
     this.baseUrl = apiBaseUrl;
     this.apiKey = apiKey;
   }
+  /**
+   * Get an authenticated URL for a Dialpad voicemail recording.
+   *
+   * Replaces CommHub's `getAuthenticatedVoicemailUrl` Hasura mutation
+   * (which proxied to the legacy NestJS backend). Truth appends the
+   * Dialpad API key, follows redirects, strips the key from the final
+   * URL, and returns it for client-side audio playback.
+   *
+   * @param voicemailLink  The raw Dialpad voicemail download URL (value
+   *   of the `voicemail_link` field on the call event row).
+   * @returns An object with `url` (clean playback URL) and `expiresAt`
+   *   (ISO-8601 timestamp, ~5 min from request time, informational only).
+   */
+  getVoicemailUrl(voicemailLink) {
+    return __async(this, null, function* () {
+      const res = yield fetch(
+        `${this.baseUrl}/api/conversations/voicemail/url`,
+        {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            Accept: "application/json",
+            "X-API-Key": this.apiKey
+          },
+          body: JSON.stringify({ voicemailLink })
+        }
+      );
+      if (!res.ok) {
+        const text = yield res.text().catch(() => "");
+        throw new Error(
+          `messages.getVoicemailUrl failed (HTTP ${res.status}): ${text.slice(0, 200)}`
+        );
+      }
+      return yield res.json();
+    });
+  }
   /**
    * End a Dialpad call via the typed oRPC procedure (POST hangup, with
    * 404→`alreadyEnded` so the UI doesn't flash an error on a natural
@@ -1458,6 +1553,24 @@ var TranslationResource = class {
   }
 };
 
+// src/resources/user-settings.ts
+var import_server = require("convex/server");
+var upsertNotificationsRef = (0, import_server.makeFunctionReference)("userSettings:upsertNotifications");
+var UserSettingsResource = class {
+  constructor(convex) {
+    this.convex = convex;
+  }
+  /**
+   * Upsert notification preferences for a user. Creates the row if it
+   * doesn't exist; patches `notificationsEnabled` + `updatedAt` otherwise.
+   */
+  updateNotifications(input) {
+    return __async(this, null, function* () {
+      return this.convex.mutation(upsertNotificationsRef, input);
+    });
+  }
+};
+
 // src/tracking/tracker.ts
 function generateUuidV7() {
   const now = Date.now();
@@ -1754,7 +1867,12 @@ var TruthClient = class {
     this.notes = new NotesResource(apiUrl, config.apiKey);
     this.physicians = new PhysiciansResource(this.convex);
     this.notifications = new NotificationsResource(apiUrl, config.apiKey);
-    this.conversations = new ConversationsResource(apiUrl, config.apiKey);
+    this.conversations = new ConversationsResource(
+      apiUrl,
+      config.apiKey,
+      this.convex
+    );
+    this.userSettings = new UserSettingsResource(this.convex);
     this._serviceWorkerPath = (_h = config.serviceWorkerPath) != null ? _h : "/truth-sw.js";
     if (typeof window !== "undefined" && isWebPushSupported() && config.autoInitServiceWorker !== false) {
       this._webPushReady = this.initWebPush();
@@ -1964,6 +2082,7 @@ var ENVIRONMENTS = {
   TranslationError,
   TranslationResource,
   TruthClient,
+  UserSettingsResource,
   generateUuidV7,
   isWebPushSupported,
   onServiceWorkerMessage,