@doist/comms-sdk 0.2.0 → 0.2.1

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

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 import { ENDPOINT_CONVERSATIONS } from '../consts/endpoints.js';
 import { request } from '../transport/http-client.js';
-import { ConversationSchema, StatusOkSchema, UnreadConversationSchema, } from '../types/entities.js';
+import { ConversationSchema, createConversationSchema, StatusOkSchema, UnreadConversationSchema, } from '../types/entities.js';
 import { resolveCreateId } from '../utils/uuidv7.js';
 import { BaseClient } from './base-client.js';
 export const ConversationListSchema = z.array(ConversationSchema);
@@ -16,6 +16,17 @@ const GetUnreadResponseSchema = z.object({
  * already-assigned `id` and your generated one is silently dropped.
  */
 export class ConversationsClient extends BaseClient {
+    constructor() {
+        super(...arguments);
+        this.linkBaseUrl = this.getLinkBaseUrl();
+        // Reuse the shared singletons when no custom base is configured.
+        this.conversationSchema = this.linkBaseUrl
+            ? createConversationSchema(this.linkBaseUrl)
+            : ConversationSchema;
+        this.conversationListSchema = this.linkBaseUrl
+            ? z.array(this.conversationSchema)
+            : ConversationListSchema;
+    }
     /**
      * Gets all conversations for a workspace.
      *
@@ -38,7 +49,7 @@ export class ConversationsClient extends BaseClient {
             apiToken: this.apiToken,
             payload: args,
             customFetch: this.customFetch,
-        }).then((response) => ConversationListSchema.parse(response.data));
+        }).then((response) => this.conversationListSchema.parse(response.data));
     }
     /**
      * Gets a single conversation object by id.
@@ -47,7 +58,7 @@ export class ConversationsClient extends BaseClient {
      * @returns The conversation object.
      */
     getConversation(id) {
-        return this.simple('GET', 'getone', { id }, ConversationSchema);
+        return this.simple('GET', 'getone', { id }, this.conversationSchema);
     }
     /**
      * Gets an existing 1:1 / group conversation with `userIds`, or creates a
@@ -68,7 +79,7 @@ export class ConversationsClient extends BaseClient {
      * ```
      */
     getOrCreateConversation(args) {
-        return this.simple('GET', 'get_or_create', { ...args, id: resolveCreateId(args.id) }, ConversationSchema);
+        return this.simple('GET', 'get_or_create', { ...args, id: resolveCreateId(args.id) }, this.conversationSchema);
     }
     /**
      * Updates a conversation's title.
@@ -91,7 +102,7 @@ export class ConversationsClient extends BaseClient {
         const params = { id: args.id, title: args.title };
         if (args.archived !== undefined)
             params.archived = args.archived;
-        return this.simple('POST', 'update', params, ConversationSchema);
+        return this.simple('POST', 'update', params, this.conversationSchema);
     }
     /**
      * Archives a conversation.
@@ -100,7 +111,7 @@ export class ConversationsClient extends BaseClient {
      * @returns The updated conversation object.
      */
     archiveConversation(id) {
-        return this.simple('GET', 'archive', { id }, ConversationSchema);
+        return this.simple('GET', 'archive', { id }, this.conversationSchema);
     }
     /**
      * Unarchives a conversation.
@@ -109,7 +120,7 @@ export class ConversationsClient extends BaseClient {
      * @returns The updated conversation object.
      */
     unarchiveConversation(id) {
-        return this.simple('GET', 'unarchive', { id }, ConversationSchema);
+        return this.simple('GET', 'unarchive', { id }, this.conversationSchema);
     }
     /**
      * Adds a user to a conversation.
@@ -120,7 +131,7 @@ export class ConversationsClient extends BaseClient {
      * @returns The updated conversation object.
      */
     addUser(args) {
-        return this.simple('POST', 'add_user', { ...args }, ConversationSchema);
+        return this.simple('POST', 'add_user', { ...args }, this.conversationSchema);
     }
     /**
      * Adds multiple users to a conversation.
@@ -136,7 +147,7 @@ export class ConversationsClient extends BaseClient {
      * ```
      */
     addUsers(args) {
-        return this.simple('POST', 'add_users', { ...args }, ConversationSchema);
+        return this.simple('POST', 'add_users', { ...args }, this.conversationSchema);
     }
     /**
      * Removes a user from a conversation.
@@ -147,7 +158,7 @@ export class ConversationsClient extends BaseClient {
      * @returns The updated conversation object.
      */
     removeUser(args) {
-        return this.simple('POST', 'remove_user', { ...args }, ConversationSchema);
+        return this.simple('POST', 'remove_user', { ...args }, this.conversationSchema);
     }
     /**
      * Removes multiple users from a conversation.
@@ -158,7 +169,7 @@ export class ConversationsClient extends BaseClient {
      * @returns The updated conversation object.
      */
     removeUsers(args) {
-        return this.simple('POST', 'remove_users', { ...args }, ConversationSchema);
+        return this.simple('POST', 'remove_users', { ...args }, this.conversationSchema);
     }
     /**
      * Marks a conversation as read.
@@ -215,7 +226,7 @@ export class ConversationsClient extends BaseClient {
      * ```
      */
     muteConversation(args) {
-        return this.simple('GET', 'mute', { ...args }, ConversationSchema);
+        return this.simple('GET', 'mute', { ...args }, this.conversationSchema);
     }
     /**
      * Unmutes a conversation.
@@ -224,7 +235,7 @@ export class ConversationsClient extends BaseClient {
      * @returns The updated conversation object.
      */
     unmuteConversation(id) {
-        return this.simple('GET', 'unmute', { id }, ConversationSchema);
+        return this.simple('GET', 'unmute', { id }, this.conversationSchema);
     }
     simple(httpMethod, suffix, params, schema) {
         return request({

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

@@ -1,9 +1,22 @@
+import { z } from 'zod';
 import { ENDPOINT_INBOX } from '../consts/endpoints.js';
 import { request } from '../transport/http-client.js';
-import { InboxThreadSchema } from '../types/entities.js';
+import { createInboxThreadSchema, InboxThreadSchema } from '../types/entities.js';
 import { BaseClient } from './base-client.js';
+export const InboxThreadListSchema = z.array(InboxThreadSchema);
 /** Client for `/api/v1/inbox/`. */
 export class InboxClient extends BaseClient {
+    constructor() {
+        super(...arguments);
+        this.linkBaseUrl = this.getLinkBaseUrl();
+        // Reuse the shared singletons when no custom base is configured.
+        this.inboxThreadSchema = this.linkBaseUrl
+            ? createInboxThreadSchema(this.linkBaseUrl)
+            : InboxThreadSchema;
+        this.inboxThreadListSchema = this.linkBaseUrl
+            ? z.array(this.inboxThreadSchema)
+            : InboxThreadListSchema;
+    }
     /**
      * Gets inbox items (threads).
      *
@@ -49,7 +62,7 @@ export class InboxClient extends BaseClient {
             apiToken: this.apiToken,
             payload: params,
             customFetch: this.customFetch,
-        }).then((response) => response.data.map((thread) => InboxThreadSchema.parse(thread)));
+        }).then((response) => this.inboxThreadListSchema.parse(response.data));
     }
     /**
      * Gets unread count for inbox.

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

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 import { ENDPOINT_THREADS } from '../consts/endpoints.js';
 import { request } from '../transport/http-client.js';
-import { StatusOkSchema, ThreadSchema, UnreadThreadSchema, } from '../types/entities.js';
+import { CommentSchema, createCommentSchema, createThreadSchema, StatusOkSchema, ThreadSchema, UnreadThreadSchema, } from '../types/entities.js';
 import { resolveCreateId } from '../utils/uuidv7.js';
 import { addCommentRequest } from './add-comment-helper.js';
 import { BaseClient } from './base-client.js';
@@ -16,6 +16,20 @@ const GetUnreadResponseSchema = z.object({
  * `createThread` when the caller doesn't supply one.
  */
 export class ThreadsClient extends BaseClient {
+    constructor() {
+        super(...arguments);
+        this.linkBaseUrl = this.getLinkBaseUrl();
+        // Reuse the shared singletons when no custom base is configured.
+        this.threadSchema = this.linkBaseUrl
+            ? createThreadSchema(this.linkBaseUrl)
+            : ThreadSchema;
+        this.threadListSchema = this.linkBaseUrl
+            ? z.array(this.threadSchema)
+            : ThreadListSchema;
+        this.commentSchema = this.linkBaseUrl
+            ? createCommentSchema(this.linkBaseUrl)
+            : CommentSchema;
+    }
     /**
      * Gets threads. At least one of `channelId` / `workspaceId` is required.
      * `newerThan` / `olderThan` (`Date`) are converted to the
@@ -58,7 +72,7 @@ export class ThreadsClient extends BaseClient {
             apiToken: this.apiToken,
             payload: params,
             customFetch: this.customFetch,
-        }).then((response) => ThreadListSchema.parse(response.data));
+        }).then((response) => this.threadListSchema.parse(response.data));
     }
     /**
      * Gets a single thread object by id.
@@ -67,7 +81,7 @@ export class ThreadsClient extends BaseClient {
      * @returns The thread object.
      */
     getThread(id) {
-        return this.simple('GET', 'getone', { id }, ThreadSchema);
+        return this.simple('GET', 'getone', { id }, this.threadSchema);
     }
     /**
      * Creates a new thread in a channel. `id` is auto-generated if not supplied.
@@ -90,7 +104,7 @@ export class ThreadsClient extends BaseClient {
      * ```
      */
     createThread(args) {
-        return this.simple('POST', 'add', { ...args, id: resolveCreateId(args.id) }, ThreadSchema);
+        return this.simple('POST', 'add', { ...args, id: resolveCreateId(args.id) }, this.threadSchema);
     }
     /**
      * Partial update of an existing thread.
@@ -102,7 +116,7 @@ export class ThreadsClient extends BaseClient {
      * @returns The updated thread object.
      */
     updateThread(args) {
-        return this.simple('POST', 'update', { ...args }, ThreadSchema);
+        return this.simple('POST', 'update', { ...args }, this.threadSchema);
     }
     /**
      * Permanently deletes a thread.
@@ -153,7 +167,7 @@ export class ThreadsClient extends BaseClient {
      * @returns The updated thread object.
      */
     moveToChannel(args) {
-        return this.simple('GET', 'move_to_channel', { ...args }, ThreadSchema);
+        return this.simple('GET', 'move_to_channel', { ...args }, this.threadSchema);
     }
     /**
      * Marks a thread as read.
@@ -241,7 +255,7 @@ export class ThreadsClient extends BaseClient {
      * ```
      */
     muteThread(args) {
-        return this.simple('GET', 'mute', { ...args }, ThreadSchema);
+        return this.simple('GET', 'mute', { ...args }, this.threadSchema);
     }
     /**
      * Unmutes a thread.
@@ -251,7 +265,7 @@ export class ThreadsClient extends BaseClient {
      * @returns The updated thread object.
      */
     unmuteThread(id) {
-        return this.simple('GET', 'unmute', { id }, ThreadSchema);
+        return this.simple('GET', 'unmute', { id }, this.threadSchema);
     }
     /**
      * Closes a thread by adding a comment with a close action.
@@ -311,7 +325,12 @@ export class ThreadsClient extends BaseClient {
     }
     addCommentWithAction(args, threadAction) {
         const { id, ...rest } = args;
-        return addCommentRequest({ baseUri: this.getBaseUri(), apiToken: this.apiToken, customFetch: this.customFetch }, { threadId: id, ...rest }, { threadAction });
+        return addCommentRequest({
+            baseUri: this.getBaseUri(),
+            apiToken: this.apiToken,
+            customFetch: this.customFetch,
+            schema: this.commentSchema,
+        }, { threadId: id, ...rest }, { threadAction });
     }
     simple(httpMethod, suffix, params, schema) {
         return request({

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

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 import { ENDPOINT_WORKSPACES } from '../consts/endpoints.js';
 import { request } from '../transport/http-client.js';
-import { ChannelSchema, WorkspaceSchema } from '../types/entities.js';
+import { ChannelSchema, createChannelSchema, WorkspaceSchema, } from '../types/entities.js';
 import { BaseClient } from './base-client.js';
 export const ChannelListSchema = z.array(ChannelSchema);
 /**
@@ -9,6 +9,14 @@ export const ChannelListSchema = z.array(ChannelSchema);
  * currently rejects any `color` other than `1` on add/update.
  */
 export class WorkspacesClient extends BaseClient {
+    constructor() {
+        super(...arguments);
+        this.linkBaseUrl = this.getLinkBaseUrl();
+        // Reuse the shared singleton when no custom base is configured.
+        this.channelListSchema = this.linkBaseUrl
+            ? z.array(createChannelSchema(this.linkBaseUrl))
+            : ChannelListSchema;
+    }
     /**
      * Gets all the user's workspaces.
      *
@@ -157,6 +165,6 @@ export class WorkspacesClient extends BaseClient {
             apiToken: this.apiToken,
             payload: { id },
             customFetch: this.customFetch,
-        }).then((response) => ChannelListSchema.parse(response.data));
+        }).then((response) => this.channelListSchema.parse(response.data));
     }
 }

package/dist/esm/types/entities.js

@@ -97,8 +97,7 @@ export const WorkspaceSchema = z.object({
         .optional(),
     plan: z.string().nullable().optional(),
 });
-export const ChannelSchema = z
-    .object({
+export const ChannelObjectSchema = z.object({
     id: z.string(),
     name: z.string(),
     description: z.string().nullable().optional(),
@@ -116,15 +115,17 @@ export const ChannelSchema = z
     icon: z.number().nullable().optional(),
     version: z.number(),
     filters: z.record(z.string(), z.string()).nullable().optional(),
-})
-    .transform((data) => ({
-    ...data,
-    url: getFullCommsURL({ workspaceId: data.workspaceId, channelId: data.id }),
-}));
+});
+export function createChannelSchema(linkBaseUrl) {
+    return ChannelObjectSchema.transform((data) => ({
+        ...data,
+        url: getFullCommsURL({ workspaceId: data.workspaceId, channelId: data.id }, linkBaseUrl),
+    }));
+}
+export const ChannelSchema = createChannelSchema();
 // Thread entity from API. `pinned` (boolean) and `pinnedTs` (epoch ms or
 // null) are both surfaced — `pinned` is kept for Zapier/webhook clients.
-export const ThreadSchema = z
-    .object({
+export const ThreadObjectSchema = z.object({
     id: z.string(),
     title: z.string(),
     content: z.string(),
@@ -188,15 +189,18 @@ export const ThreadSchema = z
     })
         .nullable()
         .optional(),
-})
-    .transform((data) => ({
-    ...data,
-    url: getFullCommsURL({
-        workspaceId: data.workspaceId,
-        channelId: data.channelId,
-        threadId: data.id,
-    }),
-}));
+});
+export function createThreadSchema(linkBaseUrl) {
+    return ThreadObjectSchema.transform((data) => ({
+        ...data,
+        url: getFullCommsURL({
+            workspaceId: data.workspaceId,
+            channelId: data.channelId,
+            threadId: data.id,
+        }, linkBaseUrl),
+    }));
+}
+export const ThreadSchema = createThreadSchema();
 // Group entity from API. The broadcast markers `EVERYONE` and
 // `EVERYONE_IN_THREAD` can appear in place of a real `id` in group-bearing
 // fields on threads/comments/channels.
@@ -209,8 +213,7 @@ export const GroupSchema = z.object({
     version: z.number(),
 });
 // Conversation entity from API.
-export const ConversationSchema = z
-    .object({
+export const ConversationObjectSchema = z.object({
     id: z.string(),
     workspaceId: z.number(),
     userIds: z.array(z.number()),
@@ -247,13 +250,15 @@ export const ConversationSchema = z
     })
         .nullable()
         .optional(),
-})
-    .transform((data) => ({
-    ...data,
-    url: getFullCommsURL({ workspaceId: data.workspaceId, conversationId: data.id }),
-}));
-export const CommentSchema = z
-    .object({
+});
+export function createConversationSchema(linkBaseUrl) {
+    return ConversationObjectSchema.transform((data) => ({
+        ...data,
+        url: getFullCommsURL({ workspaceId: data.workspaceId, conversationId: data.id }, linkBaseUrl),
+    }));
+}
+export const ConversationSchema = createConversationSchema();
+export const CommentObjectSchema = z.object({
     id: z.string(),
     content: z.string(),
     creator: z.number(),
@@ -277,16 +282,19 @@ export const CommentSchema = z
     deletedBy: z.number().nullable().optional(),
     version: z.number().nullable().optional(),
     actions: z.array(z.unknown()).nullable().optional(),
-})
-    .transform((data) => ({
-    ...data,
-    url: getFullCommsURL({
-        workspaceId: data.workspaceId,
-        channelId: data.channelId,
-        threadId: data.threadId,
-        commentId: data.id,
-    }),
-}));
+});
+export function createCommentSchema(linkBaseUrl) {
+    return CommentObjectSchema.transform((data) => ({
+        ...data,
+        url: getFullCommsURL({
+            workspaceId: data.workspaceId,
+            channelId: data.channelId,
+            threadId: data.threadId,
+            commentId: data.id,
+        }, linkBaseUrl),
+    }));
+}
+export const CommentSchema = createCommentSchema();
 export const WorkspaceUserSchema = BaseUserSchema.extend({
     email: z.string().nullable().optional(),
     userType: z.enum(USER_TYPES),
@@ -299,8 +307,7 @@ export const WorkspaceUserSchema = BaseUserSchema.extend({
 // (coerced to a string post-parse) because the backend currently emits
 // either shape depending on the endpoint; the URL/reaction helpers accept
 // both.
-export const ConversationMessageSchema = z
-    .object({
+export const ConversationMessageObjectSchema = z.object({
     id: z.union([z.string(), z.number()]).transform(String),
     content: z.string(),
     creator: z.number(),
@@ -317,65 +324,72 @@ export const ConversationMessageSchema = z
     directMentions: z.array(z.number()).nullable().optional(),
     version: z.number().nullable().optional(),
     workspaceId: z.number(),
-})
-    .transform((data) => ({
-    ...data,
-    url: getFullCommsURL({
-        workspaceId: data.workspaceId,
-        conversationId: data.conversationId,
-        messageId: data.id,
-    }),
-}));
+});
+export function createConversationMessageSchema(linkBaseUrl) {
+    return ConversationMessageObjectSchema.transform((data) => ({
+        ...data,
+        url: getFullCommsURL({
+            workspaceId: data.workspaceId,
+            conversationId: data.conversationId,
+            messageId: data.id,
+        }, linkBaseUrl),
+    }));
+}
+export const ConversationMessageSchema = createConversationMessageSchema();
 // InboxThread entity from API - returns full Thread objects with additional inbox metadata.
-export const InboxThreadSchema = z
-    .object({
-    id: z.string(),
-    title: z.string(),
-    content: z.string(),
-    creator: z.number(),
-    creatorName: z.string().nullable().optional(),
-    channelId: z.string(),
-    workspaceId: z.number(),
-    actions: z.array(z.unknown()).nullable().optional(),
-    attachments: z.array(AttachmentSchema).nullable().optional(),
-    commentCount: z.number(),
-    directGroupMentions: z.array(z.string()).nullable().optional(),
-    directMentions: z.array(z.number()).nullable().optional(),
-    groups: z.array(z.string()).nullable().optional(),
-    lastEdited: z.date().nullable().optional(),
-    lastObjIndex: z.number().nullable().optional(),
-    lastUpdated: z.date(),
-    mutedUntil: z.date().nullable().optional(),
-    participants: z.array(z.number()).nullable().optional(),
-    // Backend wire shape only includes `pinned_ts` (epoch ms or null);
-    // derive `pinned` from `pinnedTs != null` if you need a bool.
-    pinned: z.boolean().optional(),
-    pinnedTs: z.number().int().nullable().optional(),
-    posted: z.date(),
-    reactions: z.record(z.string(), z.array(z.number())).nullable().optional(),
-    recipients: z.array(z.number()).nullable().optional(),
-    snippet: z.string(),
-    snippetCreator: z.number(),
-    snippetMaskAvatarUrl: z.string().nullable().optional(),
-    snippetMaskPoster: z.string().nullable().optional(),
-    systemMessage: SystemMessageSchema,
-    isArchived: z.boolean(),
-    inInbox: z.boolean(),
-    isSaved: z.boolean().nullable().optional(),
-    closed: z.boolean(),
-    responders: z.array(z.number()).nullable().optional(),
-    lastComment: CommentSchema.nullable().optional(),
-    toEmails: z.array(z.string()).nullable().optional(),
-    version: z.number().nullable().optional(),
-})
-    .transform((data) => ({
-    ...data,
-    url: getFullCommsURL({
-        workspaceId: data.workspaceId,
-        channelId: data.channelId,
-        threadId: data.id,
-    }),
-}));
+export function createInboxThreadObjectSchema(linkBaseUrl) {
+    return z.object({
+        id: z.string(),
+        title: z.string(),
+        content: z.string(),
+        creator: z.number(),
+        creatorName: z.string().nullable().optional(),
+        channelId: z.string(),
+        workspaceId: z.number(),
+        actions: z.array(z.unknown()).nullable().optional(),
+        attachments: z.array(AttachmentSchema).nullable().optional(),
+        commentCount: z.number(),
+        directGroupMentions: z.array(z.string()).nullable().optional(),
+        directMentions: z.array(z.number()).nullable().optional(),
+        groups: z.array(z.string()).nullable().optional(),
+        lastEdited: z.date().nullable().optional(),
+        lastObjIndex: z.number().nullable().optional(),
+        lastUpdated: z.date(),
+        mutedUntil: z.date().nullable().optional(),
+        participants: z.array(z.number()).nullable().optional(),
+        // Backend wire shape only includes `pinned_ts` (epoch ms or null);
+        // derive `pinned` from `pinnedTs != null` if you need a bool.
+        pinned: z.boolean().optional(),
+        pinnedTs: z.number().int().nullable().optional(),
+        posted: z.date(),
+        reactions: z.record(z.string(), z.array(z.number())).nullable().optional(),
+        recipients: z.array(z.number()).nullable().optional(),
+        snippet: z.string(),
+        snippetCreator: z.number(),
+        snippetMaskAvatarUrl: z.string().nullable().optional(),
+        snippetMaskPoster: z.string().nullable().optional(),
+        systemMessage: SystemMessageSchema,
+        isArchived: z.boolean(),
+        inInbox: z.boolean(),
+        isSaved: z.boolean().nullable().optional(),
+        closed: z.boolean(),
+        responders: z.array(z.number()).nullable().optional(),
+        lastComment: createCommentSchema(linkBaseUrl).nullable().optional(),
+        toEmails: z.array(z.string()).nullable().optional(),
+        version: z.number().nullable().optional(),
+    });
+}
+export function createInboxThreadSchema(linkBaseUrl) {
+    return createInboxThreadObjectSchema(linkBaseUrl).transform((data) => ({
+        ...data,
+        url: getFullCommsURL({
+            workspaceId: data.workspaceId,
+            channelId: data.channelId,
+            threadId: data.id,
+        }, linkBaseUrl),
+    }));
+}
+export const InboxThreadSchema = createInboxThreadSchema();
 // UnreadThread entity from API - simplified thread reference.
 export const UnreadThreadSchema = z.object({
     threadId: z.string(),

package/dist/esm/utils/url-helpers.js

@@ -45,7 +45,9 @@ export function getCommsURL(params) {
  * @param baseUrl - Optional base URL (defaults to 'https://comms.todoist.com')
  */
 export function getFullCommsURL(params, baseUrl = COMMS_BASE_URL) {
-    return `${baseUrl}${getCommsURL(params)}`;
+    // Strip a trailing slash so links don't double up — `getCommsURL` paths start with '/'.
+    const normalizedBase = baseUrl.endsWith('/') ? baseUrl.slice(0, -1) : baseUrl;
+    return `${normalizedBase}${getCommsURL(params)}`;
 }
 /** Returns the URL for a thread in a channel. */
 export function getThreadURL(params) {

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

@@ -1,10 +1,12 @@
-import { type Comment } from '../types/entities.js';
+import { type Comment, type createCommentSchema } from '../types/entities.js';
 import type { CustomFetch } from '../types/http.js';
 import type { CreateCommentArgs, ThreadAction } from '../types/requests.js';
 type ClientContext = {
     baseUri: string;
     apiToken: string;
     customFetch?: CustomFetch;
+    /** Per-client Comment schema, base-bound for the returned comment's web `url`. */
+    schema: ReturnType<typeof createCommentSchema>;
 };
 /**
  * Internal helper that powers `comments.createComment`,

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

@@ -25,4 +25,10 @@ export declare class BaseClient {
      * slash so relative paths resolve cleanly through `URL`.
      */
     protected getBaseUri(): string;
+    /**
+     * Base URL for entity web links, or `undefined` to use getFullCommsURL's
+     * default web app. Trailing-slash normalization happens in
+     * `getFullCommsURL`, so the configured value is returned verbatim.
+     */
+    protected getLinkBaseUrl(): string | undefined;
 }

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

@@ -64,6 +64,9 @@ export declare const ChannelListSchema: z.ZodArray<z.ZodPipe<z.ZodObject<{
  * to keep an optimistic-UI ID stable through the round-trip.
  */
 export declare class ChannelsClient extends BaseClient {
+    private readonly linkBaseUrl;
+    private readonly channelSchema;
+    private readonly channelListSchema;
     /**
      * Gets all channels for a given workspace.
      *

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

@@ -134,6 +134,10 @@ export declare const CommentListSchema: z.ZodArray<z.ZodPipe<z.ZodObject<{
  * on `createComment` when the caller doesn't supply one.
  */
 export declare class CommentsClient extends BaseClient {
+    private readonly linkBaseUrl;
+    private readonly commentSchema;
+    private readonly commentListSchema;
+    private readonly wrappedCommentSchema;
     /**
      * Gets all comments for a thread. `newerThan` / `olderThan` (`Date`) are
      * converted to `newer_than_ts` / `older_than_ts` epoch seconds on the

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

@@ -113,6 +113,9 @@ export declare const ConversationMessageListSchema: z.ZodArray<z.ZodPipe<z.ZodOb
  * message `id` on `createMessage` when the caller doesn't supply one.
  */
 export declare class ConversationMessagesClient extends BaseClient {
+    private readonly linkBaseUrl;
+    private readonly messageSchema;
+    private readonly messageListSchema;
     /**
      * Gets all messages in a conversation.
      *

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

@@ -163,6 +163,9 @@ export declare const ConversationListSchema: z.ZodArray<z.ZodPipe<z.ZodObject<{
  * already-assigned `id` and your generated one is silently dropped.
  */
 export declare class ConversationsClient extends BaseClient {
+    private readonly linkBaseUrl;
+    private readonly conversationSchema;
+    private readonly conversationListSchema;
     /**
      * Gets all conversations for a workspace.
      *