@doist/comms-sdk 0.1.0-alpha.1

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

@@ -0,0 +1,157 @@
+import { z } from 'zod';
+import { type Comment, type StatusOk } from '../types/entities.js';
+import type { CreateCommentArgs, GetCommentsArgs, MarkCommentPositionArgs, UpdateCommentArgs } from '../types/requests.js';
+import { BaseClient } from './base-client.js';
+export declare const CommentListSchema: z.ZodArray<z.ZodPipe<z.ZodObject<{
+    id: z.ZodString;
+    content: z.ZodString;
+    creator: z.ZodNumber;
+    threadId: z.ZodString;
+    workspaceId: z.ZodNumber;
+    conversationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    posted: z.ZodDate;
+    lastEdited: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
+    directMentions: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodNumber>>>;
+    directGroupMentions: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    systemMessage: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodUnknown]>>>;
+    attachments: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        attachmentId: z.ZodString;
+        urlType: z.ZodString;
+        title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        fileName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        fileSize: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        underlyingType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        image: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        imageWidth: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        imageHeight: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        duration: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        uploadState: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        video: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        videoType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        videoAutoPlay: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    }, z.core.$loose>>>>;
+    reactions: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    objIndex: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    creatorName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    channelId: z.ZodString;
+    recipients: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodNumber>>>;
+    groups: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    toEmails: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    deleted: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    deletedBy: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    version: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    actions: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodUnknown>>>;
+}, z.core.$strip>, z.ZodTransform<{
+    url: string;
+    id: string;
+    content: string;
+    creator: number;
+    threadId: string;
+    workspaceId: number;
+    posted: Date;
+    channelId: string;
+    conversationId?: string | null | undefined;
+    lastEdited?: Date | null | undefined;
+    directMentions?: number[] | null | undefined;
+    directGroupMentions?: string[] | null | undefined;
+    systemMessage?: unknown;
+    attachments?: {
+        [x: string]: unknown;
+        attachmentId: string;
+        urlType: string;
+        title?: string | null | undefined;
+        url?: string | null | undefined;
+        fileName?: string | null | undefined;
+        fileSize?: number | null | undefined;
+        underlyingType?: string | null | undefined;
+        description?: string | null | undefined;
+        image?: string | null | undefined;
+        imageWidth?: number | null | undefined;
+        imageHeight?: number | null | undefined;
+        duration?: string | null | undefined;
+        uploadState?: string | null | undefined;
+        video?: string | null | undefined;
+        videoType?: string | null | undefined;
+        videoAutoPlay?: boolean | null | undefined;
+    }[] | null | undefined;
+    reactions?: Record<string, unknown> | null | undefined;
+    objIndex?: number | null | undefined;
+    creatorName?: string | null | undefined;
+    recipients?: number[] | null | undefined;
+    groups?: string[] | null | undefined;
+    toEmails?: string[] | null | undefined;
+    deleted?: boolean | null | undefined;
+    deletedBy?: number | null | undefined;
+    version?: number | null | undefined;
+    actions?: unknown[] | null | undefined;
+}, {
+    id: string;
+    content: string;
+    creator: number;
+    threadId: string;
+    workspaceId: number;
+    posted: Date;
+    channelId: string;
+    conversationId?: string | null | undefined;
+    lastEdited?: Date | null | undefined;
+    directMentions?: number[] | null | undefined;
+    directGroupMentions?: string[] | null | undefined;
+    systemMessage?: unknown;
+    attachments?: {
+        [x: string]: unknown;
+        attachmentId: string;
+        urlType: string;
+        title?: string | null | undefined;
+        url?: string | null | undefined;
+        fileName?: string | null | undefined;
+        fileSize?: number | null | undefined;
+        underlyingType?: string | null | undefined;
+        description?: string | null | undefined;
+        image?: string | null | undefined;
+        imageWidth?: number | null | undefined;
+        imageHeight?: number | null | undefined;
+        duration?: string | null | undefined;
+        uploadState?: string | null | undefined;
+        video?: string | null | undefined;
+        videoType?: string | null | undefined;
+        videoAutoPlay?: boolean | null | undefined;
+    }[] | null | undefined;
+    reactions?: Record<string, unknown> | null | undefined;
+    objIndex?: number | null | undefined;
+    creatorName?: string | null | undefined;
+    recipients?: number[] | null | undefined;
+    groups?: string[] | null | undefined;
+    toEmails?: string[] | null | undefined;
+    deleted?: boolean | null | undefined;
+    deletedBy?: number | null | undefined;
+    version?: number | null | undefined;
+    actions?: unknown[] | null | undefined;
+}>>>;
+/**
+ * Client for `/api/v1/comments/`. The SDK auto-generates the comment `id`
+ * on `createComment` when the caller doesn't supply one.
+ */
+export declare class CommentsClient extends BaseClient {
+    /**
+     * Lists comments in a thread. `newerThan` / `olderThan` (`Date`) are
+     * converted to `newer_than_ts` / `older_than_ts` epoch seconds on the
+     * wire.
+     */
+    getComments(args: GetCommentsArgs): Promise<Comment[]>;
+    /** Fetches a single comment by ID. The API wraps it in `{comment: ...}`. */
+    getComment(id: string): Promise<Comment>;
+    /**
+     * Creates a new comment. `id` is auto-generated if not supplied.
+     */
+    createComment(args: CreateCommentArgs): Promise<Comment>;
+    /** Updates a comment. */
+    updateComment(args: UpdateCommentArgs): Promise<Comment>;
+    /** Permanently deletes a comment. */
+    deleteComment(id: string): Promise<StatusOk>;
+    /**
+     * Marks the user's read position in a thread. Comment IDs are strings.
+     */
+    markPosition(args: MarkCommentPositionArgs): Promise<StatusOk>;
+}

package/dist/types/clients/conversation-messages-client.d.ts

@@ -0,0 +1,127 @@
+import { z } from 'zod';
+import { type ConversationMessage, type StatusOk } from '../types/entities.js';
+import type { CreateConversationMessageArgs, GetConversationMessagesArgs, UpdateConversationMessageArgs } from '../types/requests.js';
+import { BaseClient } from './base-client.js';
+export declare const ConversationMessageListSchema: z.ZodArray<z.ZodPipe<z.ZodObject<{
+    id: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+    content: z.ZodString;
+    creator: z.ZodNumber;
+    conversationId: z.ZodString;
+    posted: z.ZodDate;
+    systemMessage: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodUnknown]>>>;
+    attachments: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        attachmentId: z.ZodString;
+        urlType: z.ZodString;
+        title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        fileName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        fileSize: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        underlyingType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        image: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        imageWidth: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        imageHeight: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        duration: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        uploadState: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        video: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        videoType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        videoAutoPlay: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    }, z.core.$loose>>>>;
+    reactions: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodNumber>>>>;
+    actions: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodUnknown>>>;
+    objIndex: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    lastEdited: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
+    isDeleted: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    directGroupMentions: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    directMentions: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodNumber>>>;
+    version: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    workspaceId: z.ZodNumber;
+}, z.core.$strip>, z.ZodTransform<{
+    url: string;
+    id: string;
+    content: string;
+    creator: number;
+    conversationId: string;
+    posted: Date;
+    workspaceId: number;
+    systemMessage?: unknown;
+    attachments?: {
+        [x: string]: unknown;
+        attachmentId: string;
+        urlType: string;
+        title?: string | null | undefined;
+        url?: string | null | undefined;
+        fileName?: string | null | undefined;
+        fileSize?: number | null | undefined;
+        underlyingType?: string | null | undefined;
+        description?: string | null | undefined;
+        image?: string | null | undefined;
+        imageWidth?: number | null | undefined;
+        imageHeight?: number | null | undefined;
+        duration?: string | null | undefined;
+        uploadState?: string | null | undefined;
+        video?: string | null | undefined;
+        videoType?: string | null | undefined;
+        videoAutoPlay?: boolean | null | undefined;
+    }[] | null | undefined;
+    reactions?: Record<string, number[]> | null | undefined;
+    actions?: unknown[] | null | undefined;
+    objIndex?: number | null | undefined;
+    lastEdited?: Date | null | undefined;
+    isDeleted?: boolean | null | undefined;
+    directGroupMentions?: string[] | null | undefined;
+    directMentions?: number[] | null | undefined;
+    version?: number | null | undefined;
+}, {
+    id: string;
+    content: string;
+    creator: number;
+    conversationId: string;
+    posted: Date;
+    workspaceId: number;
+    systemMessage?: unknown;
+    attachments?: {
+        [x: string]: unknown;
+        attachmentId: string;
+        urlType: string;
+        title?: string | null | undefined;
+        url?: string | null | undefined;
+        fileName?: string | null | undefined;
+        fileSize?: number | null | undefined;
+        underlyingType?: string | null | undefined;
+        description?: string | null | undefined;
+        image?: string | null | undefined;
+        imageWidth?: number | null | undefined;
+        imageHeight?: number | null | undefined;
+        duration?: string | null | undefined;
+        uploadState?: string | null | undefined;
+        video?: string | null | undefined;
+        videoType?: string | null | undefined;
+        videoAutoPlay?: boolean | null | undefined;
+    }[] | null | undefined;
+    reactions?: Record<string, number[]> | null | undefined;
+    actions?: unknown[] | null | undefined;
+    objIndex?: number | null | undefined;
+    lastEdited?: Date | null | undefined;
+    isDeleted?: boolean | null | undefined;
+    directGroupMentions?: string[] | null | undefined;
+    directMentions?: number[] | null | undefined;
+    version?: number | null | undefined;
+}>>>;
+/**
+ * Client for `/api/v1/conversation_messages/`. The SDK auto-generates the
+ * message `id` on `createMessage` when the caller doesn't supply one.
+ */
+export declare class ConversationMessagesClient extends BaseClient {
+    /** Lists messages in a conversation. */
+    getMessages(args: GetConversationMessagesArgs): Promise<ConversationMessage[]>;
+    /** Fetches a single message by ID. */
+    getMessage(id: string): Promise<ConversationMessage>;
+    /** Creates a new message. `id` is auto-generated if not supplied. */
+    createMessage(args: CreateConversationMessageArgs): Promise<ConversationMessage>;
+    /** Updates a message. */
+    updateMessage(args: UpdateConversationMessageArgs): Promise<ConversationMessage>;
+    /** Permanently deletes a message. */
+    deleteMessage(id: string): Promise<StatusOk>;
+    private simple;
+}

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

@@ -0,0 +1,206 @@
+import { z } from 'zod';
+import { type Conversation, type StatusOk, type UnreadConversation } from '../types/entities.js';
+import type { AddConversationUserArgs, AddConversationUsersArgs, GetConversationsArgs, GetOrCreateConversationArgs, MuteConversationArgs, RemoveConversationUserArgs, RemoveConversationUsersArgs, UpdateConversationArgs } from '../types/requests.js';
+import { BaseClient } from './base-client.js';
+export declare const ConversationListSchema: z.ZodArray<z.ZodPipe<z.ZodObject<{
+    id: z.ZodString;
+    workspaceId: z.ZodNumber;
+    userIds: z.ZodArray<z.ZodNumber>;
+    messageCount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    lastObjIndex: z.ZodNumber;
+    snippet: z.ZodString;
+    snippetCreators: z.ZodArray<z.ZodNumber>;
+    lastActive: z.ZodDate;
+    mutedUntil: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
+    archived: z.ZodBoolean;
+    created: z.ZodDate;
+    creator: z.ZodNumber;
+    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    private: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    lastMessage: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        id: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<string, string | number>>;
+        content: z.ZodString;
+        creator: z.ZodNumber;
+        conversationId: z.ZodString;
+        posted: z.ZodDate;
+        systemMessage: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodUnknown]>>>;
+        attachments: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+            attachmentId: z.ZodString;
+            urlType: z.ZodString;
+            title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            fileName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            fileSize: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            underlyingType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            image: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            imageWidth: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            imageHeight: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            duration: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            uploadState: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            video: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            videoType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            videoAutoPlay: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        }, z.core.$loose>>>>;
+        reactions: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodNumber>>>>;
+        actions: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodUnknown>>>;
+        objIndex: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        lastEdited: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
+        deleted: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        directGroupMentions: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        directMentions: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodNumber>>>;
+        version: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        workspaceId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>, z.ZodTransform<{
+    url: string;
+    id: string;
+    workspaceId: number;
+    userIds: number[];
+    lastObjIndex: number;
+    snippet: string;
+    snippetCreators: number[];
+    lastActive: Date;
+    archived: boolean;
+    created: Date;
+    creator: number;
+    messageCount?: number | null | undefined;
+    mutedUntil?: Date | null | undefined;
+    title?: string | null | undefined;
+    private?: boolean | null | undefined;
+    lastMessage?: {
+        id: string;
+        content: string;
+        creator: number;
+        conversationId: string;
+        posted: Date;
+        systemMessage?: unknown;
+        attachments?: {
+            [x: string]: unknown;
+            attachmentId: string;
+            urlType: string;
+            title?: string | null | undefined;
+            url?: string | null | undefined;
+            fileName?: string | null | undefined;
+            fileSize?: number | null | undefined;
+            underlyingType?: string | null | undefined;
+            description?: string | null | undefined;
+            image?: string | null | undefined;
+            imageWidth?: number | null | undefined;
+            imageHeight?: number | null | undefined;
+            duration?: string | null | undefined;
+            uploadState?: string | null | undefined;
+            video?: string | null | undefined;
+            videoType?: string | null | undefined;
+            videoAutoPlay?: boolean | null | undefined;
+        }[] | null | undefined;
+        reactions?: Record<string, number[]> | null | undefined;
+        actions?: unknown[] | null | undefined;
+        objIndex?: number | null | undefined;
+        lastEdited?: Date | null | undefined;
+        deleted?: boolean | null | undefined;
+        directGroupMentions?: string[] | null | undefined;
+        directMentions?: number[] | null | undefined;
+        version?: number | null | undefined;
+        workspaceId?: number | null | undefined;
+    } | null | undefined;
+}, {
+    id: string;
+    workspaceId: number;
+    userIds: number[];
+    lastObjIndex: number;
+    snippet: string;
+    snippetCreators: number[];
+    lastActive: Date;
+    archived: boolean;
+    created: Date;
+    creator: number;
+    messageCount?: number | null | undefined;
+    mutedUntil?: Date | null | undefined;
+    title?: string | null | undefined;
+    private?: boolean | null | undefined;
+    lastMessage?: {
+        id: string;
+        content: string;
+        creator: number;
+        conversationId: string;
+        posted: Date;
+        systemMessage?: unknown;
+        attachments?: {
+            [x: string]: unknown;
+            attachmentId: string;
+            urlType: string;
+            title?: string | null | undefined;
+            url?: string | null | undefined;
+            fileName?: string | null | undefined;
+            fileSize?: number | null | undefined;
+            underlyingType?: string | null | undefined;
+            description?: string | null | undefined;
+            image?: string | null | undefined;
+            imageWidth?: number | null | undefined;
+            imageHeight?: number | null | undefined;
+            duration?: string | null | undefined;
+            uploadState?: string | null | undefined;
+            video?: string | null | undefined;
+            videoType?: string | null | undefined;
+            videoAutoPlay?: boolean | null | undefined;
+        }[] | null | undefined;
+        reactions?: Record<string, number[]> | null | undefined;
+        actions?: unknown[] | null | undefined;
+        objIndex?: number | null | undefined;
+        lastEdited?: Date | null | undefined;
+        deleted?: boolean | null | undefined;
+        directGroupMentions?: string[] | null | undefined;
+        directMentions?: number[] | null | undefined;
+        version?: number | null | undefined;
+        workspaceId?: number | null | undefined;
+    } | null | undefined;
+}>>>;
+/**
+ * Client for `/api/v1/conversations/`. `getOrCreate` requires an `id` (the
+ * SDK auto-generates one for new conversations); the backend dedupes on
+ * `userIds`, so an existing conversation will be returned with its own
+ * already-assigned `id` and your generated one is silently dropped.
+ */
+export declare class ConversationsClient extends BaseClient {
+    /** Lists conversations in a workspace. */
+    getConversations(args: GetConversationsArgs): Promise<Conversation[]>;
+    /** Fetches a single conversation by ID. */
+    getConversation(id: string): Promise<Conversation>;
+    /**
+     * Gets an existing 1:1 / group conversation with `userIds`, or creates a
+     * new one. `id` is auto-generated if not supplied — on dedupe, the
+     * backend returns the existing conversation's `id` instead.
+     */
+    getOrCreateConversation(args: GetOrCreateConversationArgs): Promise<Conversation>;
+    /** Updates a conversation's title. */
+    updateConversation(args: UpdateConversationArgs): Promise<Conversation>;
+    archiveConversation(id: string): Promise<Conversation>;
+    unarchiveConversation(id: string): Promise<Conversation>;
+    addUser(args: AddConversationUserArgs): Promise<Conversation>;
+    addUsers(args: AddConversationUsersArgs): Promise<Conversation>;
+    removeUser(args: RemoveConversationUserArgs): Promise<Conversation>;
+    removeUsers(args: RemoveConversationUsersArgs): Promise<Conversation>;
+    markRead(args: {
+        id: string;
+        objIndex?: number;
+        messageId?: string;
+    }): Promise<StatusOk>;
+    markUnread(args: {
+        id: string;
+        objIndex?: number;
+        messageId?: string;
+    }): Promise<StatusOk>;
+    /**
+     * Returns unread conversations for a workspace, paired with the unread
+     * version counter.
+     */
+    getUnread(workspaceId: number): Promise<{
+        data: UnreadConversation[];
+        version: number;
+    }>;
+    clearUnread(workspaceId: number): Promise<StatusOk>;
+    muteConversation(args: MuteConversationArgs): Promise<Conversation>;
+    unmuteConversation(id: string): Promise<Conversation>;
+    private simple;
+}

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

@@ -0,0 +1,55 @@
+import { z } from 'zod';
+import { type Group, type StatusOk } from '../types/entities.js';
+import type { AddGroupUserArgs, AddGroupUsersArgs, RemoveGroupUserArgs, RemoveGroupUsersArgs } from '../types/requests.js';
+import { BaseClient } from './base-client.js';
+export declare const GroupListSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    workspaceId: z.ZodNumber;
+    userIds: z.ZodArray<z.ZodNumber>;
+    version: z.ZodNumber;
+}, z.core.$strip>>;
+/**
+ * Client for `/api/v1/groups/`. The broadcast markers `EVERYONE` /
+ * `EVERYONE_IN_THREAD` are NOT addressable through these endpoints — they
+ * only appear as members of `direct_group_mentions` / `groups` lists on
+ * thread/comment writes.
+ *
+ * `getone` / `update` / `remove` and the member-management ops all require
+ * `workspace_id` alongside the group `id`.
+ */
+export declare class GroupsClient extends BaseClient {
+    /** Lists groups in a workspace. */
+    getGroups(workspaceId: number): Promise<Group[]>;
+    /** Fetches a single group by ID (requires `workspaceId`). */
+    getGroup(args: {
+        id: string;
+        workspaceId: number;
+    }): Promise<Group>;
+    /** Creates a new group. `id` is auto-generated if not supplied. */
+    createGroup(args: {
+        workspaceId: number;
+        name: string;
+        id?: string;
+        description?: string;
+        userIds?: number[];
+    }): Promise<Group>;
+    /** Updates a group. Requires `workspaceId`. */
+    updateGroup(args: {
+        id: string;
+        workspaceId: number;
+        name?: string;
+        description?: string;
+    }): Promise<Group>;
+    /** Permanently deletes a group. Requires `workspaceId`. */
+    deleteGroup(args: {
+        id: string;
+        workspaceId: number;
+    }): Promise<StatusOk>;
+    addUser(args: AddGroupUserArgs): Promise<StatusOk>;
+    addUsers(args: AddGroupUsersArgs): Promise<StatusOk>;
+    removeUser(args: RemoveGroupUserArgs): Promise<StatusOk>;
+    removeUsers(args: RemoveGroupUsersArgs): Promise<StatusOk>;
+    private simple;
+}

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

@@ -0,0 +1,20 @@
+import { type InboxThread } from '../types/entities.js';
+import type { ArchiveAllArgs, GetInboxArgs } from '../types/requests.js';
+import { BaseClient } from './base-client.js';
+/** Client for `/api/v1/inbox/`. */
+export declare class InboxClient extends BaseClient {
+    /**
+     * Gets inbox items (threads).
+     */
+    getInbox(args: GetInboxArgs): Promise<InboxThread[]>;
+    /** Gets unread count for inbox. */
+    getCount(workspaceId: number): Promise<number>;
+    /** Archives a thread in the inbox. */
+    archiveThread(id: string): Promise<void>;
+    /** Unarchives a thread in the inbox. */
+    unarchiveThread(id: string): Promise<void>;
+    /** Marks all inbox items as read in a workspace. */
+    markAllRead(workspaceId: number): Promise<void>;
+    /** Archives all inbox items in a workspace. */
+    archiveAll(args: ArchiveAllArgs): Promise<void>;
+}

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

@@ -0,0 +1,19 @@
+import type { ReactionObject } from '../types/entities.js';
+import type { AddReactionArgs, GetReactionsArgs, RemoveReactionArgs } from '../types/requests.js';
+import { BaseClient } from './base-client.js';
+/**
+ * Client for interacting with Comms reaction endpoints.
+ */
+export declare class ReactionsClient extends BaseClient {
+    /** Adds an emoji reaction to a thread, comment, or conversation message. */
+    add(args: AddReactionArgs): Promise<void>;
+    /**
+     * Gets reactions for a thread, comment, or conversation message.
+     *
+     * Returns an object with emoji reactions as keys and arrays of user IDs as
+     * values, or null if no reactions.
+     */
+    get(args: GetReactionsArgs): Promise<ReactionObject>;
+    /** Removes an emoji reaction from a thread, comment, or conversation message. */
+    remove(args: RemoveReactionArgs): Promise<void>;
+}

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

@@ -0,0 +1,20 @@
+import { type SearchConversationResponse, type SearchResponse, type SearchThreadResponse } from '../types/entities.js';
+import type { SearchArgs, SearchConversationArgs, SearchThreadArgs } from '../types/requests.js';
+import { BaseClient } from './base-client.js';
+/**
+ * Client for interacting with Comms search endpoints.
+ */
+export declare class SearchClient extends BaseClient {
+    /**
+     * Searches across all threads and conversations in a workspace.
+     */
+    search(args: SearchArgs): Promise<SearchResponse>;
+    /**
+     * Searches within comments of a specific thread.
+     */
+    searchThread(args: SearchThreadArgs): Promise<SearchThreadResponse>;
+    /**
+     * Searches within messages of a specific conversation.
+     */
+    searchConversation(args: SearchConversationArgs): Promise<SearchConversationResponse>;
+}