@doist/comms-sdk 0.9.0 → 0.11.0

package/dist/cjs/clients/conversations-client.js

@@ -31,26 +31,55 @@ class ConversationsClient extends base_client_1.BaseClient {
             : exports.ConversationListSchema;
     }
     /**
-     * Gets all conversations for a workspace.
+     * Gets a page of conversations for a workspace, newest activity first.
+     * The server returns at most 500 rows per request (20 by default); pass
+     * the last row's `lastActive`/`id` as `olderThan`/`beforeId` to fetch
+     * the next page. Paired, they form a strict compound boundary, so pages
+     * never repeat rows. Omitting `archived` returns active and archived
+     * conversations mixed.
      *
      * @param args - The arguments for getting conversations.
      * @param args.workspaceId - The workspace ID.
-     * @param args.archived - Optional flag to include archived conversations.
+     * @param args.archived - Optional flag to filter archived (true) or active (false) conversations.
+     * @param args.olderThan - Optional date to get conversations last active before.
+     * @param args.beforeId - Optional conversation id. Paired with olderThan it forms the
+     *   strict compound cursor; alone it pages by conversation id order instead.
+     * @param args.limit - Optional page size (server default 20, max 500).
      * @returns An array of conversation objects.
      *
      * @example
      * ```typescript
-     * const conversations = await api.conversations.getConversations({ workspaceId: 123 })
-     * conversations.forEach(c => console.log(c.title))
+     * const page = await api.conversations.getConversations({ workspaceId: 123, limit: 500 })
+     * const last = page.at(-1)
+     * const nextPage = last
+     *     ? await api.conversations.getConversations({
+     *           workspaceId: 123,
+     *           limit: 500,
+     *           olderThan: last.lastActive,
+     *           beforeId: last.id,
+     *       })
+     *     : []
      * ```
      */
     getConversations(args) {
+        // Fields are picked explicitly (matching getThreads/getComments) so a
+        // future Date field can't silently reach the generic snake-casing,
+        // which would turn it into an empty object on the wire.
+        const params = { workspaceId: args.workspaceId };
+        if (args.archived != null)
+            params.archived = args.archived;
+        if (args.olderThan)
+            params.olderThanTs = Math.floor(args.olderThan.getTime() / 1000);
+        if (args.beforeId != null)
+            params.beforeId = args.beforeId;
+        if (args.limit != null)
+            params.limit = args.limit;
         return (0, http_client_1.request)({
             httpMethod: 'GET',
             baseUri: this.getBaseUri(),
             relativePath: `${endpoints_1.ENDPOINT_CONVERSATIONS}/get`,
             apiToken: this.apiToken,
-            payload: args,
+            payload: params,
             customFetch: this.customFetch,
         }).then((response) => this.conversationListSchema.parse(response.data));
     }

package/dist/cjs/types/entities.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SearchResultSchema = exports.SEARCH_RESULT_TYPES = exports.UnreadConversationSchema = exports.UnreadThreadSchema = exports.InboxThreadSchema = exports.ConversationMessageSchema = exports.ConversationMessageObjectSchema = exports.WorkspaceUserSchema = exports.CommentSchema = exports.CommentObjectSchema = exports.ConversationSchema = exports.ConversationObjectSchema = exports.GroupSchema = exports.ThreadSchema = exports.ThreadObjectSchema = exports.ChannelSchema = exports.ChannelObjectSchema = exports.WorkspaceSchema = exports.UserSchema = exports.BaseUserSchema = exports.RequestAttachmentSchema = exports.AttachmentSchema = exports.HookSubscribeResponseSchema = exports.StatusOkSchema = exports.SystemMessageSchema = void 0;
+exports.SearchResultSchema = exports.ConversationSearchResultSchema = exports.ThreadSearchResultSchema = exports.SEARCH_RESULT_TYPES = exports.UnreadConversationSchema = exports.UnreadThreadSchema = exports.InboxThreadSchema = exports.ConversationMessageSchema = exports.ConversationMessageObjectSchema = exports.WorkspaceUserSchema = exports.CommentSchema = exports.CommentObjectSchema = exports.ConversationSchema = exports.ConversationObjectSchema = exports.GroupSchema = exports.ThreadSchema = exports.ThreadObjectSchema = exports.ChannelSchema = exports.ChannelObjectSchema = exports.WorkspaceSchema = exports.UserSchema = exports.BaseUserSchema = exports.RequestAttachmentSchema = exports.AttachmentSchema = exports.HookSubscribeResponseSchema = exports.StatusOkSchema = exports.SystemMessageSchema = void 0;
 exports.createChannelSchema = createChannelSchema;
 exports.createThreadSchema = createThreadSchema;
 exports.createConversationSchema = createConversationSchema;
@@ -420,32 +420,43 @@ exports.UnreadConversationSchema = zod_1.z.object({
     directMention: zod_1.z.boolean(),
 });
 // SearchResult entity from API.
-// The API currently only emits 'thread' and 'conversation' results: a match inside a
+// The API emits 'thread' and 'conversation' results: a match inside a
 // comment is returned as a 'thread' result with `commentId` set, and a match inside a
 // message as a 'conversation' result with `messageId` set.
-exports.SEARCH_RESULT_TYPES = ['thread', 'comment', 'message', 'conversation'];
-exports.SearchResultSchema = zod_1.z.object({
+const searchResultBaseShape = {
     /**
      * Opaque search-result key in the form `thread_<threadId>` or
      * `conversation_<conversationId>`. Unique per result; not a Comms object id — use
      * `threadId`, `conversationId`, `commentId`, or `messageId` to reference objects.
      */
     id: zod_1.z.string(),
-    type: zod_1.z.enum(exports.SEARCH_RESULT_TYPES),
     snippet: zod_1.z.string(),
     snippetCreatorId: zod_1.z.number(),
     snippetLastUpdated: zod_1.z.date(),
-    /** The owning thread id. Set by the API on 'thread' results. */
-    threadId: zod_1.z.string().nullable().optional(),
-    /** The owning conversation id. Set by the API on 'conversation' results. */
-    conversationId: zod_1.z.string().nullable().optional(),
-    /** The matched comment id, set on 'thread' results when the match is a comment. */
-    commentId: zod_1.z.string().nullable().optional(),
-    /** The matched message id, set by the API on 'conversation' results. */
-    messageId: zod_1.z.union([zod_1.z.string(), zod_1.z.number()]).transform(String).nullable().optional(),
     channelId: zod_1.z.string().nullable().optional(),
     channelName: zod_1.z.string().nullable().optional(),
     channelColor: zod_1.z.number().nullable().optional(),
     title: zod_1.z.string().nullable().optional(),
     closed: zod_1.z.boolean().nullable().optional(),
+};
+exports.SEARCH_RESULT_TYPES = ['thread', 'conversation'];
+exports.ThreadSearchResultSchema = zod_1.z.object({
+    ...searchResultBaseShape,
+    type: zod_1.z.literal('thread'),
+    /** The owning thread id. */
+    threadId: zod_1.z.string(),
+    /** The matched comment id, set when the match is a comment. */
+    commentId: zod_1.z.string().nullable().optional(),
+});
+exports.ConversationSearchResultSchema = zod_1.z.object({
+    ...searchResultBaseShape,
+    type: zod_1.z.literal('conversation'),
+    /** The owning conversation id. */
+    conversationId: zod_1.z.string(),
+    /** The matched message id. */
+    messageId: zod_1.z.union([zod_1.z.string(), zod_1.z.number()]).transform(String).nullable().optional(),
 });
+exports.SearchResultSchema = zod_1.z.discriminatedUnion('type', [
+    exports.ThreadSearchResultSchema,
+    exports.ConversationSearchResultSchema,
+]);

package/dist/cjs/types/requests.js

@@ -106,6 +106,9 @@ exports.GetCommentsArgsSchema = zod_1.z.object({
 exports.GetConversationsArgsSchema = zod_1.z.object({
     workspaceId: zod_1.z.number(),
     archived: zod_1.z.boolean().nullable().optional(),
+    olderThan: zod_1.z.date().nullable().optional(),
+    beforeId: zod_1.z.string().nullable().optional(),
+    limit: zod_1.z.number().nullable().optional(),
 });
 exports.GetOrCreateConversationArgsSchema = zod_1.z.object({
     workspaceId: zod_1.z.number(),

package/dist/esm/clients/conversations-client.js

@@ -28,26 +28,55 @@ export class ConversationsClient extends BaseClient {
             : ConversationListSchema;
     }
     /**
-     * Gets all conversations for a workspace.
+     * Gets a page of conversations for a workspace, newest activity first.
+     * The server returns at most 500 rows per request (20 by default); pass
+     * the last row's `lastActive`/`id` as `olderThan`/`beforeId` to fetch
+     * the next page. Paired, they form a strict compound boundary, so pages
+     * never repeat rows. Omitting `archived` returns active and archived
+     * conversations mixed.
      *
      * @param args - The arguments for getting conversations.
      * @param args.workspaceId - The workspace ID.
-     * @param args.archived - Optional flag to include archived conversations.
+     * @param args.archived - Optional flag to filter archived (true) or active (false) conversations.
+     * @param args.olderThan - Optional date to get conversations last active before.
+     * @param args.beforeId - Optional conversation id. Paired with olderThan it forms the
+     *   strict compound cursor; alone it pages by conversation id order instead.
+     * @param args.limit - Optional page size (server default 20, max 500).
      * @returns An array of conversation objects.
      *
      * @example
      * ```typescript
-     * const conversations = await api.conversations.getConversations({ workspaceId: 123 })
-     * conversations.forEach(c => console.log(c.title))
+     * const page = await api.conversations.getConversations({ workspaceId: 123, limit: 500 })
+     * const last = page.at(-1)
+     * const nextPage = last
+     *     ? await api.conversations.getConversations({
+     *           workspaceId: 123,
+     *           limit: 500,
+     *           olderThan: last.lastActive,
+     *           beforeId: last.id,
+     *       })
+     *     : []
      * ```
      */
     getConversations(args) {
+        // Fields are picked explicitly (matching getThreads/getComments) so a
+        // future Date field can't silently reach the generic snake-casing,
+        // which would turn it into an empty object on the wire.
+        const params = { workspaceId: args.workspaceId };
+        if (args.archived != null)
+            params.archived = args.archived;
+        if (args.olderThan)
+            params.olderThanTs = Math.floor(args.olderThan.getTime() / 1000);
+        if (args.beforeId != null)
+            params.beforeId = args.beforeId;
+        if (args.limit != null)
+            params.limit = args.limit;
         return request({
             httpMethod: 'GET',
             baseUri: this.getBaseUri(),
             relativePath: `${ENDPOINT_CONVERSATIONS}/get`,
             apiToken: this.apiToken,
-            payload: args,
+            payload: params,
             customFetch: this.customFetch,
         }).then((response) => this.conversationListSchema.parse(response.data));
     }

package/dist/esm/types/entities.js

@@ -410,32 +410,43 @@ export const UnreadConversationSchema = z.object({
     directMention: z.boolean(),
 });
 // SearchResult entity from API.
-// The API currently only emits 'thread' and 'conversation' results: a match inside a
+// The API emits 'thread' and 'conversation' results: a match inside a
 // comment is returned as a 'thread' result with `commentId` set, and a match inside a
 // message as a 'conversation' result with `messageId` set.
-export const SEARCH_RESULT_TYPES = ['thread', 'comment', 'message', 'conversation'];
-export const SearchResultSchema = z.object({
+const searchResultBaseShape = {
     /**
      * Opaque search-result key in the form `thread_<threadId>` or
      * `conversation_<conversationId>`. Unique per result; not a Comms object id — use
      * `threadId`, `conversationId`, `commentId`, or `messageId` to reference objects.
      */
     id: z.string(),
-    type: z.enum(SEARCH_RESULT_TYPES),
     snippet: z.string(),
     snippetCreatorId: z.number(),
     snippetLastUpdated: z.date(),
-    /** The owning thread id. Set by the API on 'thread' results. */
-    threadId: z.string().nullable().optional(),
-    /** The owning conversation id. Set by the API on 'conversation' results. */
-    conversationId: z.string().nullable().optional(),
-    /** The matched comment id, set on 'thread' results when the match is a comment. */
-    commentId: z.string().nullable().optional(),
-    /** The matched message id, set by the API on 'conversation' results. */
-    messageId: z.union([z.string(), z.number()]).transform(String).nullable().optional(),
     channelId: z.string().nullable().optional(),
     channelName: z.string().nullable().optional(),
     channelColor: z.number().nullable().optional(),
     title: z.string().nullable().optional(),
     closed: z.boolean().nullable().optional(),
+};
+export const SEARCH_RESULT_TYPES = ['thread', 'conversation'];
+export const ThreadSearchResultSchema = z.object({
+    ...searchResultBaseShape,
+    type: z.literal('thread'),
+    /** The owning thread id. */
+    threadId: z.string(),
+    /** The matched comment id, set when the match is a comment. */
+    commentId: z.string().nullable().optional(),
+});
+export const ConversationSearchResultSchema = z.object({
+    ...searchResultBaseShape,
+    type: z.literal('conversation'),
+    /** The owning conversation id. */
+    conversationId: z.string(),
+    /** The matched message id. */
+    messageId: z.union([z.string(), z.number()]).transform(String).nullable().optional(),
 });
+export const SearchResultSchema = z.discriminatedUnion('type', [
+    ThreadSearchResultSchema,
+    ConversationSearchResultSchema,
+]);

package/dist/esm/types/requests.js

@@ -103,6 +103,9 @@ export const GetCommentsArgsSchema = z.object({
 export const GetConversationsArgsSchema = z.object({
     workspaceId: z.number(),
     archived: z.boolean().nullable().optional(),
+    olderThan: z.date().nullable().optional(),
+    beforeId: z.string().nullable().optional(),
+    limit: z.number().nullable().optional(),
 });
 export const GetOrCreateConversationArgsSchema = z.object({
     workspaceId: z.number(),

package/dist/types/clients/conversations-client.d.ts

@@ -167,17 +167,34 @@ export declare class ConversationsClient extends BaseClient {
     private readonly conversationSchema;
     private readonly conversationListSchema;
     /**
-     * Gets all conversations for a workspace.
+     * Gets a page of conversations for a workspace, newest activity first.
+     * The server returns at most 500 rows per request (20 by default); pass
+     * the last row's `lastActive`/`id` as `olderThan`/`beforeId` to fetch
+     * the next page. Paired, they form a strict compound boundary, so pages
+     * never repeat rows. Omitting `archived` returns active and archived
+     * conversations mixed.
      *
      * @param args - The arguments for getting conversations.
      * @param args.workspaceId - The workspace ID.
-     * @param args.archived - Optional flag to include archived conversations.
+     * @param args.archived - Optional flag to filter archived (true) or active (false) conversations.
+     * @param args.olderThan - Optional date to get conversations last active before.
+     * @param args.beforeId - Optional conversation id. Paired with olderThan it forms the
+     *   strict compound cursor; alone it pages by conversation id order instead.
+     * @param args.limit - Optional page size (server default 20, max 500).
      * @returns An array of conversation objects.
      *
      * @example
      * ```typescript
-     * const conversations = await api.conversations.getConversations({ workspaceId: 123 })
-     * conversations.forEach(c => console.log(c.title))
+     * const page = await api.conversations.getConversations({ workspaceId: 123, limit: 500 })
+     * const last = page.at(-1)
+     * const nextPage = last
+     *     ? await api.conversations.getConversations({
+     *           workspaceId: 123,
+     *           limit: 500,
+     *           olderThan: last.lastActive,
+     *           beforeId: last.id,
+     *       })
+     *     : []
      * ```
      */
     getConversations(args: GetConversationsArgs): Promise<Conversation[]>;

package/dist/types/types/entities.d.ts

@@ -2802,29 +2802,65 @@ export declare const UnreadConversationSchema: z.ZodObject<{
     directMention: z.ZodBoolean;
 }, z.core.$strip>;
 export type UnreadConversation = z.infer<typeof UnreadConversationSchema>;
-export declare const SEARCH_RESULT_TYPES: readonly ["thread", "comment", "message", "conversation"];
+export declare const SEARCH_RESULT_TYPES: readonly ["thread", "conversation"];
 export type SearchResultType = (typeof SEARCH_RESULT_TYPES)[number];
-export declare const SearchResultSchema: z.ZodObject<{
+export declare const ThreadSearchResultSchema: z.ZodObject<{
+    type: z.ZodLiteral<"thread">;
+    threadId: z.ZodString;
+    commentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     id: z.ZodString;
-    type: z.ZodEnum<{
-        thread: "thread";
-        message: "message";
-        comment: "comment";
-        conversation: "conversation";
-    }>;
     snippet: z.ZodString;
     snippetCreatorId: z.ZodNumber;
     snippetLastUpdated: z.ZodDate;
-    threadId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    conversationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    commentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    channelId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    channelName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    channelColor: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    closed: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+}, z.core.$strip>;
+export type ThreadSearchResult = z.infer<typeof ThreadSearchResultSchema>;
+export declare const ConversationSearchResultSchema: z.ZodObject<{
+    type: z.ZodLiteral<"conversation">;
+    conversationId: z.ZodString;
     messageId: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>>>;
+    id: z.ZodString;
+    snippet: z.ZodString;
+    snippetCreatorId: z.ZodNumber;
+    snippetLastUpdated: z.ZodDate;
     channelId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     channelName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     channelColor: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     closed: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
 }, z.core.$strip>;
+export type ConversationSearchResult = z.infer<typeof ConversationSearchResultSchema>;
+export declare const SearchResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"thread">;
+    threadId: z.ZodString;
+    commentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    id: z.ZodString;
+    snippet: z.ZodString;
+    snippetCreatorId: z.ZodNumber;
+    snippetLastUpdated: z.ZodDate;
+    channelId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    channelName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    channelColor: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    closed: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"conversation">;
+    conversationId: z.ZodString;
+    messageId: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>>>;
+    id: z.ZodString;
+    snippet: z.ZodString;
+    snippetCreatorId: z.ZodNumber;
+    snippetLastUpdated: z.ZodDate;
+    channelId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    channelName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    channelColor: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    closed: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+}, z.core.$strip>], "type">;
 export type SearchResult = z.infer<typeof SearchResultSchema>;
 export type SearchResponse = {
     items: SearchResult[];

package/dist/types/types/requests.d.ts

@@ -164,6 +164,9 @@ export type GetCommentsArgs = z.infer<typeof GetCommentsArgsSchema>;
 export declare const GetConversationsArgsSchema: z.ZodObject<{
     workspaceId: z.ZodNumber;
     archived: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    olderThan: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
+    beforeId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    limit: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
 }, z.core.$strip>;
 export type GetConversationsArgs = z.infer<typeof GetConversationsArgsSchema>;
 export declare const GetOrCreateConversationArgsSchema: z.ZodObject<{

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@doist/comms-sdk",
-    "version": "0.9.0",
+    "version": "0.11.0",
     "description": "A TypeScript wrapper for the Comms REST API.",
     "author": "Doist developers",
     "homepage": "https://doist.github.io/comms-sdk-typescript/",