@doist/twist-sdk 2.5.1 → 2.7.0

package/dist/cjs/clients/add-comment-helper.js

@@ -10,16 +10,58 @@ var __assign = (this && this.__assign) || function () {
     };
     return __assign.apply(this, arguments);
 };
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.addCommentRequest = addCommentRequest;
 var endpoints_1 = require("../consts/endpoints");
 var http_client_1 = require("../transport/http-client");
 var entities_1 = require("../types/entities");
+var enums_1 = require("../types/enums");
+var SENTINEL_GROUP_IDS = new Set(Object.values(enums_1.NOTIFY_AUDIENCE_GROUP_IDS));
+function isNotifyAudience(value) {
+    return typeof value === 'string' && enums_1.NOTIFY_AUDIENCES.includes(value);
+}
+function applyNotifyAudience(params) {
+    if (params.groups) {
+        var offending = params.groups.filter(function (id) { return SENTINEL_GROUP_IDS.has(id); });
+        if (offending.length > 0) {
+            throw new Error("`groups` must not contain reserved sentinel IDs (".concat(offending.join(', '), "). Use `notifyAudience` instead."));
+        }
+    }
+    if (params.notifyAudience == null)
+        return params;
+    if (!isNotifyAudience(params.notifyAudience)) {
+        throw new Error("Invalid `notifyAudience` value \"".concat(String(params.notifyAudience), "\". Expected one of: ").concat(enums_1.NOTIFY_AUDIENCES.join(', '), "."));
+    }
+    var sentinel = enums_1.NOTIFY_AUDIENCE_GROUP_IDS[params.notifyAudience];
+    var _stripped = params.notifyAudience, groups = params.groups, rest = __rest(params, ["notifyAudience", "groups"]);
+    return __assign(__assign({}, rest), { groups: __spreadArray(__spreadArray([], (groups !== null && groups !== void 0 ? groups : []), true), [sentinel], false) });
+}
 function addCommentRequest(context, params, options) {
     var method = 'POST';
     var url = "".concat(endpoints_1.ENDPOINT_COMMENTS, "/add");
+    var normalized = applyNotifyAudience(params);
     var payload = (options === null || options === void 0 ? void 0 : options.threadAction)
-        ? __assign(__assign({}, params), { threadAction: options.threadAction }) : params;
+        ? __assign(__assign({}, normalized), { threadAction: options.threadAction }) : normalized;
     var schema = entities_1.CommentSchema;
     if (options === null || options === void 0 ? void 0 : options.batch) {
         return { method: method, url: url, params: payload, schema: schema };

package/dist/cjs/types/entities.js

@@ -11,12 +11,38 @@ var __assign = (this && this.__assign) || function () {
     return __assign.apply(this, arguments);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SearchResultSchema = exports.SEARCH_RESULT_TYPES = exports.UnreadConversationSchema = exports.UnreadThreadSchema = exports.InboxThreadSchema = exports.ConversationMessageSchema = exports.WorkspaceUserSchema = exports.CommentSchema = exports.ConversationSchema = exports.GroupSchema = exports.ThreadSchema = exports.ChannelSchema = exports.WorkspaceSchema = exports.UserSchema = exports.BaseUserSchema = exports.SystemMessageSchema = void 0;
+exports.SearchResultSchema = exports.SEARCH_RESULT_TYPES = exports.UnreadConversationSchema = exports.UnreadThreadSchema = exports.InboxThreadSchema = exports.ConversationMessageSchema = exports.WorkspaceUserSchema = exports.CommentSchema = exports.ConversationSchema = exports.GroupSchema = exports.ThreadSchema = exports.ChannelSchema = exports.WorkspaceSchema = exports.UserSchema = exports.BaseUserSchema = exports.AttachmentSchema = exports.SystemMessageSchema = void 0;
 var zod_1 = require("zod");
 var url_helpers_1 = require("../utils/url-helpers");
 var enums_1 = require("./enums");
 // Reusable schema for system messages that can be either a string or an object
 exports.SystemMessageSchema = zod_1.z.union([zod_1.z.string(), zod_1.z.unknown()]).nullable().optional();
+// Attachment entity from API. Mirrors the canonical backend shape produced by
+// `unify_attachments` / `validate_file_attachment_json` in the Twist backend.
+// Only `attachmentId` and `urlType` are guaranteed; everything else depends on
+// the attachment kind (file vs image vs link preview vs unfurled GIF).
+// Loose: unknown keys from the backend pass through rather than being stripped,
+// so newly-added or off-spec fields stay accessible to callers.
+exports.AttachmentSchema = zod_1.z
+    .object({
+    attachmentId: zod_1.z.string(),
+    urlType: zod_1.z.string(),
+    title: zod_1.z.string().nullable().optional(),
+    url: zod_1.z.string().nullable().optional(),
+    fileName: zod_1.z.string().nullable().optional(),
+    fileSize: zod_1.z.number().int().nonnegative().nullable().optional(),
+    underlyingType: zod_1.z.string().nullable().optional(),
+    description: zod_1.z.string().nullable().optional(),
+    image: zod_1.z.string().nullable().optional(),
+    imageWidth: zod_1.z.number().int().nonnegative().nullable().optional(),
+    imageHeight: zod_1.z.number().int().nonnegative().nullable().optional(),
+    duration: zod_1.z.string().nullable().optional(),
+    uploadState: zod_1.z.string().nullable().optional(),
+    video: zod_1.z.string().nullable().optional(),
+    videoType: zod_1.z.string().nullable().optional(),
+    videoAutoPlay: zod_1.z.boolean().nullable().optional(),
+})
+    .loose();
 // Base user schema with common fields shared between User and WorkspaceUser
 exports.BaseUserSchema = zod_1.z.object({
     id: zod_1.z.number(),
@@ -118,7 +144,7 @@ exports.ThreadSchema = zod_1.z
     channelId: zod_1.z.number(),
     workspaceId: zod_1.z.number(),
     actions: zod_1.z.array(zod_1.z.unknown()).nullable().optional(),
-    attachments: zod_1.z.array(zod_1.z.unknown()).nullable().optional(),
+    attachments: zod_1.z.array(exports.AttachmentSchema).nullable().optional(),
     commentCount: zod_1.z.number(),
     closed: zod_1.z.boolean().nullable().optional(),
     directGroupMentions: zod_1.z.array(zod_1.z.number()).nullable().optional(),
@@ -155,7 +181,7 @@ exports.ThreadSchema = zod_1.z
         channelId: zod_1.z.number(),
         posted: zod_1.z.date(),
         systemMessage: exports.SystemMessageSchema,
-        attachments: zod_1.z.array(zod_1.z.unknown()).nullable().optional(),
+        attachments: zod_1.z.array(exports.AttachmentSchema).nullable().optional(),
         reactions: zod_1.z.record(zod_1.z.string(), zod_1.z.array(zod_1.z.number())).nullable().optional(),
         actions: zod_1.z.array(zod_1.z.unknown()).nullable().optional(),
         objIndex: zod_1.z.number(),
@@ -212,7 +238,7 @@ exports.ConversationSchema = zod_1.z
         conversationId: zod_1.z.number(),
         posted: zod_1.z.date(),
         systemMessage: exports.SystemMessageSchema,
-        attachments: zod_1.z.array(zod_1.z.unknown()).nullable().optional(),
+        attachments: zod_1.z.array(exports.AttachmentSchema).nullable().optional(),
         reactions: zod_1.z.record(zod_1.z.string(), zod_1.z.array(zod_1.z.number())).nullable().optional(),
         actions: zod_1.z.array(zod_1.z.unknown()).nullable().optional(),
         objIndex: zod_1.z.number().nullable().optional(),
@@ -241,7 +267,7 @@ exports.CommentSchema = zod_1.z
     directMentions: zod_1.z.array(zod_1.z.number()).nullable().optional(),
     directGroupMentions: zod_1.z.array(zod_1.z.number()).nullable().optional(),
     systemMessage: exports.SystemMessageSchema,
-    attachments: zod_1.z.array(zod_1.z.unknown()).nullable().optional(),
+    attachments: zod_1.z.array(exports.AttachmentSchema).nullable().optional(),
     reactions: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).nullable().optional(),
     objIndex: zod_1.z.number().nullable().optional(),
     // Extended fields that may appear in some API responses (like inbox)
@@ -280,7 +306,7 @@ exports.ConversationMessageSchema = zod_1.z
     conversationId: zod_1.z.number(),
     posted: zod_1.z.date(),
     systemMessage: exports.SystemMessageSchema,
-    attachments: zod_1.z.array(zod_1.z.unknown()).nullable().optional(),
+    attachments: zod_1.z.array(exports.AttachmentSchema).nullable().optional(),
     reactions: zod_1.z.record(zod_1.z.string(), zod_1.z.array(zod_1.z.number())).nullable().optional(),
     actions: zod_1.z.array(zod_1.z.unknown()).nullable().optional(),
     objIndex: zod_1.z.number().nullable().optional(),
@@ -307,7 +333,7 @@ exports.InboxThreadSchema = zod_1.z
     channelId: zod_1.z.number(),
     workspaceId: zod_1.z.number(),
     actions: zod_1.z.array(zod_1.z.unknown()).nullable().optional(),
-    attachments: zod_1.z.array(zod_1.z.unknown()).nullable().optional(),
+    attachments: zod_1.z.array(exports.AttachmentSchema).nullable().optional(),
     commentCount: zod_1.z.number(),
     directGroupMentions: zod_1.z.array(zod_1.z.number()).nullable().optional(),
     directMentions: zod_1.z.array(zod_1.z.number()).nullable().optional(),

package/dist/cjs/types/enums.js

@@ -1,7 +1,21 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WORKSPACE_PLANS = exports.USER_TYPES = void 0;
+exports.NOTIFY_AUDIENCE_GROUP_IDS = exports.NOTIFY_AUDIENCES = exports.WORKSPACE_PLANS = exports.USER_TYPES = void 0;
 // User types for workspace users
 exports.USER_TYPES = ['USER', 'GUEST', 'ADMIN'];
 // Workspace plans
 exports.WORKSPACE_PLANS = ['free', 'unlimited'];
+// Audiences that comment-creating endpoints can target alongside (or instead
+// of) individual `recipients` / custom `groups`.
+exports.NOTIFY_AUDIENCES = ['channel', 'thread'];
+/**
+ * Internal mapping from {@link NotifyAudience} to the magic group IDs that
+ * Twist's `comments/add` endpoint uses on the wire. Exposed here so the
+ * audience constants and their encoding stay in a single source of truth;
+ * SDK consumers should use {@link NotifyAudience} via `notifyAudience` on the
+ * request args rather than passing these IDs directly.
+ */
+exports.NOTIFY_AUDIENCE_GROUP_IDS = {
+    channel: 1,
+    thread: 2,
+};

package/dist/cjs/types/requests.js

@@ -2,6 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.THREAD_ACTIONS = exports.ARCHIVE_FILTER_VALUES = exports.AWAY_MODE_TYPES = exports.GetOrCreateConversationArgsSchema = exports.GetConversationsArgsSchema = exports.GetCommentsArgsSchema = exports.GetThreadsArgsSchema = exports.GetChannelsArgsSchema = exports.CreateMessageArgsSchema = exports.CreateConversationArgsSchema = exports.UpdateCommentArgsSchema = exports.CreateCommentArgsSchema = exports.UpdateThreadArgsSchema = exports.CreateThreadArgsSchema = exports.UpdateChannelArgsSchema = exports.CreateChannelArgsSchema = void 0;
 var zod_1 = require("zod");
+var entities_1 = require("./entities");
+var enums_1 = require("./enums");
 exports.CreateChannelArgsSchema = zod_1.z.object({
     workspaceId: zod_1.z.number(),
     name: zod_1.z.string(),
@@ -43,9 +45,12 @@ exports.CreateCommentArgsSchema = zod_1.z.object({
     threadId: zod_1.z.number(),
     content: zod_1.z.string(),
     tempId: zod_1.z.number().nullable().optional(),
-    attachments: zod_1.z.unknown().nullable().optional(),
+    attachments: zod_1.z.array(entities_1.AttachmentSchema).nullable().optional(),
     actions: zod_1.z.unknown().nullable().optional(),
     recipients: zod_1.z.array(zod_1.z.number()).nullable().optional(),
+    groups: zod_1.z.array(zod_1.z.number()).nullable().optional(),
+    directMentions: zod_1.z.array(zod_1.z.number()).nullable().optional(),
+    notifyAudience: zod_1.z.enum(enums_1.NOTIFY_AUDIENCES).nullable().optional(),
 });
 exports.UpdateCommentArgsSchema = zod_1.z.object({
     id: zod_1.z.number(),
@@ -61,7 +66,7 @@ exports.CreateMessageArgsSchema = zod_1.z
     conversationId: zod_1.z.number().nullable().optional(),
     threadId: zod_1.z.number().nullable().optional(),
     content: zod_1.z.string(),
-    attachments: zod_1.z.array(zod_1.z.number()).nullable().optional(),
+    attachments: zod_1.z.array(entities_1.AttachmentSchema).nullable().optional(),
 })
     .refine(function (data) {
     return ((data.conversationId && !data.threadId) || (!data.conversationId && data.threadId));

package/dist/esm/clients/add-comment-helper.js

@@ -9,14 +9,56 @@ var __assign = (this && this.__assign) || function () {
     };
     return __assign.apply(this, arguments);
 };
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
 import { ENDPOINT_COMMENTS } from '../consts/endpoints.js';
 import { request } from '../transport/http-client.js';
 import { CommentSchema } from '../types/entities.js';
+import { NOTIFY_AUDIENCE_GROUP_IDS, NOTIFY_AUDIENCES } from '../types/enums.js';
+var SENTINEL_GROUP_IDS = new Set(Object.values(NOTIFY_AUDIENCE_GROUP_IDS));
+function isNotifyAudience(value) {
+    return typeof value === 'string' && NOTIFY_AUDIENCES.includes(value);
+}
+function applyNotifyAudience(params) {
+    if (params.groups) {
+        var offending = params.groups.filter(function (id) { return SENTINEL_GROUP_IDS.has(id); });
+        if (offending.length > 0) {
+            throw new Error("`groups` must not contain reserved sentinel IDs (".concat(offending.join(', '), "). Use `notifyAudience` instead."));
+        }
+    }
+    if (params.notifyAudience == null)
+        return params;
+    if (!isNotifyAudience(params.notifyAudience)) {
+        throw new Error("Invalid `notifyAudience` value \"".concat(String(params.notifyAudience), "\". Expected one of: ").concat(NOTIFY_AUDIENCES.join(', '), "."));
+    }
+    var sentinel = NOTIFY_AUDIENCE_GROUP_IDS[params.notifyAudience];
+    var _stripped = params.notifyAudience, groups = params.groups, rest = __rest(params, ["notifyAudience", "groups"]);
+    return __assign(__assign({}, rest), { groups: __spreadArray(__spreadArray([], (groups !== null && groups !== void 0 ? groups : []), true), [sentinel], false) });
+}
 export function addCommentRequest(context, params, options) {
     var method = 'POST';
     var url = "".concat(ENDPOINT_COMMENTS, "/add");
+    var normalized = applyNotifyAudience(params);
     var payload = (options === null || options === void 0 ? void 0 : options.threadAction)
-        ? __assign(__assign({}, params), { threadAction: options.threadAction }) : params;
+        ? __assign(__assign({}, normalized), { threadAction: options.threadAction }) : normalized;
     var schema = CommentSchema;
     if (options === null || options === void 0 ? void 0 : options.batch) {
         return { method: method, url: url, params: payload, schema: schema };

package/dist/esm/types/entities.js

@@ -14,6 +14,32 @@ import { getFullTwistURL } from '../utils/url-helpers.js';
 import { USER_TYPES, WORKSPACE_PLANS } from './enums.js';
 // Reusable schema for system messages that can be either a string or an object
 export var SystemMessageSchema = z.union([z.string(), z.unknown()]).nullable().optional();
+// Attachment entity from API. Mirrors the canonical backend shape produced by
+// `unify_attachments` / `validate_file_attachment_json` in the Twist backend.
+// Only `attachmentId` and `urlType` are guaranteed; everything else depends on
+// the attachment kind (file vs image vs link preview vs unfurled GIF).
+// Loose: unknown keys from the backend pass through rather than being stripped,
+// so newly-added or off-spec fields stay accessible to callers.
+export var AttachmentSchema = z
+    .object({
+    attachmentId: z.string(),
+    urlType: z.string(),
+    title: z.string().nullable().optional(),
+    url: z.string().nullable().optional(),
+    fileName: z.string().nullable().optional(),
+    fileSize: z.number().int().nonnegative().nullable().optional(),
+    underlyingType: z.string().nullable().optional(),
+    description: z.string().nullable().optional(),
+    image: z.string().nullable().optional(),
+    imageWidth: z.number().int().nonnegative().nullable().optional(),
+    imageHeight: z.number().int().nonnegative().nullable().optional(),
+    duration: z.string().nullable().optional(),
+    uploadState: z.string().nullable().optional(),
+    video: z.string().nullable().optional(),
+    videoType: z.string().nullable().optional(),
+    videoAutoPlay: z.boolean().nullable().optional(),
+})
+    .loose();
 // Base user schema with common fields shared between User and WorkspaceUser
 export var BaseUserSchema = z.object({
     id: z.number(),
@@ -115,7 +141,7 @@ export var ThreadSchema = z
     channelId: z.number(),
     workspaceId: z.number(),
     actions: z.array(z.unknown()).nullable().optional(),
-    attachments: z.array(z.unknown()).nullable().optional(),
+    attachments: z.array(AttachmentSchema).nullable().optional(),
     commentCount: z.number(),
     closed: z.boolean().nullable().optional(),
     directGroupMentions: z.array(z.number()).nullable().optional(),
@@ -152,7 +178,7 @@ export var ThreadSchema = z
         channelId: z.number(),
         posted: z.date(),
         systemMessage: SystemMessageSchema,
-        attachments: z.array(z.unknown()).nullable().optional(),
+        attachments: z.array(AttachmentSchema).nullable().optional(),
         reactions: z.record(z.string(), z.array(z.number())).nullable().optional(),
         actions: z.array(z.unknown()).nullable().optional(),
         objIndex: z.number(),
@@ -209,7 +235,7 @@ export var ConversationSchema = z
         conversationId: z.number(),
         posted: z.date(),
         systemMessage: SystemMessageSchema,
-        attachments: z.array(z.unknown()).nullable().optional(),
+        attachments: z.array(AttachmentSchema).nullable().optional(),
         reactions: z.record(z.string(), z.array(z.number())).nullable().optional(),
         actions: z.array(z.unknown()).nullable().optional(),
         objIndex: z.number().nullable().optional(),
@@ -238,7 +264,7 @@ export var CommentSchema = z
     directMentions: z.array(z.number()).nullable().optional(),
     directGroupMentions: z.array(z.number()).nullable().optional(),
     systemMessage: SystemMessageSchema,
-    attachments: z.array(z.unknown()).nullable().optional(),
+    attachments: z.array(AttachmentSchema).nullable().optional(),
     reactions: z.record(z.string(), z.unknown()).nullable().optional(),
     objIndex: z.number().nullable().optional(),
     // Extended fields that may appear in some API responses (like inbox)
@@ -277,7 +303,7 @@ export var ConversationMessageSchema = z
     conversationId: z.number(),
     posted: z.date(),
     systemMessage: SystemMessageSchema,
-    attachments: z.array(z.unknown()).nullable().optional(),
+    attachments: z.array(AttachmentSchema).nullable().optional(),
     reactions: z.record(z.string(), z.array(z.number())).nullable().optional(),
     actions: z.array(z.unknown()).nullable().optional(),
     objIndex: z.number().nullable().optional(),
@@ -304,7 +330,7 @@ export var InboxThreadSchema = z
     channelId: z.number(),
     workspaceId: z.number(),
     actions: z.array(z.unknown()).nullable().optional(),
-    attachments: z.array(z.unknown()).nullable().optional(),
+    attachments: z.array(AttachmentSchema).nullable().optional(),
     commentCount: z.number(),
     directGroupMentions: z.array(z.number()).nullable().optional(),
     directMentions: z.array(z.number()).nullable().optional(),

package/dist/esm/types/enums.js

@@ -2,3 +2,17 @@
 export var USER_TYPES = ['USER', 'GUEST', 'ADMIN'];
 // Workspace plans
 export var WORKSPACE_PLANS = ['free', 'unlimited'];
+// Audiences that comment-creating endpoints can target alongside (or instead
+// of) individual `recipients` / custom `groups`.
+export var NOTIFY_AUDIENCES = ['channel', 'thread'];
+/**
+ * Internal mapping from {@link NotifyAudience} to the magic group IDs that
+ * Twist's `comments/add` endpoint uses on the wire. Exposed here so the
+ * audience constants and their encoding stay in a single source of truth;
+ * SDK consumers should use {@link NotifyAudience} via `notifyAudience` on the
+ * request args rather than passing these IDs directly.
+ */
+export var NOTIFY_AUDIENCE_GROUP_IDS = {
+    channel: 1,
+    thread: 2,
+};

package/dist/esm/types/requests.js

@@ -1,4 +1,6 @@
 import { z } from 'zod';
+import { AttachmentSchema } from './entities.js';
+import { NOTIFY_AUDIENCES } from './enums.js';
 export var CreateChannelArgsSchema = z.object({
     workspaceId: z.number(),
     name: z.string(),
@@ -40,9 +42,12 @@ export var CreateCommentArgsSchema = z.object({
     threadId: z.number(),
     content: z.string(),
     tempId: z.number().nullable().optional(),
-    attachments: z.unknown().nullable().optional(),
+    attachments: z.array(AttachmentSchema).nullable().optional(),
     actions: z.unknown().nullable().optional(),
     recipients: z.array(z.number()).nullable().optional(),
+    groups: z.array(z.number()).nullable().optional(),
+    directMentions: z.array(z.number()).nullable().optional(),
+    notifyAudience: z.enum(NOTIFY_AUDIENCES).nullable().optional(),
 });
 export var UpdateCommentArgsSchema = z.object({
     id: z.number(),
@@ -58,7 +63,7 @@ export var CreateMessageArgsSchema = z
     conversationId: z.number().nullable().optional(),
     threadId: z.number().nullable().optional(),
     content: z.string(),
-    attachments: z.array(z.number()).nullable().optional(),
+    attachments: z.array(AttachmentSchema).nullable().optional(),
 })
     .refine(function (data) {
     return ((data.conversationId && !data.threadId) || (!data.conversationId && data.threadId));

package/dist/types/clients/add-comment-helper.d.ts

@@ -1,13 +1,13 @@
 import type { BatchRequestDescriptor } from '../types/batch.js';
 import { type Comment } from '../types/entities.js';
 import type { CustomFetch } from '../types/http.js';
-import type { ThreadAction } from '../types/requests.js';
+import type { CreateCommentArgs, ThreadAction } from '../types/requests.js';
 type ClientContext = {
     baseUri: string;
     apiToken: string;
     customFetch?: CustomFetch;
 };
-export declare function addCommentRequest(context: ClientContext, params: Record<string, unknown>, options?: {
+export declare function addCommentRequest(context: ClientContext, params: CreateCommentArgs, options?: {
     batch?: boolean;
     threadAction?: ThreadAction;
 }): Promise<Comment> | BatchRequestDescriptor<Comment>;

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

@@ -52,17 +52,26 @@ export declare class CommentsClient extends BaseClient {
      * @param args - The arguments for creating a comment.
      * @param args.threadId - The thread ID.
      * @param args.content - The comment content.
-     * @param args.recipients - Optional array of user IDs to notify.
-     * @param args.attachments - Optional array of attachment objects.
+     * @param args.recipients - Optional array of user IDs to notify directly.
+     * @param args.groups - Optional array of custom group IDs to notify.
+     * @param args.directMentions - Optional array of user IDs that were @-mentioned in
+     *   `content`.
+     * @param args.notifyAudience - Optional broader audience to notify in addition to
+     *   `recipients` and `groups`. `'channel'` notifies everyone in the channel;
+     *   `'thread'` notifies everyone who has interacted with the thread.
+     * @param args.attachments - Optional array of {@link Attachment} objects.
      * @param args.sendAsIntegration - Optional flag to send as integration.
      * @param options - Optional configuration. Set `batch: true` to return a descriptor for batch requests.
      * @returns The created comment object.
      *
      * @example
      * ```typescript
+     * // Notify everyone who has interacted with the thread, plus two extra users.
      * const comment = await api.comments.createComment({
      *   threadId: 789,
-     *   content: 'Great idea! Let\'s proceed with this approach.'
+     *   content: 'Great idea! Let\'s proceed.',
+     *   notifyAudience: 'thread',
+     *   recipients: [12345, 67890],
      * })
      * ```
      */
@@ -79,7 +88,6 @@ export declare class CommentsClient extends BaseClient {
      * @param args.id - The comment ID.
      * @param args.content - Optional new comment content.
      * @param args.recipients - Optional array of user IDs to notify.
-     * @param args.attachments - Optional array of attachment objects.
      * @param options - Optional configuration. Set `batch: true` to return a descriptor for batch requests.
      * @returns The updated comment object.
      */

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

@@ -56,7 +56,7 @@ export declare class ConversationMessagesClient extends BaseClient {
      * @param args - The arguments for creating a message.
      * @param args.conversationId - The conversation ID.
      * @param args.content - The message content.
-     * @param args.attachments - Optional array of attachment objects.
+     * @param args.attachments - Optional array of {@link Attachment} objects.
      * @param args.actions - Optional array of action objects.
      * @param options - Optional configuration. Set `batch: true` to return a descriptor for batch requests.
      * @returns The created message object.
@@ -81,7 +81,7 @@ export declare class ConversationMessagesClient extends BaseClient {
      * @param args - The arguments for updating a message.
      * @param args.id - The message ID.
      * @param args.content - The new message content.
-     * @param args.attachments - Optional array of attachment objects.
+     * @param args.attachments - Optional array of {@link Attachment} objects.
      * @param options - Optional configuration. Set `batch: true` to return a descriptor for batch requests.
      * @returns The updated message object.
      *

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

@@ -54,7 +54,6 @@ export declare class ThreadsClient extends BaseClient {
      * @param args.title - The thread title.
      * @param args.content - The thread content.
      * @param args.recipients - Optional array of user IDs to notify.
-     * @param args.attachments - Optional array of attachment objects.
      * @param args.sendAsIntegration - Optional flag to send as integration.
      * @param options - Optional configuration. Set `batch: true` to return a descriptor for batch requests.
      * @returns The created thread object.
@@ -82,7 +81,6 @@ export declare class ThreadsClient extends BaseClient {
      * @param args.title - Optional new thread title.
      * @param args.content - Optional new thread content.
      * @param args.recipients - Optional array of user IDs to notify.
-     * @param args.attachments - Optional array of attachment objects.
      * @param options - Optional configuration. Set `batch: true` to return a descriptor for batch requests.
      * @returns The updated thread object.
      */
@@ -328,9 +326,15 @@ export declare class ThreadsClient extends BaseClient {
      * @param args.id - The thread ID.
      * @param args.content - The comment content.
      * @param args.tempId - Optional temporary identifier.
-     * @param args.attachments - Optional array of attachment objects.
+     * @param args.attachments - Optional array of {@link Attachment} objects.
      * @param args.actions - Optional array of action objects.
-     * @param args.recipients - Optional array of user IDs to notify.
+     * @param args.recipients - Optional array of user IDs to notify directly.
+     * @param args.groups - Optional array of custom group IDs to notify.
+     * @param args.directMentions - Optional array of user IDs that were @-mentioned in
+     *   `content`.
+     * @param args.notifyAudience - Optional broader audience to notify in addition to
+     *   `recipients` and `groups`. `'channel'` notifies everyone in the channel;
+     *   `'thread'` notifies everyone who has interacted with the thread.
      * @param options - Optional configuration. Set `batch: true` to return a descriptor for batch requests.
      * @returns The created comment object.
      *
@@ -355,9 +359,15 @@ export declare class ThreadsClient extends BaseClient {
      * @param args.id - The thread ID.
      * @param args.content - The comment content.
      * @param args.tempId - Optional temporary identifier.
-     * @param args.attachments - Optional array of attachment objects.
+     * @param args.attachments - Optional array of {@link Attachment} objects.
      * @param args.actions - Optional array of action objects.
-     * @param args.recipients - Optional array of user IDs to notify.
+     * @param args.recipients - Optional array of user IDs to notify directly.
+     * @param args.groups - Optional array of custom group IDs to notify.
+     * @param args.directMentions - Optional array of user IDs that were @-mentioned in
+     *   `content`.
+     * @param args.notifyAudience - Optional broader audience to notify in addition to
+     *   `recipients` and `groups`. `'channel'` notifies everyone in the channel;
+     *   `'thread'` notifies everyone who has interacted with the thread.
      * @param options - Optional configuration. Set `batch: true` to return a descriptor for batch requests.
      * @returns The created comment object.
      *