@doist/comms-sdk 2.0.2 → 3.0.0

package/dist/cjs/types/requests.js

@@ -1,183 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.THREAD_ACTIONS = exports.UnsubscribeHookArgsSchema = exports.SubscribeHookArgsSchema = exports.SubscribeMessageHookArgsSchema = exports.SubscribeNonMessageHookArgsSchema = exports.SubscribeHookArgsBaseSchema = exports.HookTargetUrlSchema = exports.HookEventSchema = exports.MessageHookEventSchema = exports.NonMessageHookEventSchema = exports.HOOK_EVENTS = exports.MESSAGE_HOOK_EVENTS = exports.NON_MESSAGE_HOOK_EVENTS = exports.ARCHIVE_FILTER_VALUES = 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;
-const zod_1 = require("zod");
-const entities_1 = require("./entities");
-const enums_1 = require("./enums");
-/**
- * Create-side requests require an `id` on the wire. The SDK clients accept
- * `id` as optional and auto-generate one via
- * {@link import('../utils/uuidv7').generateId} when the caller doesn't pass
- * one — callers can still mint their own ID locally (e.g. for optimistic
- * UI) and have it stick.
- */
-exports.CreateChannelArgsSchema = zod_1.z.object({
-    workspaceId: zod_1.z.number(),
-    name: zod_1.z.string(),
-    id: zod_1.z.string().optional(),
-    userIds: zod_1.z.array(zod_1.z.number()).nullable().optional(),
-    color: zod_1.z.number().nullable().optional(),
-    public: zod_1.z.boolean().nullable().optional(),
-    description: zod_1.z.string().nullable().optional(),
-    defaultGroups: zod_1.z.array(zod_1.z.string()).nullable().optional(),
-    defaultRecipients: zod_1.z.array(zod_1.z.number()).nullable().optional(),
-    isFavorited: zod_1.z.boolean().nullable().optional(),
-    icon: zod_1.z.number().nullable().optional(),
-});
-exports.UpdateChannelArgsSchema = zod_1.z.object({
-    id: zod_1.z.string(),
-    name: zod_1.z.string(),
-    color: zod_1.z.number().nullable().optional(),
-    public: zod_1.z.boolean().nullable().optional(),
-    description: zod_1.z.string().nullable().optional(),
-    defaultGroups: zod_1.z.array(zod_1.z.string()).nullable().optional(),
-    defaultRecipients: zod_1.z.array(zod_1.z.number()).nullable().optional(),
-    isFavorited: zod_1.z.boolean().nullable().optional(),
-    icon: zod_1.z.number().nullable().optional(),
-});
-exports.CreateThreadArgsSchema = zod_1.z.object({
-    channelId: zod_1.z.string(),
-    content: zod_1.z.string(),
-    title: zod_1.z.string().nullable().optional(),
-    id: zod_1.z.string().optional(),
-    recipients: zod_1.z.array(zod_1.z.number()).nullable().optional(),
-    groups: zod_1.z.array(zod_1.z.string()).nullable().optional(),
-    notifyAudience: zod_1.z.enum(enums_1.NOTIFY_AUDIENCES).nullable().optional(),
-    attachments: zod_1.z.array(entities_1.RequestAttachmentSchema).nullable().optional(),
-});
-exports.UpdateThreadArgsSchema = zod_1.z.object({
-    id: zod_1.z.string(),
-    title: zod_1.z.string().nullable().optional(),
-    content: zod_1.z.string().nullable().optional(),
-});
-exports.CreateCommentArgsSchema = zod_1.z.object({
-    threadId: zod_1.z.string(),
-    content: zod_1.z.string(),
-    id: zod_1.z.string().optional(),
-    attachments: zod_1.z.array(entities_1.RequestAttachmentSchema).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.string()).nullable().optional(),
-    directMentions: zod_1.z.array(zod_1.z.number()).nullable().optional(),
-    directGroupMentions: zod_1.z.array(zod_1.z.string()).nullable().optional(),
-    notifyAudience: zod_1.z.enum(enums_1.NOTIFY_AUDIENCES).nullable().optional(),
-});
-exports.UpdateCommentArgsSchema = zod_1.z.object({
-    id: zod_1.z.string(),
-    content: zod_1.z.string(),
-});
-exports.CreateConversationArgsSchema = zod_1.z.object({
-    workspaceId: zod_1.z.number(),
-    recipients: zod_1.z.array(zod_1.z.number()),
-    id: zod_1.z.string().optional(),
-    title: zod_1.z.string().nullable().optional(),
-});
-exports.CreateMessageArgsSchema = zod_1.z
-    .object({
-    conversationId: zod_1.z.string().nullable().optional(),
-    threadId: zod_1.z.string().nullable().optional(),
-    content: zod_1.z.string(),
-    id: zod_1.z.string().optional(),
-    attachments: zod_1.z.array(entities_1.RequestAttachmentSchema).nullable().optional(),
-})
-    .refine((data) => {
-    return ((data.conversationId && !data.threadId) || (!data.conversationId && data.threadId));
-}, {
-    message: 'Exactly one of conversationId or threadId must be provided',
-});
-exports.GetChannelsArgsSchema = zod_1.z.object({
-    workspaceId: zod_1.z.number(),
-    archived: zod_1.z.boolean().nullable().optional(),
-});
-exports.GetThreadsArgsSchema = zod_1.z.object({
-    workspaceId: zod_1.z.number(),
-    channelId: zod_1.z.string().nullable().optional(),
-    archived: zod_1.z.boolean().nullable().optional(),
-    newerThan: zod_1.z.date().nullable().optional(),
-    olderThan: zod_1.z.date().nullable().optional(),
-    limit: zod_1.z.number().nullable().optional(),
-});
-exports.GetCommentsArgsSchema = zod_1.z.object({
-    threadId: zod_1.z.string(),
-    newerThan: zod_1.z.date().nullable().optional(),
-    olderThan: zod_1.z.date().nullable().optional(),
-    limit: zod_1.z.number().nullable().optional(),
-});
-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(),
-    userIds: zod_1.z.array(zod_1.z.number()),
-    id: zod_1.z.string().optional(),
-});
-// Inbox
-exports.ARCHIVE_FILTER_VALUES = ['active', 'archived', 'all'];
-// Hooks
-exports.NON_MESSAGE_HOOK_EVENTS = [
-    'workspace_added',
-    'workspace_updated',
-    'workspace_deleted',
-    'workspace_user_added',
-    'workspace_user_updated',
-    'workspace_user_removed',
-    'channel_added',
-    'channel_updated',
-    'channel_deleted',
-    'channel_user_added',
-    'channel_user_removed',
-    'thread_added',
-    'thread_updated',
-    'thread_deleted',
-    'comment_added',
-    'comment_updated',
-    'comment_deleted',
-    'group_added',
-    'group_updated',
-    'group_deleted',
-    'group_user_added',
-    'group_user_removed',
-];
-exports.MESSAGE_HOOK_EVENTS = ['message_added', 'message_updated'];
-exports.HOOK_EVENTS = [...exports.NON_MESSAGE_HOOK_EVENTS, ...exports.MESSAGE_HOOK_EVENTS];
-exports.NonMessageHookEventSchema = zod_1.z.enum(exports.NON_MESSAGE_HOOK_EVENTS);
-exports.MessageHookEventSchema = zod_1.z.enum(exports.MESSAGE_HOOK_EVENTS);
-exports.HookEventSchema = zod_1.z.enum(exports.HOOK_EVENTS);
-exports.HookTargetUrlSchema = zod_1.z
-    .url()
-    .max(150)
-    .refine((value) => {
-    try {
-        return new URL(value).protocol === 'https:';
-    }
-    catch {
-        return false;
-    }
-}, { message: 'URL must use HTTPS' });
-exports.SubscribeHookArgsBaseSchema = zod_1.z.object({
-    targetUrl: exports.HookTargetUrlSchema,
-    workspaceId: zod_1.z.number().nullable().optional(),
-    channelId: zod_1.z.string().nullable().optional(),
-    threadId: zod_1.z.string().nullable().optional(),
-});
-exports.SubscribeNonMessageHookArgsSchema = exports.SubscribeHookArgsBaseSchema.extend({
-    event: exports.NonMessageHookEventSchema,
-    conversationId: zod_1.z.never().optional(),
-});
-exports.SubscribeMessageHookArgsSchema = exports.SubscribeHookArgsBaseSchema.extend({
-    event: exports.MessageHookEventSchema,
-    conversationId: zod_1.z.string().nullable().optional(),
-});
-exports.SubscribeHookArgsSchema = zod_1.z.union([
-    exports.SubscribeNonMessageHookArgsSchema,
-    exports.SubscribeMessageHookArgsSchema,
-]);
-exports.UnsubscribeHookArgsSchema = zod_1.z.object({
-    targetUrl: exports.HookTargetUrlSchema,
-});
-// Threads
-exports.THREAD_ACTIONS = ['close', 'reopen'];

package/dist/cjs/utils/case-conversion.js

@@ -1,54 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.camelCaseKeys = camelCaseKeys;
-exports.snakeCaseKeys = snakeCaseKeys;
-const camelcase_1 = __importDefault(require("camelcase"));
-function isObject(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
-function isArray(value) {
-    return Array.isArray(value);
-}
-function toSnakeCase(str) {
-    return str
-        .replace(/([A-Z])/g, '_$1')
-        .toLowerCase()
-        .replace(/^_/, '');
-}
-/**
- * @internal
- */
-function camelCaseKeys(obj) {
-    if (isArray(obj)) {
-        return obj.map(camelCaseKeys);
-    }
-    if (isObject(obj)) {
-        const result = {};
-        for (const [key, value] of Object.entries(obj)) {
-            const camelKey = (0, camelcase_1.default)(key);
-            result[camelKey] = camelCaseKeys(value);
-        }
-        return result;
-    }
-    return obj;
-}
-/**
- * @internal
- */
-function snakeCaseKeys(obj) {
-    if (isArray(obj)) {
-        return obj.map(snakeCaseKeys);
-    }
-    if (isObject(obj)) {
-        const result = {};
-        for (const [key, value] of Object.entries(obj)) {
-            const snakeKey = toSnakeCase(key);
-            result[snakeKey] = snakeCaseKeys(value);
-        }
-        return result;
-    }
-    return obj;
-}

package/dist/cjs/utils/index.js

@@ -1,19 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./case-conversion"), exports);
-__exportStar(require("./url-helpers"), exports);
-__exportStar(require("./uuidv7"), exports);

package/dist/cjs/utils/multipart-upload.js

@@ -1,202 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getContentTypeFromFileName = getContentTypeFromFileName;
-exports.uploadMultipartFile = uploadMultipartFile;
-const uuid_1 = require("uuid");
-const fetch_with_retry_1 = require("../transport/fetch-with-retry");
-/**
- * Determine a content-type from a filename extension. Falls back to
- * `application/octet-stream` for unknown extensions.
- */
-function getContentTypeFromFileName(fileName) {
-    const extension = fileName.toLowerCase().split('.').pop();
-    return extension ? (MIME_BY_EXTENSION[extension] ?? DEFAULT_MIME_TYPE) : DEFAULT_MIME_TYPE;
-}
-const DEFAULT_MIME_TYPE = 'application/octet-stream';
-/**
- * Extension → MIME map covering the formats commonly attached to messages.
- * Anything not listed falls back to {@link DEFAULT_MIME_TYPE}; callers can
- * always override via the `contentType` argument.
- */
-const MIME_BY_EXTENSION = {
-    // Images
-    png: 'image/png',
-    jpg: 'image/jpeg',
-    jpeg: 'image/jpeg',
-    gif: 'image/gif',
-    webp: 'image/webp',
-    svg: 'image/svg+xml',
-    bmp: 'image/bmp',
-    ico: 'image/x-icon',
-    tif: 'image/tiff',
-    tiff: 'image/tiff',
-    heic: 'image/heic',
-    heif: 'image/heif',
-    avif: 'image/avif',
-    // Documents / text
-    pdf: 'application/pdf',
-    txt: 'text/plain',
-    md: 'text/markdown',
-    csv: 'text/csv',
-    json: 'application/json',
-    xml: 'application/xml',
-    html: 'text/html',
-    htm: 'text/html',
-    rtf: 'application/rtf',
-    doc: 'application/msword',
-    docx: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
-    xls: 'application/vnd.ms-excel',
-    xlsx: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
-    ppt: 'application/vnd.ms-powerpoint',
-    pptx: 'application/vnd.openxmlformats-officedocument.presentationml.presentation',
-    // Archives
-    zip: 'application/zip',
-    gz: 'application/gzip',
-    tar: 'application/x-tar',
-    '7z': 'application/x-7z-compressed',
-    rar: 'application/vnd.rar',
-    // Audio
-    mp3: 'audio/mpeg',
-    wav: 'audio/wav',
-    ogg: 'audio/ogg',
-    m4a: 'audio/mp4',
-    flac: 'audio/flac',
-    aac: 'audio/aac',
-    // Video
-    mp4: 'video/mp4',
-    m4v: 'video/mp4',
-    mov: 'video/quicktime',
-    avi: 'video/x-msvideo',
-    webm: 'video/webm',
-    mkv: 'video/x-matroska',
-};
-/**
- * Normalise a supported {@link UploadFile} into a `Blob` plus a resolved file name and
- * content type, ready to be encoded into the multipart body.
- */
-function toBlob(file, fileName, contentType) {
-    if (file instanceof Blob) {
-        // Duck-type the name rather than `instanceof File`: `File` isn't a global in
-        // Node 18, so a `node:buffer` `File` (which carries a real `name`) would
-        // otherwise fall back to `'upload'` and lose its inferred file name.
-        const blobName = file.name;
-        const name = fileName || (typeof blobName === 'string' ? blobName : undefined) || 'upload';
-        const type = contentType || file.type || getContentTypeFromFileName(name);
-        // Re-wrap only when stamping a type the Blob doesn't already carry.
-        const blob = file.type === type ? file : new Blob([file], { type });
-        return { blob, fileName: name, contentType: type };
-    }
-    if (file instanceof Uint8Array) {
-        if (!fileName) {
-            throw new Error('fileName is required when uploading raw bytes');
-        }
-        const type = contentType || getContentTypeFromFileName(fileName);
-        // `Blob` accepts any `ArrayBufferView`; the cast satisfies the stricter lib
-        // `BlobPart` type (which pins the backing buffer to `ArrayBuffer`).
-        return { blob: new Blob([file], { type }), fileName, contentType: type };
-    }
-    throw new Error('Unsupported file type for upload: expected a Blob or Uint8Array');
-}
-/**
- * Escapes a value for use inside a quoted `Content-Disposition` parameter, where a raw
- * quote would end the value early and a raw CR or LF would end the header. A lone CR
- * needs escaping too, not just CRLF pairs.
- *
- * This is the same escaping the platform's own `FormData` encoder applies, so servers
- * see exactly what they would from any browser.
- */
-function escapeDispositionValue(value) {
-    return value.replace(/"/g, '%22').replace(/\r/g, '%0D').replace(/\n/g, '%0A');
-}
-/**
- * Rejects a media type that could not be safely written into a part header.
- *
- * `contentType` is public caller input and reaches the header verbatim. A value
- * carrying a CR or LF would end the header early and let the caller forge one
- * of its own — `Blob` normalises the `type` it stores, but the supplied value
- * is what gets interpolated. Reject rather than silently rewrite, so a caller
- * passing something unusable finds out instead of having it altered.
- */
-function assertHeaderSafeContentType(contentType) {
-    if (!/^[\x20-\x7e]*$/.test(contentType)) {
-        throw new Error('contentType must contain only printable ASCII characters, without CR or LF');
-    }
-}
-/**
- * Encodes a `multipart/form-data` body as a `Blob`, together with the `Content-Type`
- * that describes it.
- *
- * Deliberately avoids `FormData`. A `FormData` body is only encoded by the `fetch` that
- * owns that `FormData` class — undici brands its own and checks it with a plain
- * `instanceof` — and the SDK dispatches through undici's own `fetch` to keep the request
- * client on the same undici as the dispatcher. A global `FormData` handed to it is
- * stringified to the literal `"[object FormData]"`, so the upload silently carries no
- * file. `Blob` has no such brand and works with whichever `fetch` sends the request,
- * including a caller-supplied `customFetch`.
- */
-function buildMultipartBody(args) {
-    const { blob, fileName, contentType, fields } = args;
-    assertHeaderSafeContentType(contentType);
-    const boundary = `----comms-sdk-${(0, uuid_1.v4)()}`;
-    const parts = [
-        `--${boundary}\r\n` +
-            `Content-Disposition: form-data; name="file"; filename="${escapeDispositionValue(fileName)}"\r\n` +
-            `Content-Type: ${contentType}\r\n\r\n`,
-        blob,
-        '\r\n',
-    ];
-    for (const [key, value] of Object.entries(fields)) {
-        if (value !== undefined && value !== null) {
-            parts.push(`--${boundary}\r\n` +
-                `Content-Disposition: form-data; name="${escapeDispositionValue(key)}"\r\n\r\n` +
-                `${String(value)}\r\n`);
-        }
-    }
-    parts.push(`--${boundary}--\r\n`);
-    return { body: new Blob(parts), contentType: `multipart/form-data; boundary=${boundary}` };
-}
-/**
- * Upload a file using `multipart/form-data`.
- *
- * Encodes the request body as a `Blob` so it works unchanged in the browser and in
- * Node.js, whichever `fetch` ends up sending it. The `file` part is sent alongside `file_name`,
- * `file_size`, and `underlying_type` fields (the canonical Comms upload shape); any
- * `additionalFields` are merged in and override the derived values. Authentication uses
- * `Authorization: Bearer`, matching every other Comms SDK client.
- *
- * The response is JSON-parsed and camel-cased by {@link fetchWithRetry}; callers validate
- * the returned shape with the appropriate schema.
- */
-async function uploadMultipartFile(args) {
-    const { baseUrl, authToken, endpoint, file, fileName, contentType, additionalFields, maxRetries = 0, requestId, customFetch, } = args;
-    const { blob, fileName: resolvedFileName, contentType: resolvedType, } = toBlob(file, fileName, contentType);
-    const fields = {
-        file_name: resolvedFileName,
-        file_size: blob.size,
-        underlying_type: resolvedType,
-        ...additionalFields,
-    };
-    const multipart = buildMultipartBody({
-        blob,
-        fileName: resolvedFileName,
-        contentType: resolvedType,
-        fields,
-    });
-    const headers = {
-        Authorization: `Bearer ${authToken}`,
-        // The boundary is ours, so this has to be declared explicitly — `fetch`
-        // only fills it in for a `FormData` body.
-        'Content-Type': multipart.contentType,
-    };
-    if (requestId) {
-        headers['X-Request-Id'] = requestId;
-    }
-    const url = new URL(endpoint, baseUrl).toString();
-    const response = await (0, fetch_with_retry_1.fetchWithRetry)(url, {
-        method: 'POST',
-        headers,
-        body: multipart.body,
-        timeout: 30000,
-    }, maxRetries, customFetch);
-    return response.data;
-}

package/dist/cjs/utils/timestamp-conversion.js

@@ -1,58 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.timestampToDate = timestampToDate;
-exports.transformTimestamps = transformTimestamps;
-/**
- * Converts a Unix timestamp (in seconds) to a Date object.
- * @param timestamp - Unix timestamp in seconds
- * @returns Date object
- */
-function timestampToDate(timestamp) {
-    return new Date(timestamp * 1000);
-}
-const timestampFieldTargetOverrides = new Map([['pinnedTs', 'pinnedDate']]);
-/**
- * Recursively transforms timestamp fields (ending in 'Ts') in an object to Date objects.
- * Also renames converted fields by removing the 'Ts' suffix.
- * @param obj - The object to transform
- * @returns The transformed object with Date fields
- */
-function transformTimestamps(obj) {
-    if (obj === null || obj === undefined) {
-        return obj;
-    }
-    if (Array.isArray(obj)) {
-        return obj.map((item) => transformTimestamps(item));
-    }
-    if (typeof obj === 'object') {
-        const result = {};
-        for (const [key, value] of Object.entries(obj)) {
-            // Check if the key ends with 'Ts'
-            if (key.endsWith('Ts')) {
-                const overriddenTargetKey = timestampFieldTargetOverrides.get(key);
-                if (typeof value === 'number') {
-                    // Remove 'Ts' suffix and convert to Date
-                    const newKey = key.slice(0, -2);
-                    // If the base key already exists in the original object, use *Date suffix
-                    // to avoid overwriting it (e.g. posted + postedTs → posted + postedDate)
-                    const targetKey = overriddenTargetKey ??
-                        (newKey in obj ? `${newKey}Date` : newKey);
-                    result[targetKey] = timestampToDate(value);
-                    continue;
-                }
-                if (overriddenTargetKey) {
-                    result[overriddenTargetKey] = value;
-                    continue;
-                }
-            }
-            if (typeof value === 'object' && value !== null) {
-                // Recursively transform nested objects
-                result[key] = transformTimestamps(value);
-                continue;
-            }
-            result[key] = value;
-        }
-        return result;
-    }
-    return obj;
-}

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

@@ -1,133 +0,0 @@
-"use strict";
-/**
- * Helper functions for creating Comms permalinks (`https://comms.todoist.com/...`).
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getCommsURL = getCommsURL;
-exports.getFullCommsURL = getFullCommsURL;
-exports.getThreadURL = getThreadURL;
-exports.getChannelURL = getChannelURL;
-exports.getConversationURL = getConversationURL;
-exports.getMessageURL = getMessageURL;
-exports.getCommentURL = getCommentURL;
-exports.getThreadsRootURL = getThreadsRootURL;
-exports.getInboxURL = getInboxURL;
-exports.getMessagesRootURL = getMessagesRootURL;
-exports.getUserProfileURL = getUserProfileURL;
-exports.getSavedThreadsRootURL = getSavedThreadsRootURL;
-exports.getSavedThreadURL = getSavedThreadURL;
-exports.getSearchRootURL = getSearchRootURL;
-exports.getSearchQueryURL = getSearchQueryURL;
-exports.getSettingsURL = getSettingsURL;
-exports.getTeamMembersRootURL = getTeamMembersRootURL;
-const COMMS_BASE_URL = 'https://comms.todoist.com';
-/**
- * Builds a relative Comms URL based on the provided parameters
- * @param params - URL parameters including workspace, channel, conversation, thread, etc.
- * @returns A relative URL path
- * @example
- * getCommsURL({ workspaceId: 1, channelId: '7Yp...', threadId: '7Yq...' })
- * // returns '/1/ch/7Yp.../t/7Yq.../'
- */
-function getCommsURL(params) {
-    const { workspaceId, channelId, conversationId, threadId, commentId, messageId, userId } = params;
-    let url = `/${workspaceId}/`;
-    if (channelId) {
-        url += `ch/${channelId}/`;
-        if (threadId) {
-            url += `t/${threadId}/`;
-            if (commentId) {
-                url += `c/${commentId}`;
-            }
-        }
-    }
-    else if (threadId) {
-        url += `inbox/t/${threadId}/`;
-        if (commentId) {
-            url += `c/${commentId}`;
-        }
-    }
-    else if (conversationId) {
-        url += `msg/${conversationId}/`;
-        if (messageId) {
-            url += `m/${messageId}`;
-        }
-    }
-    else if (userId) {
-        url += `people/u/${userId}`;
-    }
-    return url;
-}
-/**
- * Builds a full Comms URL (with protocol and hostname) based on the provided parameters
- * @param params - URL parameters including workspace, channel, conversation, thread, etc.
- * @param baseUrl - Optional base URL (defaults to 'https://comms.todoist.com')
- */
-function getFullCommsURL(params, baseUrl = COMMS_BASE_URL) {
-    // 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. */
-function getThreadURL(params) {
-    return getCommsURL(params);
-}
-/** Returns the URL for a channel. */
-function getChannelURL(params) {
-    return getCommsURL(params);
-}
-/** Returns the URL for a conversation. */
-function getConversationURL(params) {
-    return getCommsURL(params);
-}
-/** Returns the URL for a specific message in a conversation. */
-function getMessageURL(params) {
-    return getCommsURL(params);
-}
-/** Returns the URL for a comment in a thread. */
-function getCommentURL(params) {
-    return getCommsURL(params);
-}
-/** Returns the URL for the threads root (channels view). */
-function getThreadsRootURL(workspaceId) {
-    return `/${workspaceId}/ch`;
-}
-/** Returns the URL for the inbox. */
-function getInboxURL(workspaceId, tab) {
-    const tabParam = tab ? `/${tab}` : '';
-    return `/${workspaceId}/inbox${tabParam}`;
-}
-/** Returns the URL for the messages/conversations root. */
-function getMessagesRootURL(workspaceId) {
-    return `/${workspaceId}/msg`;
-}
-/** Returns the URL for a user profile. */
-function getUserProfileURL(params) {
-    return `/${params.workspaceId}/people/u/${params.userId}`;
-}
-/** Returns the URL for the saved threads view. */
-function getSavedThreadsRootURL(workspaceId) {
-    return `/${workspaceId}/saved`;
-}
-/** Returns the URL for a saved thread. */
-function getSavedThreadURL(params) {
-    return `/${params.workspaceId}/saved/t/${params.threadId}`;
-}
-/** Returns the URL for the search root. */
-function getSearchRootURL(workspaceId) {
-    return `/${workspaceId}/search`;
-}
-/** Returns the URL for a search with a query. */
-function getSearchQueryURL(params) {
-    return `/${params.workspaceId}/search?q=${decodeURIComponent(params.query)}`;
-}
-/** Returns the URL for settings. */
-function getSettingsURL(params) {
-    return params.initialLocation
-        ? `/${params.workspaceId}/settings/${params.initialLocation}`
-        : `/${params.workspaceId}/settings`;
-}
-/** Returns the URL for the team members root. */
-function getTeamMembersRootURL(workspaceId) {
-    return `/${workspaceId}/people/u`;
-}