@zavudev/sdk 0.55.0 → 0.57.0

package/resources/conversations.d.ts

@@ -0,0 +1,360 @@
+import { APIResource } from "../core/resource.js";
+import * as MessagesAPI from "./messages.js";
+import { MessagesCursor } from "./messages.js";
+import { APIPromise } from "../core/api-promise.js";
+import { Cursor, type CursorParams, PagePromise } from "../core/pagination.js";
+import { RequestOptions } from "../internal/request-options.js";
+export declare class Conversations extends APIResource {
+    /**
+     * Get conversation
+     */
+    retrieve(conversationID: string, options?: RequestOptions): APIPromise<ConversationRetrieveResponse>;
+    /**
+     * List inbox threads, most recently active first. A conversation groups every
+     * message with one contact across channels, which is what you need to build an
+     * inbox: `GET /v1/messages` returns a flat log with no thread to hang it on.
+     *
+     * Use `senderId` to scope the list to a single number, and `channel` to keep only
+     * threads that have carried that channel.
+     */
+    list(query?: ConversationListParams | null | undefined, options?: RequestOptions): PagePromise<ConversationListResponsesCursor, ConversationListResponse>;
+    /**
+     * Messages in this thread, newest first, across every channel it has carried.
+     * Reply with `POST /v1/messages`, passing the conversation's `senderId` as the
+     * `Zavu-Sender` header so the answer leaves from the number the contact already
+     * knows.
+     */
+    listMessages(conversationID: string, query?: ConversationListMessagesParams | null | undefined, options?: RequestOptions): PagePromise<MessagesCursor, MessagesAPI.Message>;
+    /**
+     * Reset the thread's `unreadCount` to zero. Marks the thread read in your own
+     * inbox only: it does not send a read receipt to the contact.
+     */
+    markAsRead(conversationID: string, options?: RequestOptions): APIPromise<ConversationMarkAsReadResponse>;
+}
+export type ConversationListResponsesCursor = Cursor<ConversationListResponse>;
+export interface ConversationRetrieveResponse {
+    /**
+     * An inbox thread with one contact. A conversation groups every message exchanged
+     * with that contact across channels, so a contact who writes on WhatsApp and later
+     * by email stays in one thread.
+     */
+    conversation: ConversationRetrieveResponse.Conversation;
+}
+export declare namespace ConversationRetrieveResponse {
+    /**
+     * An inbox thread with one contact. A conversation groups every message exchanged
+     * with that contact across channels, so a contact who writes on WhatsApp and later
+     * by email stays in one thread.
+     */
+    interface Conversation {
+        id: string;
+        /**
+         * Every channel this thread has carried messages on.
+         */
+        channels: Array<string>;
+        /**
+         * The key this thread is filed under: a phone number in E.164, a WhatsApp
+         * business-scoped user ID (BSUID), a numeric chat ID
+         * (Telegram/Instagram/Messenger), or a group JID. It is not always a phone number,
+         * so do not parse it as one.
+         */
+        contactIdentifier: string;
+        createdAt: string;
+        /**
+         * Denormalized preview of the most recent message, so a thread list needs no extra
+         * fetch.
+         */
+        lastMessage: Conversation.LastMessage;
+        messageCount: number;
+        /**
+         * Inbound messages not yet marked read. Reset with POST
+         * /v1/conversations/{conversationId}/read.
+         */
+        unreadCount: number;
+        updatedAt: string;
+        /**
+         * ID of the contact this thread belongs to. Absent on group threads and on threads
+         * whose contact has not been resolved yet.
+         */
+        contactId?: string;
+        /**
+         * Email address of the thread, when the contact was reached by email.
+         */
+        email?: string;
+        /**
+         * Present when the thread is a group chat rather than a one-to-one conversation.
+         */
+        group?: Conversation.Group;
+        /**
+         * Sender that last handled this thread. Use it as the `Zavu-Sender` header when
+         * replying so the answer leaves from the same number the contact knows.
+         */
+        senderId?: string;
+        /**
+         * WhatsApp identity, present when the contact adopted a username.
+         */
+        whatsapp?: Conversation.Whatsapp;
+    }
+    namespace Conversation {
+        /**
+         * Denormalized preview of the most recent message, so a thread list needs no extra
+         * fetch.
+         */
+        interface LastMessage {
+            id: string;
+            at: string;
+            /**
+             * Delivery channel. Use 'auto' for intelligent routing.
+             */
+            channel: MessagesAPI.Channel;
+            direction: 'inbound' | 'outbound';
+            /**
+             * Text or caption. Empty when the last message carried no text (e.g. media).
+             */
+            text: string;
+        }
+        /**
+         * Present when the thread is a group chat rather than a one-to-one conversation.
+         */
+        interface Group {
+            id: string;
+            participantCount?: number;
+            subject?: string;
+        }
+        /**
+         * WhatsApp identity, present when the contact adopted a username.
+         */
+        interface Whatsapp {
+            /**
+             * Business-scoped user ID. Can be used as `to` when sending.
+             */
+            bsuid?: string;
+            username?: string;
+        }
+    }
+}
+/**
+ * An inbox thread with one contact. A conversation groups every message exchanged
+ * with that contact across channels, so a contact who writes on WhatsApp and later
+ * by email stays in one thread.
+ */
+export interface ConversationListResponse {
+    id: string;
+    /**
+     * Every channel this thread has carried messages on.
+     */
+    channels: Array<string>;
+    /**
+     * The key this thread is filed under: a phone number in E.164, a WhatsApp
+     * business-scoped user ID (BSUID), a numeric chat ID
+     * (Telegram/Instagram/Messenger), or a group JID. It is not always a phone number,
+     * so do not parse it as one.
+     */
+    contactIdentifier: string;
+    createdAt: string;
+    /**
+     * Denormalized preview of the most recent message, so a thread list needs no extra
+     * fetch.
+     */
+    lastMessage: ConversationListResponse.LastMessage;
+    messageCount: number;
+    /**
+     * Inbound messages not yet marked read. Reset with POST
+     * /v1/conversations/{conversationId}/read.
+     */
+    unreadCount: number;
+    updatedAt: string;
+    /**
+     * ID of the contact this thread belongs to. Absent on group threads and on threads
+     * whose contact has not been resolved yet.
+     */
+    contactId?: string;
+    /**
+     * Email address of the thread, when the contact was reached by email.
+     */
+    email?: string;
+    /**
+     * Present when the thread is a group chat rather than a one-to-one conversation.
+     */
+    group?: ConversationListResponse.Group;
+    /**
+     * Sender that last handled this thread. Use it as the `Zavu-Sender` header when
+     * replying so the answer leaves from the same number the contact knows.
+     */
+    senderId?: string;
+    /**
+     * WhatsApp identity, present when the contact adopted a username.
+     */
+    whatsapp?: ConversationListResponse.Whatsapp;
+}
+export declare namespace ConversationListResponse {
+    /**
+     * Denormalized preview of the most recent message, so a thread list needs no extra
+     * fetch.
+     */
+    interface LastMessage {
+        id: string;
+        at: string;
+        /**
+         * Delivery channel. Use 'auto' for intelligent routing.
+         */
+        channel: MessagesAPI.Channel;
+        direction: 'inbound' | 'outbound';
+        /**
+         * Text or caption. Empty when the last message carried no text (e.g. media).
+         */
+        text: string;
+    }
+    /**
+     * Present when the thread is a group chat rather than a one-to-one conversation.
+     */
+    interface Group {
+        id: string;
+        participantCount?: number;
+        subject?: string;
+    }
+    /**
+     * WhatsApp identity, present when the contact adopted a username.
+     */
+    interface Whatsapp {
+        /**
+         * Business-scoped user ID. Can be used as `to` when sending.
+         */
+        bsuid?: string;
+        username?: string;
+    }
+}
+export interface ConversationMarkAsReadResponse {
+    /**
+     * An inbox thread with one contact. A conversation groups every message exchanged
+     * with that contact across channels, so a contact who writes on WhatsApp and later
+     * by email stays in one thread.
+     */
+    conversation: ConversationMarkAsReadResponse.Conversation;
+}
+export declare namespace ConversationMarkAsReadResponse {
+    /**
+     * An inbox thread with one contact. A conversation groups every message exchanged
+     * with that contact across channels, so a contact who writes on WhatsApp and later
+     * by email stays in one thread.
+     */
+    interface Conversation {
+        id: string;
+        /**
+         * Every channel this thread has carried messages on.
+         */
+        channels: Array<string>;
+        /**
+         * The key this thread is filed under: a phone number in E.164, a WhatsApp
+         * business-scoped user ID (BSUID), a numeric chat ID
+         * (Telegram/Instagram/Messenger), or a group JID. It is not always a phone number,
+         * so do not parse it as one.
+         */
+        contactIdentifier: string;
+        createdAt: string;
+        /**
+         * Denormalized preview of the most recent message, so a thread list needs no extra
+         * fetch.
+         */
+        lastMessage: Conversation.LastMessage;
+        messageCount: number;
+        /**
+         * Inbound messages not yet marked read. Reset with POST
+         * /v1/conversations/{conversationId}/read.
+         */
+        unreadCount: number;
+        updatedAt: string;
+        /**
+         * ID of the contact this thread belongs to. Absent on group threads and on threads
+         * whose contact has not been resolved yet.
+         */
+        contactId?: string;
+        /**
+         * Email address of the thread, when the contact was reached by email.
+         */
+        email?: string;
+        /**
+         * Present when the thread is a group chat rather than a one-to-one conversation.
+         */
+        group?: Conversation.Group;
+        /**
+         * Sender that last handled this thread. Use it as the `Zavu-Sender` header when
+         * replying so the answer leaves from the same number the contact knows.
+         */
+        senderId?: string;
+        /**
+         * WhatsApp identity, present when the contact adopted a username.
+         */
+        whatsapp?: Conversation.Whatsapp;
+    }
+    namespace Conversation {
+        /**
+         * Denormalized preview of the most recent message, so a thread list needs no extra
+         * fetch.
+         */
+        interface LastMessage {
+            id: string;
+            at: string;
+            /**
+             * Delivery channel. Use 'auto' for intelligent routing.
+             */
+            channel: MessagesAPI.Channel;
+            direction: 'inbound' | 'outbound';
+            /**
+             * Text or caption. Empty when the last message carried no text (e.g. media).
+             */
+            text: string;
+        }
+        /**
+         * Present when the thread is a group chat rather than a one-to-one conversation.
+         */
+        interface Group {
+            id: string;
+            participantCount?: number;
+            subject?: string;
+        }
+        /**
+         * WhatsApp identity, present when the contact adopted a username.
+         */
+        interface Whatsapp {
+            /**
+             * Business-scoped user ID. Can be used as `to` when sending.
+             */
+            bsuid?: string;
+            username?: string;
+        }
+    }
+}
+export interface ConversationListParams extends CursorParams {
+    /**
+     * Keep only threads that have carried this channel.
+     */
+    channel?: 'sms' | 'sms_oneway' | 'whatsapp' | 'email' | 'telegram' | 'instagram' | 'messenger' | 'voice';
+    /**
+     * Search threads by identity: phone number (any format — `+1 (555) 123-4567` and
+     * `15551234567` both match), email address (full or local part), WhatsApp group
+     * subject, WhatsApp username, or BSUID. Matching is by whole word, with prefix
+     * matching on the last term, so `mar` finds `maria@example.com` and `+1555` finds
+     * `+15551234567`; a fragment from the middle or end of a number (`4567`) does not
+     * match.
+     *
+     * It does **not** search message bodies — only who the thread is with.
+     *
+     * Results come back ranked by relevance rather than by recency, so the usual "most
+     * recently active first" ordering does not apply while `q` is set. `senderId` and
+     * `channel` still narrow the results, and `cursor` paginates them as usual. An
+     * empty or whitespace-only `q` returns no items rather than the full list.
+     */
+    search?: string;
+    /**
+     * Keep only threads last handled by this sender.
+     */
+    senderId?: string;
+}
+export interface ConversationListMessagesParams extends CursorParams {
+}
+export declare namespace Conversations {
+    export { type ConversationRetrieveResponse as ConversationRetrieveResponse, type ConversationListResponse as ConversationListResponse, type ConversationMarkAsReadResponse as ConversationMarkAsReadResponse, type ConversationListResponsesCursor as ConversationListResponsesCursor, type ConversationListParams as ConversationListParams, type ConversationListMessagesParams as ConversationListMessagesParams, };
+}
+export { type MessagesCursor };
+//# sourceMappingURL=conversations.d.ts.map

package/resources/conversations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversations.d.ts","sourceRoot":"","sources":["../src/resources/conversations.ts"],"names":[],"mappings":"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"}

package/resources/conversations.js

@@ -0,0 +1,47 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Conversations = void 0;
+const resource_1 = require("../core/resource.js");
+const pagination_1 = require("../core/pagination.js");
+const path_1 = require("../internal/utils/path.js");
+class Conversations extends resource_1.APIResource {
+    /**
+     * Get conversation
+     */
+    retrieve(conversationID, options) {
+        return this._client.get((0, path_1.path) `/v1/conversations/${conversationID}`, options);
+    }
+    /**
+     * List inbox threads, most recently active first. A conversation groups every
+     * message with one contact across channels, which is what you need to build an
+     * inbox: `GET /v1/messages` returns a flat log with no thread to hang it on.
+     *
+     * Use `senderId` to scope the list to a single number, and `channel` to keep only
+     * threads that have carried that channel.
+     */
+    list(query = {}, options) {
+        return this._client.getAPIList('/v1/conversations', (pagination_1.Cursor), {
+            query,
+            ...options,
+        });
+    }
+    /**
+     * Messages in this thread, newest first, across every channel it has carried.
+     * Reply with `POST /v1/messages`, passing the conversation's `senderId` as the
+     * `Zavu-Sender` header so the answer leaves from the number the contact already
+     * knows.
+     */
+    listMessages(conversationID, query = {}, options) {
+        return this._client.getAPIList((0, path_1.path) `/v1/conversations/${conversationID}/messages`, (pagination_1.Cursor), { query, ...options });
+    }
+    /**
+     * Reset the thread's `unreadCount` to zero. Marks the thread read in your own
+     * inbox only: it does not send a read receipt to the contact.
+     */
+    markAsRead(conversationID, options) {
+        return this._client.post((0, path_1.path) `/v1/conversations/${conversationID}/read`, options);
+    }
+}
+exports.Conversations = Conversations;
+//# sourceMappingURL=conversations.js.map

package/resources/conversations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversations.js","sourceRoot":"","sources":["../src/resources/conversations.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAI/C,sDAA4E;AAE5E,oDAA8C;AAE9C,MAAa,aAAc,SAAQ,sBAAW;IAC5C;;OAEG;IACH,QAAQ,CAAC,cAAsB,EAAE,OAAwB;QACvD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,qBAAqB,cAAc,EAAE,EAAE,OAAO,CAAC,CAAC;IAC9E,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,CACF,QAAmD,EAAE,EACrD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAA,mBAAgC,CAAA,EAAE;YACpF,KAAK;YACL,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,YAAY,CACV,cAAsB,EACtB,QAA2D,EAAE,EAC7D,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAC5B,IAAA,WAAI,EAAA,qBAAqB,cAAc,WAAW,EAClD,CAAA,mBAA2B,CAAA,EAC3B,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CACtB,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,UAAU,CAAC,cAAsB,EAAE,OAAwB;QACzD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,qBAAqB,cAAc,OAAO,EAAE,OAAO,CAAC,CAAC;IACpF,CAAC;CACF;AAnDD,sCAmDC"}

package/resources/conversations.mjs

@@ -0,0 +1,43 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../core/resource.mjs";
+import { Cursor } from "../core/pagination.mjs";
+import { path } from "../internal/utils/path.mjs";
+export class Conversations extends APIResource {
+    /**
+     * Get conversation
+     */
+    retrieve(conversationID, options) {
+        return this._client.get(path `/v1/conversations/${conversationID}`, options);
+    }
+    /**
+     * List inbox threads, most recently active first. A conversation groups every
+     * message with one contact across channels, which is what you need to build an
+     * inbox: `GET /v1/messages` returns a flat log with no thread to hang it on.
+     *
+     * Use `senderId` to scope the list to a single number, and `channel` to keep only
+     * threads that have carried that channel.
+     */
+    list(query = {}, options) {
+        return this._client.getAPIList('/v1/conversations', (Cursor), {
+            query,
+            ...options,
+        });
+    }
+    /**
+     * Messages in this thread, newest first, across every channel it has carried.
+     * Reply with `POST /v1/messages`, passing the conversation's `senderId` as the
+     * `Zavu-Sender` header so the answer leaves from the number the contact already
+     * knows.
+     */
+    listMessages(conversationID, query = {}, options) {
+        return this._client.getAPIList(path `/v1/conversations/${conversationID}/messages`, (Cursor), { query, ...options });
+    }
+    /**
+     * Reset the thread's `unreadCount` to zero. Marks the thread read in your own
+     * inbox only: it does not send a read receipt to the contact.
+     */
+    markAsRead(conversationID, options) {
+        return this._client.post(path `/v1/conversations/${conversationID}/read`, options);
+    }
+}
+//# sourceMappingURL=conversations.mjs.map

package/resources/conversations.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversations.mjs","sourceRoot":"","sources":["../src/resources/conversations.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAI/C,OAAO,EAAE,MAAM,EAAkC,+BAA2B;AAE5E,OAAO,EAAE,IAAI,EAAE,mCAA+B;AAE9C,MAAM,OAAO,aAAc,SAAQ,WAAW;IAC5C;;OAEG;IACH,QAAQ,CAAC,cAAsB,EAAE,OAAwB;QACvD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,qBAAqB,cAAc,EAAE,EAAE,OAAO,CAAC,CAAC;IAC9E,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,CACF,QAAmD,EAAE,EACrD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAA,MAAgC,CAAA,EAAE;YACpF,KAAK;YACL,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,YAAY,CACV,cAAsB,EACtB,QAA2D,EAAE,EAC7D,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAC5B,IAAI,CAAA,qBAAqB,cAAc,WAAW,EAClD,CAAA,MAA2B,CAAA,EAC3B,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CACtB,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,UAAU,CAAC,cAAsB,EAAE,OAAwB;QACzD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,qBAAqB,cAAc,OAAO,EAAE,OAAO,CAAC,CAAC;IACpF,CAAC;CACF"}