@hipnation-truth/sdk 0.17.1 → 0.18.0

package/dist/index.d.mts

@@ -266,6 +266,19 @@ interface SetConversationTaskStatusInput {
     status: ConversationTaskStatus;
     resolvedBy?: string;
 }
+interface UpdateConversationTaskInput {
+    taskId: string;
+    /** Conversation the task belongs to. Truth requires this on PATCH. */
+    conversationId: string;
+    /** Required by the Truth task router — see `messages/procedures/tasks.ts`. */
+    author: string;
+    description: string;
+    /** Optional patch fields — pass only the ones you want to change. */
+    priority?: ConversationTaskPriority;
+    status?: ConversationTaskStatus;
+    assignee?: string;
+    type?: string;
+}
 interface SendConversationMessageInput {
     fromNumber: string;
     toNumber: string;
@@ -291,7 +304,8 @@ declare class ConversationNotesSubresource {
 }
 declare class ConversationTasksSubresource {
     private readonly post;
-    constructor(post: <T>(path: string, body: unknown) => Promise<T>);
+    private readonly patch;
+    constructor(post: <T>(path: string, body: unknown) => Promise<T>, patch: <T>(path: string, body: unknown) => Promise<T>);
     /** Create a task on a conversation. */
     create(input: CreateConversationTaskInput): Promise<{
         id: string;
@@ -300,6 +314,14 @@ declare class ConversationTasksSubresource {
     setStatus(input: SetConversationTaskStatusInput): Promise<{
         ok: true;
     }>;
+    /**
+     * Update task fields (priority, assignee, description, type). Wraps
+     * `PATCH /api/conversations/tasks/{id}` so CommHub doesn't have to
+     * direct-fetch for non-status field edits.
+     */
+    update(input: UpdateConversationTaskInput): Promise<{
+        ok: true;
+    }>;
 }
 declare class ConversationMessagesSubresource {
     private readonly post;
@@ -354,6 +376,13 @@ declare class ConversationsResource {
         cleared: number;
     }>;
     private postRequest;
+    /**
+     * PATCH variant of `postRequest`. Mirrors the timeout + API-key
+     * handling so callers like `tasks.update()` don't need to roll their
+     * own fetch. The Truth task router treats unknown methods as 405, so
+     * a dedicated PATCH path is required.
+     */
+    private patchRequest;
 }
 
 /**

package/dist/index.d.ts

@@ -266,6 +266,19 @@ interface SetConversationTaskStatusInput {
     status: ConversationTaskStatus;
     resolvedBy?: string;
 }
+interface UpdateConversationTaskInput {
+    taskId: string;
+    /** Conversation the task belongs to. Truth requires this on PATCH. */
+    conversationId: string;
+    /** Required by the Truth task router — see `messages/procedures/tasks.ts`. */
+    author: string;
+    description: string;
+    /** Optional patch fields — pass only the ones you want to change. */
+    priority?: ConversationTaskPriority;
+    status?: ConversationTaskStatus;
+    assignee?: string;
+    type?: string;
+}
 interface SendConversationMessageInput {
     fromNumber: string;
     toNumber: string;
@@ -291,7 +304,8 @@ declare class ConversationNotesSubresource {
 }
 declare class ConversationTasksSubresource {
     private readonly post;
-    constructor(post: <T>(path: string, body: unknown) => Promise<T>);
+    private readonly patch;
+    constructor(post: <T>(path: string, body: unknown) => Promise<T>, patch: <T>(path: string, body: unknown) => Promise<T>);
     /** Create a task on a conversation. */
     create(input: CreateConversationTaskInput): Promise<{
         id: string;
@@ -300,6 +314,14 @@ declare class ConversationTasksSubresource {
     setStatus(input: SetConversationTaskStatusInput): Promise<{
         ok: true;
     }>;
+    /**
+     * Update task fields (priority, assignee, description, type). Wraps
+     * `PATCH /api/conversations/tasks/{id}` so CommHub doesn't have to
+     * direct-fetch for non-status field edits.
+     */
+    update(input: UpdateConversationTaskInput): Promise<{
+        ok: true;
+    }>;
 }
 declare class ConversationMessagesSubresource {
     private readonly post;
@@ -354,6 +376,13 @@ declare class ConversationsResource {
         cleared: number;
     }>;
     private postRequest;
+    /**
+     * PATCH variant of `postRequest`. Mirrors the timeout + API-key
+     * handling so callers like `tasks.update()` don't need to roll their
+     * own fetch. The Truth task router treats unknown methods as 405, so
+     * a dedicated PATCH path is required.
+     */
+    private patchRequest;
 }
 
 /**

package/dist/index.js

@@ -312,6 +312,15 @@ var ConversationsError = class extends Error {
     this.status = status;
   }
 };
+function assertConversationAddress(operation, input) {
+  if (!input.conversationId && !input.phonePair) {
+    throw new ConversationsError(
+      operation,
+      0,
+      "Either `conversationId` or `phonePair` is required"
+    );
+  }
+}
 var ConversationNotesSubresource = class {
   constructor(post) {
     this.post = post;
@@ -319,17 +328,20 @@ var ConversationNotesSubresource = class {
   /** Create a note on a conversation (addressed by id or phonePair). */
   create(input) {
     return __async(this, null, function* () {
+      assertConversationAddress("notes.create", input);
       return this.post("/conversations/notes", input);
     });
   }
 };
 var ConversationTasksSubresource = class {
-  constructor(post) {
+  constructor(post, patch) {
     this.post = post;
+    this.patch = patch;
   }
   /** Create a task on a conversation. */
   create(input) {
     return __async(this, null, function* () {
+      assertConversationAddress("tasks.create", input);
       return this.post("/conversations/tasks", input);
     });
   }
@@ -345,6 +357,24 @@ var ConversationTasksSubresource = class {
       );
     });
   }
+  /**
+   * Update task fields (priority, assignee, description, type). Wraps
+   * `PATCH /api/conversations/tasks/{id}` so CommHub doesn't have to
+   * direct-fetch for non-status field edits.
+   */
+  update(input) {
+    return __async(this, null, function* () {
+      return this.patch(
+        `/conversations/tasks/${encodeURIComponent(input.taskId)}`,
+        __spreadValues(__spreadValues(__spreadValues(__spreadValues({
+          id: input.taskId,
+          conversationId: input.conversationId,
+          author: input.author,
+          description: input.description
+        }, input.priority ? { priority: input.priority } : {}), input.status ? { status: input.status } : {}), input.assignee !== void 0 ? { assignee: input.assignee } : {}), input.type !== void 0 ? { type: input.type } : {})
+      );
+    });
+  }
 };
 var ConversationMessagesSubresource = class {
   constructor(post) {
@@ -379,8 +409,9 @@ var _ConversationsResource = class _ConversationsResource {
     this.apiKey = apiKey;
     this.convex = convex != null ? convex : null;
     const post = (path, body) => this.postRequest(path, body);
+    const patch = (path, body) => this.patchRequest(path, body);
     this.notes = new ConversationNotesSubresource(post);
-    this.tasks = new ConversationTasksSubresource(post);
+    this.tasks = new ConversationTasksSubresource(post, patch);
     this.messages = new ConversationMessagesSubresource(post);
   }
   /**
@@ -480,6 +511,56 @@ var _ConversationsResource = class _ConversationsResource {
       return yield res.json();
     });
   }
+  /**
+   * PATCH variant of `postRequest`. Mirrors the timeout + API-key
+   * handling so callers like `tasks.update()` don't need to roll their
+   * own fetch. The Truth task router treats unknown methods as 405, so
+   * a dedicated PATCH path is required.
+   */
+  patchRequest(path, body) {
+    return __async(this, null, function* () {
+      if (!this.apiKey) {
+        throw new ConversationsError(
+          path,
+          0,
+          "Truth API key not configured \u2014 request blocked"
+        );
+      }
+      const controller = new AbortController();
+      const timeout = setTimeout(
+        () => controller.abort(),
+        _ConversationsResource.REQUEST_TIMEOUT_MS
+      );
+      let res;
+      try {
+        res = yield fetch(`${this.baseUrl}/api${path}`, {
+          method: "PATCH",
+          headers: {
+            "Content-Type": "application/json",
+            Accept: "application/json",
+            "X-API-Key": this.apiKey
+          },
+          body: JSON.stringify(body),
+          signal: controller.signal
+        });
+      } catch (err) {
+        const isAbort = err instanceof Error && (err.name === "AbortError" || err.name === "TimeoutError");
+        const message = isAbort ? `Conversations ${path} timed out after ${_ConversationsResource.REQUEST_TIMEOUT_MS}ms` : err instanceof Error ? err.message : String(err);
+        throw new ConversationsError(path, 0, message);
+      } finally {
+        clearTimeout(timeout);
+      }
+      if (!res.ok) {
+        const text = yield res.text().catch(() => "");
+        throw new ConversationsError(
+          path,
+          res.status,
+          `Conversations ${path} failed: ${text.slice(0, 200)}`
+        );
+      }
+      return yield res.json();
+    });
+  }
 };
 /** 30s upstream timeout — matches NotesResource for consistency. */
 _ConversationsResource.REQUEST_TIMEOUT_MS = 3e4;
@@ -731,18 +812,15 @@ var MessagesResource = class {
    */
   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 })
-        }
-      );
+      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(