@hipnation-truth/sdk 0.25.1 → 0.25.3

package/dist/index.d.mts

@@ -281,6 +281,12 @@ interface SetConversationTaskStatusInput {
     taskId: string;
     status: ConversationTaskStatus;
     resolvedBy?: string;
+    /**
+     * Email of the user performing the action. Truth excludes the actor
+     * from the task-action push fan-out (legacy parity) — omit it and the
+     * actor notifies themselves.
+     */
+    actor?: string;
 }
 interface UpdateConversationTaskInput {
     taskId: string;
@@ -295,6 +301,18 @@ interface UpdateConversationTaskInput {
     status?: ConversationTaskStatus;
     assignee?: string;
     type?: string;
+    /**
+     * Email of the user performing the action. Truth excludes the actor
+     * from the task-action push fan-out (legacy parity) — omit it and the
+     * actor notifies themselves.
+     */
+    actor?: string;
+}
+interface SetConversationTaskArchivedInput {
+    taskId: string;
+    archived: boolean;
+    /** Email of the acting user — excluded from the archive push fan-out. */
+    actor?: string;
 }
 interface SendConversationMessageInput {
     fromNumber: string;
@@ -331,6 +349,11 @@ declare class ConversationTasksSubresource {
     setStatus(input: SetConversationTaskStatusInput): Promise<{
         ok: true;
     }>;
+    /** Archive or un-archive a task (hides it from My Tasks without deleting). */
+    setArchived(input: SetConversationTaskArchivedInput): Promise<{
+        ok: true;
+        changed: boolean;
+    }>;
     /**
      * Update task fields (priority, assignee, description, type). Wraps
      * `PATCH /api/conversations/tasks/{id}` so CommHub doesn't have to
@@ -559,7 +582,8 @@ declare class DialpadProxyError extends Error {
  * EHR proxy resource — typed access to Truth's EHR proxy endpoints.
  *
  * Provides per-provider proxy methods so consumers never construct
- * proxy URLs manually.
+ * proxy URLs manually. Every request carries the application's
+ * `X-API-Key` — Truth's API gate rejects unauthenticated callers.
  *
  * @example
  * ```ts
@@ -571,28 +595,23 @@ declare class DialpadProxyError extends Error {
 declare class EhrProviderProxy {
     private readonly baseUrl;
     private readonly provider;
-    constructor(apiBaseUrl: string, provider: string);
+    private readonly apiKey;
+    constructor(apiBaseUrl: string, provider: string, apiKey: string);
+    private headers;
+    private request;
     /**
      * GET request to the EHR proxy.
      * @param path — path relative to the provider root (e.g., "/patients/123/")
      * @param params — optional query parameters
      */
     get<T = unknown>(path: string, params?: Record<string, unknown>): Promise<T>;
-    /**
-     * POST request to the EHR proxy.
-     */
+    /** POST request to the EHR proxy. */
     post<T = unknown>(path: string, body?: unknown): Promise<T>;
-    /**
-     * PUT request to the EHR proxy.
-     */
+    /** PUT request to the EHR proxy. */
     put<T = unknown>(path: string, body?: unknown): Promise<T>;
-    /**
-     * PATCH request to the EHR proxy.
-     */
+    /** PATCH request to the EHR proxy. */
     patch<T = unknown>(path: string, body?: unknown): Promise<T>;
-    /**
-     * DELETE request to the EHR proxy.
-     */
+    /** DELETE request to the EHR proxy. */
     delete<T = unknown>(path: string): Promise<T>;
 }
 declare class EhrResource {
@@ -600,7 +619,7 @@ declare class EhrResource {
     readonly elation: EhrProviderProxy;
     /** Hint Health proxy */
     readonly hint: EhrProviderProxy;
-    constructor(apiBaseUrl: string);
+    constructor(apiBaseUrl: string, apiKey: string);
 }
 declare class EhrProxyError extends Error {
     readonly provider: string;

package/dist/index.d.ts

@@ -281,6 +281,12 @@ interface SetConversationTaskStatusInput {
     taskId: string;
     status: ConversationTaskStatus;
     resolvedBy?: string;
+    /**
+     * Email of the user performing the action. Truth excludes the actor
+     * from the task-action push fan-out (legacy parity) — omit it and the
+     * actor notifies themselves.
+     */
+    actor?: string;
 }
 interface UpdateConversationTaskInput {
     taskId: string;
@@ -295,6 +301,18 @@ interface UpdateConversationTaskInput {
     status?: ConversationTaskStatus;
     assignee?: string;
     type?: string;
+    /**
+     * Email of the user performing the action. Truth excludes the actor
+     * from the task-action push fan-out (legacy parity) — omit it and the
+     * actor notifies themselves.
+     */
+    actor?: string;
+}
+interface SetConversationTaskArchivedInput {
+    taskId: string;
+    archived: boolean;
+    /** Email of the acting user — excluded from the archive push fan-out. */
+    actor?: string;
 }
 interface SendConversationMessageInput {
     fromNumber: string;
@@ -331,6 +349,11 @@ declare class ConversationTasksSubresource {
     setStatus(input: SetConversationTaskStatusInput): Promise<{
         ok: true;
     }>;
+    /** Archive or un-archive a task (hides it from My Tasks without deleting). */
+    setArchived(input: SetConversationTaskArchivedInput): Promise<{
+        ok: true;
+        changed: boolean;
+    }>;
     /**
      * Update task fields (priority, assignee, description, type). Wraps
      * `PATCH /api/conversations/tasks/{id}` so CommHub doesn't have to
@@ -559,7 +582,8 @@ declare class DialpadProxyError extends Error {
  * EHR proxy resource — typed access to Truth's EHR proxy endpoints.
  *
  * Provides per-provider proxy methods so consumers never construct
- * proxy URLs manually.
+ * proxy URLs manually. Every request carries the application's
+ * `X-API-Key` — Truth's API gate rejects unauthenticated callers.
  *
  * @example
  * ```ts
@@ -571,28 +595,23 @@ declare class DialpadProxyError extends Error {
 declare class EhrProviderProxy {
     private readonly baseUrl;
     private readonly provider;
-    constructor(apiBaseUrl: string, provider: string);
+    private readonly apiKey;
+    constructor(apiBaseUrl: string, provider: string, apiKey: string);
+    private headers;
+    private request;
     /**
      * GET request to the EHR proxy.
      * @param path — path relative to the provider root (e.g., "/patients/123/")
      * @param params — optional query parameters
      */
     get<T = unknown>(path: string, params?: Record<string, unknown>): Promise<T>;
-    /**
-     * POST request to the EHR proxy.
-     */
+    /** POST request to the EHR proxy. */
     post<T = unknown>(path: string, body?: unknown): Promise<T>;
-    /**
-     * PUT request to the EHR proxy.
-     */
+    /** PUT request to the EHR proxy. */
     put<T = unknown>(path: string, body?: unknown): Promise<T>;
-    /**
-     * PATCH request to the EHR proxy.
-     */
+    /** PATCH request to the EHR proxy. */
     patch<T = unknown>(path: string, body?: unknown): Promise<T>;
-    /**
-     * DELETE request to the EHR proxy.
-     */
+    /** DELETE request to the EHR proxy. */
     delete<T = unknown>(path: string): Promise<T>;
 }
 declare class EhrResource {
@@ -600,7 +619,7 @@ declare class EhrResource {
     readonly elation: EhrProviderProxy;
     /** Hint Health proxy */
     readonly hint: EhrProviderProxy;
-    constructor(apiBaseUrl: string);
+    constructor(apiBaseUrl: string, apiKey: string);
 }
 declare class EhrProxyError extends Error {
     readonly provider: string;

package/dist/index.js

@@ -398,10 +398,22 @@ var ConversationTasksSubresource = class {
     return __async(this, null, function* () {
       return this.post(
         `/conversations/tasks/${encodeURIComponent(input.taskId)}/status`,
-        __spreadValues({
+        __spreadValues(__spreadValues({
           id: input.taskId,
           status: input.status
-        }, input.resolvedBy ? { resolvedBy: input.resolvedBy } : {})
+        }, input.resolvedBy ? { resolvedBy: input.resolvedBy } : {}), input.actor ? { actor: input.actor } : {})
+      );
+    });
+  }
+  /** Archive or un-archive a task (hides it from My Tasks without deleting). */
+  setArchived(input) {
+    return __async(this, null, function* () {
+      return this.post(
+        `/conversations/tasks/${encodeURIComponent(input.taskId)}/archive`,
+        __spreadValues({
+          id: input.taskId,
+          archived: input.archived
+        }, input.actor ? { actor: input.actor } : {})
       );
     });
   }
@@ -414,12 +426,12 @@ var ConversationTasksSubresource = class {
     return __async(this, null, function* () {
       return this.patch(
         `/conversations/tasks/${encodeURIComponent(input.taskId)}`,
-        __spreadValues(__spreadValues(__spreadValues(__spreadValues(__spreadValues({
+        __spreadValues(__spreadValues(__spreadValues(__spreadValues(__spreadValues(__spreadValues({
           id: input.taskId,
           conversationId: input.conversationId,
           author: input.author,
           description: input.description
-        }, input.title !== void 0 ? { title: input.title } : {}), input.priority ? { priority: input.priority } : {}), input.status ? { status: input.status } : {}), input.assignee !== void 0 ? { assignee: input.assignee } : {}), input.type !== void 0 ? { type: input.type } : {})
+        }, input.title !== void 0 ? { title: input.title } : {}), input.priority ? { priority: input.priority } : {}), input.status ? { status: input.status } : {}), input.assignee !== void 0 ? { assignee: input.assignee } : {}), input.type !== void 0 ? { type: input.type } : {}), input.actor ? { actor: input.actor } : {})
       );
     });
   }
@@ -921,16 +933,22 @@ var DialpadProxyError = class extends Error {
 
 // src/resources/ehr.ts
 var EhrProviderProxy = class {
-  constructor(apiBaseUrl, provider) {
+  constructor(apiBaseUrl, provider, apiKey) {
     this.baseUrl = apiBaseUrl;
     this.provider = provider;
+    this.apiKey = apiKey;
   }
-  /**
-   * GET request to the EHR proxy.
-   * @param path — path relative to the provider root (e.g., "/patients/123/")
-   * @param params — optional query parameters
-   */
-  get(path, params) {
+  headers(withBody) {
+    const headers = {
+      Accept: "application/json",
+      "X-API-Key": this.apiKey
+    };
+    if (withBody) {
+      headers["Content-Type"] = "application/json";
+    }
+    return headers;
+  }
+  request(method, path, body, params) {
     return __async(this, null, function* () {
       const url = new URL(`/api/ehr/${this.provider}${path}`, this.baseUrl);
       if (params) {
@@ -941,96 +959,55 @@ var EhrProviderProxy = class {
         }
       }
       const response = yield fetch(url.toString(), {
-        method: "GET",
-        headers: { Accept: "application/json" }
+        method,
+        headers: this.headers(body !== void 0),
+        body: body !== void 0 ? JSON.stringify(body) : void 0
       });
       if (!response.ok) {
-        throw new EhrProxyError(this.provider, "GET", path, response.status);
+        throw new EhrProxyError(this.provider, method, path, response.status);
       }
       return yield response.json();
     });
   }
   /**
-   * POST request to the EHR proxy.
+   * GET request to the EHR proxy.
+   * @param path — path relative to the provider root (e.g., "/patients/123/")
+   * @param params — optional query parameters
    */
+  get(path, params) {
+    return __async(this, null, function* () {
+      return this.request("GET", path, void 0, params);
+    });
+  }
+  /** POST request to the EHR proxy. */
   post(path, body) {
     return __async(this, null, function* () {
-      const url = `${this.baseUrl}/api/ehr/${this.provider}${path}`;
-      const response = yield fetch(url, {
-        method: "POST",
-        headers: {
-          "Content-Type": "application/json",
-          Accept: "application/json"
-        },
-        body: body !== void 0 ? JSON.stringify(body) : void 0
-      });
-      if (!response.ok) {
-        throw new EhrProxyError(this.provider, "POST", path, response.status);
-      }
-      return yield response.json();
+      return this.request("POST", path, body);
     });
   }
-  /**
-   * PUT request to the EHR proxy.
-   */
+  /** PUT request to the EHR proxy. */
   put(path, body) {
     return __async(this, null, function* () {
-      const url = `${this.baseUrl}/api/ehr/${this.provider}${path}`;
-      const response = yield fetch(url, {
-        method: "PUT",
-        headers: {
-          "Content-Type": "application/json",
-          Accept: "application/json"
-        },
-        body: body !== void 0 ? JSON.stringify(body) : void 0
-      });
-      if (!response.ok) {
-        throw new EhrProxyError(this.provider, "PUT", path, response.status);
-      }
-      return yield response.json();
+      return this.request("PUT", path, body);
     });
   }
-  /**
-   * PATCH request to the EHR proxy.
-   */
+  /** PATCH request to the EHR proxy. */
   patch(path, body) {
     return __async(this, null, function* () {
-      const url = `${this.baseUrl}/api/ehr/${this.provider}${path}`;
-      const response = yield fetch(url, {
-        method: "PATCH",
-        headers: {
-          "Content-Type": "application/json",
-          Accept: "application/json"
-        },
-        body: body !== void 0 ? JSON.stringify(body) : void 0
-      });
-      if (!response.ok) {
-        throw new EhrProxyError(this.provider, "PATCH", path, response.status);
-      }
-      return yield response.json();
+      return this.request("PATCH", path, body);
     });
   }
-  /**
-   * DELETE request to the EHR proxy.
-   */
+  /** DELETE request to the EHR proxy. */
   delete(path) {
     return __async(this, null, function* () {
-      const url = `${this.baseUrl}/api/ehr/${this.provider}${path}`;
-      const response = yield fetch(url, {
-        method: "DELETE",
-        headers: { Accept: "application/json" }
-      });
-      if (!response.ok) {
-        throw new EhrProxyError(this.provider, "DELETE", path, response.status);
-      }
-      return yield response.json();
+      return this.request("DELETE", path);
     });
   }
 };
 var EhrResource = class {
-  constructor(apiBaseUrl) {
-    this.elation = new EhrProviderProxy(apiBaseUrl, "elation");
-    this.hint = new EhrProviderProxy(apiBaseUrl, "hint");
+  constructor(apiBaseUrl, apiKey) {
+    this.elation = new EhrProviderProxy(apiBaseUrl, "elation", apiKey);
+    this.hint = new EhrProviderProxy(apiBaseUrl, "hint", apiKey);
   }
 };
 var EhrProxyError = class extends Error {
@@ -1995,7 +1972,7 @@ var TruthClient = class {
     const apiUrl = this.tracker.apiUrl;
     this.patients = new PatientResource(this.convex);
     this.appointments = new AppointmentResource(this.convex);
-    this.ehr = new EhrResource(apiUrl);
+    this.ehr = new EhrResource(apiUrl, config.apiKey);
     this.messages = new MessagesResource(apiUrl, config.apiKey);
     this.reminders = new RemindersResource(this.convex);
     this.translation = new TranslationResource(apiUrl, config.apiKey);