@doist/twist-sdk 0.1.0-alpha.3 → 0.1.0-alpha.4

package/dist/batch-builder.d.ts

@@ -1,3 +1,4 @@
+import { BaseClient } from './clients/base-client';
 import type { BatchRequestDescriptor, BatchResponseArray } from './types/batch';
 /**
  * Executes multiple API requests in a single HTTP call.
@@ -10,11 +11,7 @@ import type { BatchRequestDescriptor, BatchResponseArray } from './types/batch';
  * )
  * ```
  */
-export declare class BatchBuilder {
-    private apiToken;
-    private baseUrl?;
-    constructor(apiToken: string, baseUrl?: string | undefined);
-    private getBaseUri;
+export declare class BatchBuilder extends BaseClient {
     /**
      * Executes an array of batch request descriptors in a single API call.
      *

package/dist/batch-builder.js

@@ -1,4 +1,19 @@
 "use strict";
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
     return new (P || (P = Promise))(function (resolve, reject) {
@@ -37,6 +52,7 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BatchBuilder = void 0;
+var base_client_1 = require("./clients/base-client");
 var errors_1 = require("./types/errors");
 var case_conversion_1 = require("./utils/case-conversion");
 var timestamp_conversion_1 = require("./utils/timestamp-conversion");
@@ -51,14 +67,11 @@ var timestamp_conversion_1 = require("./utils/timestamp-conversion");
  * )
  * ```
  */
-var BatchBuilder = /** @class */ (function () {
-    function BatchBuilder(apiToken, baseUrl) {
-        this.apiToken = apiToken;
-        this.baseUrl = baseUrl;
+var BatchBuilder = /** @class */ (function (_super) {
+    __extends(BatchBuilder, _super);
+    function BatchBuilder() {
+        return _super !== null && _super.apply(this, arguments) || this;
     }
-    BatchBuilder.prototype.getBaseUri = function () {
-        return this.baseUrl ? "".concat(this.baseUrl, "/api/v3") : 'https://api.twist.com/api/v3/';
-    };
     /**
      * Executes an array of batch request descriptors in a single API call.
      *
@@ -187,5 +200,5 @@ var BatchBuilder = /** @class */ (function () {
         });
     };
     return BatchBuilder;
-}());
+}(base_client_1.BaseClient));
 exports.BatchBuilder = BatchBuilder;

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

@@ -0,0 +1,27 @@
+import type { ApiVersion } from '../types/api-version';
+export interface ClientConfig {
+    /** API token for authentication */
+    apiToken: string;
+    /** Optional custom base URL. If not provided, uses the default Twist API URL */
+    baseUrl?: string;
+    /** Optional API version. Defaults to 'v3' */
+    version?: ApiVersion;
+}
+/**
+ * Base client class that provides centralized URL management and configuration
+ * for all Twist API clients. Fixes the trailing slash bug and eliminates code duplication.
+ */
+export declare class BaseClient {
+    protected readonly apiToken: string;
+    protected readonly baseUrl?: string;
+    protected readonly defaultVersion: ApiVersion;
+    constructor(config: ClientConfig);
+    /**
+     * Gets the base URI for API requests with proper trailing slash handling.
+     * This method fixes the trailing slash bug that occurred when using custom baseUrl.
+     *
+     * @param version - Optional API version override. Defaults to the configured version or 'v3'
+     * @returns Base URI with guaranteed trailing slash for proper URL resolution
+     */
+    protected getBaseUri(version?: ApiVersion): string;
+}

package/dist/clients/base-client.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseClient = void 0;
+var endpoints_1 = require("../consts/endpoints");
+/**
+ * Base client class that provides centralized URL management and configuration
+ * for all Twist API clients. Fixes the trailing slash bug and eliminates code duplication.
+ */
+var BaseClient = /** @class */ (function () {
+    function BaseClient(config) {
+        this.apiToken = config.apiToken;
+        this.baseUrl = config.baseUrl;
+        this.defaultVersion = config.version || 'v3';
+    }
+    /**
+     * Gets the base URI for API requests with proper trailing slash handling.
+     * This method fixes the trailing slash bug that occurred when using custom baseUrl.
+     *
+     * @param version - Optional API version override. Defaults to the configured version or 'v3'
+     * @returns Base URI with guaranteed trailing slash for proper URL resolution
+     */
+    BaseClient.prototype.getBaseUri = function (version) {
+        var apiVersion = version || this.defaultVersion;
+        if (this.baseUrl) {
+            // Ensure trailing slash to fix URL resolution bug
+            var normalizedBaseUrl = this.baseUrl.endsWith('/') ? this.baseUrl : "".concat(this.baseUrl, "/");
+            return "".concat(normalizedBaseUrl, "api/").concat(apiVersion, "/");
+        }
+        // Use centralized helper function for default Twist API URL
+        return (0, endpoints_1.getTwistBaseUri)(apiVersion);
+    };
+    return BaseClient;
+}());
+exports.BaseClient = BaseClient;

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

@@ -1,6 +1,7 @@
 import type { BatchRequestDescriptor } from '../types/batch';
 import { Channel } from '../types/entities';
 import { CreateChannelArgs, GetChannelsArgs, UpdateChannelArgs } from '../types/requests';
+import { BaseClient } from './base-client';
 export type AddChannelUserArgs = {
     id: number;
     userId: number;
@@ -20,11 +21,7 @@ export type RemoveChannelUsersArgs = {
 /**
  * Client for interacting with Twist channel endpoints.
  */
-export declare class ChannelsClient {
-    private apiToken;
-    private baseUrl?;
-    constructor(apiToken: string, baseUrl?: string | undefined);
-    private getBaseUri;
+export declare class ChannelsClient extends BaseClient {
     /**
      * Gets all channels for a given workspace.
      *

package/dist/clients/channels-client.js

@@ -1,20 +1,33 @@
 "use strict";
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ChannelsClient = void 0;
 var endpoints_1 = require("../consts/endpoints");
 var rest_client_1 = require("../rest-client");
 var entities_1 = require("../types/entities");
+var base_client_1 = require("./base-client");
 /**
  * Client for interacting with Twist channel endpoints.
  */
-var ChannelsClient = /** @class */ (function () {
-    function ChannelsClient(apiToken, baseUrl) {
-        this.apiToken = apiToken;
-        this.baseUrl = baseUrl;
+var ChannelsClient = /** @class */ (function (_super) {
+    __extends(ChannelsClient, _super);
+    function ChannelsClient() {
+        return _super !== null && _super.apply(this, arguments) || this;
     }
-    ChannelsClient.prototype.getBaseUri = function () {
-        return this.baseUrl ? "".concat(this.baseUrl, "/api/v3") : (0, endpoints_1.getTwistBaseUri)();
-    };
     ChannelsClient.prototype.getChannels = function (args, options) {
         var method = 'GET';
         var url = "".concat(endpoints_1.ENDPOINT_CHANNELS, "/get");
@@ -136,5 +149,5 @@ var ChannelsClient = /** @class */ (function () {
         return (0, rest_client_1.request)(method, this.getBaseUri(), url, this.apiToken, params).then(function () { return undefined; });
     };
     return ChannelsClient;
-}());
+}(base_client_1.BaseClient));
 exports.ChannelsClient = ChannelsClient;

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

@@ -1,6 +1,7 @@
 import type { BatchRequestDescriptor } from '../types/batch';
 import { Comment } from '../types/entities';
 import { CreateCommentArgs, GetCommentsArgs, UpdateCommentArgs } from '../types/requests';
+import { BaseClient } from './base-client';
 export type MarkCommentPositionArgs = {
     threadId: number;
     commentId: number;
@@ -8,11 +9,7 @@ export type MarkCommentPositionArgs = {
 /**
  * Client for interacting with Twist comment endpoints.
  */
-export declare class CommentsClient {
-    private apiToken;
-    private baseUrl?;
-    constructor(apiToken: string, baseUrl?: string | undefined);
-    private getBaseUri;
+export declare class CommentsClient extends BaseClient {
     /**
      * Gets all comments for a thread.
      *

package/dist/clients/comments-client.js

@@ -1,20 +1,33 @@
 "use strict";
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CommentsClient = void 0;
 var endpoints_1 = require("../consts/endpoints");
 var rest_client_1 = require("../rest-client");
 var entities_1 = require("../types/entities");
+var base_client_1 = require("./base-client");
 /**
  * Client for interacting with Twist comment endpoints.
  */
-var CommentsClient = /** @class */ (function () {
-    function CommentsClient(apiToken, baseUrl) {
-        this.apiToken = apiToken;
-        this.baseUrl = baseUrl;
+var CommentsClient = /** @class */ (function (_super) {
+    __extends(CommentsClient, _super);
+    function CommentsClient() {
+        return _super !== null && _super.apply(this, arguments) || this;
     }
-    CommentsClient.prototype.getBaseUri = function () {
-        return this.baseUrl ? "".concat(this.baseUrl, "/api/v3") : (0, endpoints_1.getTwistBaseUri)();
-    };
     CommentsClient.prototype.getComments = function (args, options) {
         var params = {
             thread_id: args.threadId,
@@ -82,5 +95,5 @@ var CommentsClient = /** @class */ (function () {
         return (0, rest_client_1.request)(method, this.getBaseUri(), url, this.apiToken, params).then(function () { return undefined; });
     };
     return CommentsClient;
-}());
+}(base_client_1.BaseClient));
 exports.CommentsClient = CommentsClient;

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

@@ -1,5 +1,6 @@
 import type { BatchRequestDescriptor } from '../types/batch';
 import { ConversationMessage } from '../types/entities';
+import { BaseClient } from './base-client';
 type GetConversationMessagesArgs = {
     conversationId: number;
     newerThan?: Date;
@@ -21,11 +22,7 @@ type UpdateConversationMessageArgs = {
 /**
  * Client for interacting with Twist conversation message endpoints.
  */
-export declare class ConversationMessagesClient {
-    private apiToken;
-    private baseUrl?;
-    constructor(apiToken: string, baseUrl?: string | undefined);
-    private getBaseUri;
+export declare class ConversationMessagesClient extends BaseClient {
     /**
      * Gets all messages in a conversation.
      *

package/dist/clients/conversation-messages-client.js

@@ -1,20 +1,33 @@
 "use strict";
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ConversationMessagesClient = void 0;
 var endpoints_1 = require("../consts/endpoints");
 var rest_client_1 = require("../rest-client");
 var entities_1 = require("../types/entities");
+var base_client_1 = require("./base-client");
 /**
  * Client for interacting with Twist conversation message endpoints.
  */
-var ConversationMessagesClient = /** @class */ (function () {
-    function ConversationMessagesClient(apiToken, baseUrl) {
-        this.apiToken = apiToken;
-        this.baseUrl = baseUrl;
+var ConversationMessagesClient = /** @class */ (function (_super) {
+    __extends(ConversationMessagesClient, _super);
+    function ConversationMessagesClient() {
+        return _super !== null && _super.apply(this, arguments) || this;
     }
-    ConversationMessagesClient.prototype.getBaseUri = function () {
-        return this.baseUrl ? "".concat(this.baseUrl, "/api/v3") : (0, endpoints_1.getTwistBaseUri)();
-    };
     ConversationMessagesClient.prototype.getMessages = function (args, options) {
         var params = {
             conversation_id: args.conversationId,
@@ -88,5 +101,5 @@ var ConversationMessagesClient = /** @class */ (function () {
         return (0, rest_client_1.request)(method, this.getBaseUri(), url, this.apiToken, params).then(function () { return undefined; });
     };
     return ConversationMessagesClient;
-}());
+}(base_client_1.BaseClient));
 exports.ConversationMessagesClient = ConversationMessagesClient;

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

@@ -1,6 +1,7 @@
 import type { BatchRequestDescriptor } from '../types/batch';
 import { Conversation, UnreadConversation } from '../types/entities';
 import { GetConversationsArgs, GetOrCreateConversationArgs } from '../types/requests';
+import { BaseClient } from './base-client';
 export type UpdateConversationArgs = {
     id: number;
     title: string;
@@ -29,11 +30,7 @@ export type MuteConversationArgs = {
 /**
  * Client for interacting with Twist conversation endpoints.
  */
-export declare class ConversationsClient {
-    private apiToken;
-    private baseUrl?;
-    constructor(apiToken: string, baseUrl?: string | undefined);
-    private getBaseUri;
+export declare class ConversationsClient extends BaseClient {
     /**
      * Gets all conversations for a workspace.
      *

package/dist/clients/conversations-client.js

@@ -1,20 +1,33 @@
 "use strict";
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ConversationsClient = void 0;
 var endpoints_1 = require("../consts/endpoints");
 var rest_client_1 = require("../rest-client");
 var entities_1 = require("../types/entities");
+var base_client_1 = require("./base-client");
 /**
  * Client for interacting with Twist conversation endpoints.
  */
-var ConversationsClient = /** @class */ (function () {
-    function ConversationsClient(apiToken, baseUrl) {
-        this.apiToken = apiToken;
-        this.baseUrl = baseUrl;
+var ConversationsClient = /** @class */ (function (_super) {
+    __extends(ConversationsClient, _super);
+    function ConversationsClient() {
+        return _super !== null && _super.apply(this, arguments) || this;
     }
-    ConversationsClient.prototype.getBaseUri = function () {
-        return this.baseUrl ? "".concat(this.baseUrl, "/api/v3") : (0, endpoints_1.getTwistBaseUri)();
-    };
     ConversationsClient.prototype.getConversations = function (args, options) {
         var method = 'GET';
         var url = "".concat(endpoints_1.ENDPOINT_CONVERSATIONS, "/get");
@@ -170,5 +183,5 @@ var ConversationsClient = /** @class */ (function () {
         return (0, rest_client_1.request)(method, this.getBaseUri(), url, this.apiToken, params).then(function (response) { return schema.parse(response.data); });
     };
     return ConversationsClient;
-}());
+}(base_client_1.BaseClient));
 exports.ConversationsClient = ConversationsClient;

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

@@ -1,5 +1,6 @@
 import type { BatchRequestDescriptor } from '../types/batch';
 import { Group } from '../types/entities';
+import { BaseClient } from './base-client';
 export type AddGroupUserArgs = {
     id: number;
     userId: number;
@@ -19,11 +20,7 @@ export type RemoveGroupUsersArgs = {
 /**
  * Client for interacting with Twist group endpoints.
  */
-export declare class GroupsClient {
-    private apiToken;
-    private baseUrl?;
-    constructor(apiToken: string, baseUrl?: string | undefined);
-    private getBaseUri;
+export declare class GroupsClient extends BaseClient {
     /**
      * Gets all groups for a given workspace.
      *

package/dist/clients/groups-client.js

@@ -1,20 +1,33 @@
 "use strict";
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GroupsClient = void 0;
 var endpoints_1 = require("../consts/endpoints");
 var rest_client_1 = require("../rest-client");
 var entities_1 = require("../types/entities");
+var base_client_1 = require("./base-client");
 /**
  * Client for interacting with Twist group endpoints.
  */
-var GroupsClient = /** @class */ (function () {
-    function GroupsClient(apiToken, baseUrl) {
-        this.apiToken = apiToken;
-        this.baseUrl = baseUrl;
+var GroupsClient = /** @class */ (function (_super) {
+    __extends(GroupsClient, _super);
+    function GroupsClient() {
+        return _super !== null && _super.apply(this, arguments) || this;
     }
-    GroupsClient.prototype.getBaseUri = function () {
-        return this.baseUrl ? "".concat(this.baseUrl, "/api/v3") : (0, endpoints_1.getTwistBaseUri)();
-    };
     GroupsClient.prototype.getGroups = function (workspaceId, options) {
         var method = 'GET';
         var url = "".concat(endpoints_1.ENDPOINT_GROUPS, "/get");
@@ -100,5 +113,5 @@ var GroupsClient = /** @class */ (function () {
         return (0, rest_client_1.request)(method, this.getBaseUri(), url, this.apiToken, params).then(function () { return undefined; });
     };
     return GroupsClient;
-}());
+}(base_client_1.BaseClient));
 exports.GroupsClient = GroupsClient;

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

@@ -1,5 +1,6 @@
 import type { BatchRequestDescriptor } from '../types/batch';
 import { InboxThread } from '../types/entities';
+import { BaseClient } from './base-client';
 type GetInboxArgs = {
     workspaceId: number;
     since?: Date;
@@ -16,11 +17,7 @@ type ArchiveAllArgs = {
 /**
  * Client for interacting with Twist inbox endpoints.
  */
-export declare class InboxClient {
-    private apiToken;
-    private baseUrl?;
-    constructor(apiToken: string, baseUrl?: string | undefined);
-    private getBaseUri;
+export declare class InboxClient extends BaseClient {
     /**
      * Gets inbox items (threads).
      *

package/dist/clients/inbox-client.js

@@ -1,20 +1,33 @@
 "use strict";
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.InboxClient = void 0;
 var endpoints_1 = require("../consts/endpoints");
 var rest_client_1 = require("../rest-client");
 var entities_1 = require("../types/entities");
+var base_client_1 = require("./base-client");
 /**
  * Client for interacting with Twist inbox endpoints.
  */
-var InboxClient = /** @class */ (function () {
-    function InboxClient(apiToken, baseUrl) {
-        this.apiToken = apiToken;
-        this.baseUrl = baseUrl;
+var InboxClient = /** @class */ (function (_super) {
+    __extends(InboxClient, _super);
+    function InboxClient() {
+        return _super !== null && _super.apply(this, arguments) || this;
     }
-    InboxClient.prototype.getBaseUri = function () {
-        return this.baseUrl ? "".concat(this.baseUrl, "/api/v3") : (0, endpoints_1.getTwistBaseUri)();
-    };
     InboxClient.prototype.getInbox = function (args, options) {
         var params = {
             workspace_id: args.workspaceId,
@@ -88,5 +101,5 @@ var InboxClient = /** @class */ (function () {
         return (0, rest_client_1.request)(method, this.getBaseUri(), url, this.apiToken, params).then(function () { return undefined; });
     };
     return InboxClient;
-}());
+}(base_client_1.BaseClient));
 exports.InboxClient = InboxClient;

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

@@ -1,4 +1,5 @@
 import type { BatchRequestDescriptor } from '../types/batch';
+import { BaseClient } from './base-client';
 type AddReactionArgs = {
     threadId?: number;
     commentId?: number;
@@ -20,11 +21,7 @@ type ReactionObject = Record<string, number[]> | null;
 /**
  * Client for interacting with Twist reaction endpoints.
  */
-export declare class ReactionsClient {
-    private apiToken;
-    private baseUrl?;
-    constructor(apiToken: string, baseUrl?: string | undefined);
-    private getBaseUri;
+export declare class ReactionsClient extends BaseClient {
     /**
      * Adds an emoji reaction to a thread, comment, or conversation message.
      *

package/dist/clients/reactions-client.js

@@ -1,19 +1,32 @@
 "use strict";
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ReactionsClient = void 0;
 var endpoints_1 = require("../consts/endpoints");
 var rest_client_1 = require("../rest-client");
+var base_client_1 = require("./base-client");
 /**
  * Client for interacting with Twist reaction endpoints.
  */
-var ReactionsClient = /** @class */ (function () {
-    function ReactionsClient(apiToken, baseUrl) {
-        this.apiToken = apiToken;
-        this.baseUrl = baseUrl;
+var ReactionsClient = /** @class */ (function (_super) {
+    __extends(ReactionsClient, _super);
+    function ReactionsClient() {
+        return _super !== null && _super.apply(this, arguments) || this;
     }
-    ReactionsClient.prototype.getBaseUri = function () {
-        return this.baseUrl ? "".concat(this.baseUrl, "/api/v3") : (0, endpoints_1.getTwistBaseUri)();
-    };
     ReactionsClient.prototype.add = function (args, options) {
         var params = {
             reaction: args.reaction,
@@ -82,5 +95,5 @@ var ReactionsClient = /** @class */ (function () {
         return (0, rest_client_1.request)(method, this.getBaseUri(), url, this.apiToken, params).then(function () { return undefined; });
     };
     return ReactionsClient;
-}());
+}(base_client_1.BaseClient));
 exports.ReactionsClient = ReactionsClient;

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

@@ -1,5 +1,6 @@
 import type { BatchRequestDescriptor } from '../types/batch';
 import { SearchResult } from '../types/entities';
+import { BaseClient } from './base-client';
 type SearchArgs = {
     query: string;
     workspaceId: number;
@@ -38,11 +39,7 @@ type SearchConversationResponse = {
 /**
  * Client for interacting with Twist search endpoints.
  */
-export declare class SearchClient {
-    private apiToken;
-    private baseUrl?;
-    constructor(apiToken: string, baseUrl?: string | undefined);
-    private getBaseUri;
+export declare class SearchClient extends BaseClient {
     /**
      * Searches across all threads and conversations in a workspace.
      *
@@ -63,6 +60,7 @@ export declare class SearchClient {
      * ```typescript
      * const results = await api.search.search({
      *   query: 'important meeting',
+import { BaseClient, type ClientConfig } from './base-client'
      *   workspaceId: 123
      * })
      * ```

package/dist/clients/search-client.js

@@ -1,4 +1,19 @@
 "use strict";
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
 var __assign = (this && this.__assign) || function () {
     __assign = Object.assign || function(t) {
         for (var s, i = 1, n = arguments.length; i < n; i++) {
@@ -15,17 +30,15 @@ exports.SearchClient = void 0;
 var endpoints_1 = require("../consts/endpoints");
 var rest_client_1 = require("../rest-client");
 var entities_1 = require("../types/entities");
+var base_client_1 = require("./base-client");
 /**
  * Client for interacting with Twist search endpoints.
  */
-var SearchClient = /** @class */ (function () {
-    function SearchClient(apiToken, baseUrl) {
-        this.apiToken = apiToken;
-        this.baseUrl = baseUrl;
+var SearchClient = /** @class */ (function (_super) {
+    __extends(SearchClient, _super);
+    function SearchClient() {
+        return _super !== null && _super.apply(this, arguments) || this;
     }
-    SearchClient.prototype.getBaseUri = function () {
-        return this.baseUrl ? "".concat(this.baseUrl, "/api/v3") : (0, endpoints_1.getTwistBaseUri)();
-    };
     SearchClient.prototype.search = function (args, options) {
         var params = {
             query: args.query,
@@ -85,5 +98,5 @@ var SearchClient = /** @class */ (function () {
         return (0, rest_client_1.request)(method, this.getBaseUri(), url, this.apiToken, params).then(function (response) { return response.data; });
     };
     return SearchClient;
-}());
+}(base_client_1.BaseClient));
 exports.SearchClient = SearchClient;

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

@@ -1,6 +1,7 @@
 import type { BatchRequestDescriptor } from '../types/batch';
 import { Thread, UnreadThread } from '../types/entities';
 import { CreateThreadArgs, GetThreadsArgs, UpdateThreadArgs } from '../types/requests';
+import { BaseClient } from './base-client';
 export type MoveThreadToChannelArgs = {
     id: number;
     toChannel: number;
@@ -24,11 +25,7 @@ export type MuteThreadArgs = {
 /**
  * Client for interacting with Twist thread endpoints.
  */
-export declare class ThreadsClient {
-    private apiToken;
-    private baseUrl?;
-    constructor(apiToken: string, baseUrl?: string | undefined);
-    private getBaseUri;
+export declare class ThreadsClient extends BaseClient {
     /**
      * Gets all threads in a channel.
      *

package/dist/clients/threads-client.js

@@ -1,20 +1,33 @@
 "use strict";
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ThreadsClient = void 0;
 var endpoints_1 = require("../consts/endpoints");
 var rest_client_1 = require("../rest-client");
 var entities_1 = require("../types/entities");
+var base_client_1 = require("./base-client");
 /**
  * Client for interacting with Twist thread endpoints.
  */
-var ThreadsClient = /** @class */ (function () {
-    function ThreadsClient(apiToken, baseUrl) {
-        this.apiToken = apiToken;
-        this.baseUrl = baseUrl;
+var ThreadsClient = /** @class */ (function (_super) {
+    __extends(ThreadsClient, _super);
+    function ThreadsClient() {
+        return _super !== null && _super.apply(this, arguments) || this;
     }
-    ThreadsClient.prototype.getBaseUri = function () {
-        return this.baseUrl ? "".concat(this.baseUrl, "/api/v3") : (0, endpoints_1.getTwistBaseUri)();
-    };
     ThreadsClient.prototype.getThreads = function (args, options) {
         var method = 'GET';
         var url = "".concat(endpoints_1.ENDPOINT_THREADS, "/get");
@@ -208,5 +221,5 @@ var ThreadsClient = /** @class */ (function () {
         return (0, rest_client_1.request)(method, this.getBaseUri(), url, this.apiToken, params).then(function (response) { return schema.parse(response.data); });
     };
     return ThreadsClient;
-}());
+}(base_client_1.BaseClient));
 exports.ThreadsClient = ThreadsClient;

package/dist/clients/users-client.d.ts

@@ -1,5 +1,6 @@
 import type { BatchRequestDescriptor } from '../types/batch';
 import { User } from '../types/entities';
+import { BaseClient } from './base-client';
 type AwayMode = {
     type: 'parental' | 'vacation' | 'sickleave' | 'other';
     dateFrom?: string;
@@ -26,11 +27,7 @@ type GoogleConnectionStatus = {
 /**
  * Client for interacting with Twist user endpoints.
  */
-export declare class UsersClient {
-    private apiToken;
-    private baseUrl?;
-    constructor(apiToken: string, baseUrl?: string | undefined);
-    private getBaseUri;
+export declare class UsersClient extends BaseClient {
     /**
      * Logs in an existing user.
      *

package/dist/clients/users-client.js

@@ -1,20 +1,33 @@
 "use strict";
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UsersClient = void 0;
 var endpoints_1 = require("../consts/endpoints");
 var rest_client_1 = require("../rest-client");
 var entities_1 = require("../types/entities");
+var base_client_1 = require("./base-client");
 /**
  * Client for interacting with Twist user endpoints.
  */
-var UsersClient = /** @class */ (function () {
-    function UsersClient(apiToken, baseUrl) {
-        this.apiToken = apiToken;
-        this.baseUrl = baseUrl;
+var UsersClient = /** @class */ (function (_super) {
+    __extends(UsersClient, _super);
+    function UsersClient() {
+        return _super !== null && _super.apply(this, arguments) || this;
     }
-    UsersClient.prototype.getBaseUri = function () {
-        return this.baseUrl ? "".concat(this.baseUrl, "/api/v3") : (0, endpoints_1.getTwistBaseUri)();
-    };
     UsersClient.prototype.login = function (args, options) {
         var method = 'POST';
         var url = "".concat(endpoints_1.ENDPOINT_USERS, "/login");
@@ -151,5 +164,5 @@ var UsersClient = /** @class */ (function () {
         return (0, rest_client_1.request)(method, this.getBaseUri(), url, this.apiToken, params).then(function (response) { return response.data; });
     };
     return UsersClient;
-}());
+}(base_client_1.BaseClient));
 exports.UsersClient = UsersClient;

package/dist/clients/workspace-users-client.d.ts

@@ -1,6 +1,7 @@
 import { BatchRequestDescriptor } from '../types/batch';
 import { WorkspaceUser } from '../types/entities';
 import { UserType } from '../types/enums';
+import { BaseClient } from './base-client';
 export type GetWorkspaceUsersArgs = {
     workspaceId: number;
     archived?: boolean;
@@ -24,11 +25,7 @@ export type GetUserLocalTimeArgs = {
 /**
  * Client for interacting with Twist workspace users endpoints (v4 API).
  */
-export declare class WorkspaceUsersClient {
-    private apiToken;
-    private baseUrl?;
-    constructor(apiToken: string, baseUrl?: string | undefined);
-    private getBaseUri;
+export declare class WorkspaceUsersClient extends BaseClient {
     /**
      * Returns a list of workspace user objects for the given workspace id.
      *

package/dist/clients/workspace-users-client.js

@@ -1,19 +1,32 @@
 "use strict";
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WorkspaceUsersClient = void 0;
 var rest_client_1 = require("../rest-client");
 var entities_1 = require("../types/entities");
+var base_client_1 = require("./base-client");
 /**
  * Client for interacting with Twist workspace users endpoints (v4 API).
  */
-var WorkspaceUsersClient = /** @class */ (function () {
-    function WorkspaceUsersClient(apiToken, baseUrl) {
-        this.apiToken = apiToken;
-        this.baseUrl = baseUrl;
+var WorkspaceUsersClient = /** @class */ (function (_super) {
+    __extends(WorkspaceUsersClient, _super);
+    function WorkspaceUsersClient() {
+        return _super !== null && _super.apply(this, arguments) || this;
     }
-    WorkspaceUsersClient.prototype.getBaseUri = function () {
-        return this.baseUrl ? "".concat(this.baseUrl, "/api/v4") : 'https://api.twist.com/api/v4/';
-    };
     WorkspaceUsersClient.prototype.getWorkspaceUsers = function (args, options) {
         var method = 'GET';
         var url = 'workspace_users/get';
@@ -21,7 +34,7 @@ var WorkspaceUsersClient = /** @class */ (function () {
         if (options === null || options === void 0 ? void 0 : options.batch) {
             return { method: method, url: url, params: params };
         }
-        return (0, rest_client_1.request)(method, this.getBaseUri(), url, this.apiToken, params).then(function (response) { return response.data.map(function (user) { return entities_1.WorkspaceUserSchema.parse(user); }); });
+        return (0, rest_client_1.request)(method, this.getBaseUri('v4'), url, this.apiToken, params).then(function (response) { return response.data.map(function (user) { return entities_1.WorkspaceUserSchema.parse(user); }); });
     };
     WorkspaceUsersClient.prototype.getWorkspaceUserIds = function (workspaceId, options) {
         var method = 'GET';
@@ -30,7 +43,7 @@ var WorkspaceUsersClient = /** @class */ (function () {
         if (options === null || options === void 0 ? void 0 : options.batch) {
             return { method: method, url: url, params: params };
         }
-        return (0, rest_client_1.request)(method, this.getBaseUri(), url, this.apiToken, params).then(function (response) { return response.data; });
+        return (0, rest_client_1.request)(method, this.getBaseUri('v4'), url, this.apiToken, params).then(function (response) { return response.data; });
     };
     WorkspaceUsersClient.prototype.getUserById = function (args, options) {
         var method = 'GET';
@@ -40,7 +53,7 @@ var WorkspaceUsersClient = /** @class */ (function () {
         if (options === null || options === void 0 ? void 0 : options.batch) {
             return { method: method, url: url, params: params, schema: schema };
         }
-        return (0, rest_client_1.request)(method, this.getBaseUri(), url, this.apiToken, params).then(function (response) { return schema.parse(response.data); });
+        return (0, rest_client_1.request)(method, this.getBaseUri('v4'), url, this.apiToken, params).then(function (response) { return schema.parse(response.data); });
     };
     WorkspaceUsersClient.prototype.getUserByEmail = function (args, options) {
         var method = 'GET';
@@ -50,7 +63,7 @@ var WorkspaceUsersClient = /** @class */ (function () {
         if (options === null || options === void 0 ? void 0 : options.batch) {
             return { method: method, url: url, params: params, schema: schema };
         }
-        return (0, rest_client_1.request)(method, this.getBaseUri(), url, this.apiToken, params).then(function (response) { return schema.parse(response.data); });
+        return (0, rest_client_1.request)(method, this.getBaseUri('v4'), url, this.apiToken, params).then(function (response) { return schema.parse(response.data); });
     };
     WorkspaceUsersClient.prototype.getUserInfo = function (args, options) {
         var method = 'GET';
@@ -59,7 +72,7 @@ var WorkspaceUsersClient = /** @class */ (function () {
         if (options === null || options === void 0 ? void 0 : options.batch) {
             return { method: method, url: url, params: params };
         }
-        return (0, rest_client_1.request)(method, this.getBaseUri(), url, this.apiToken, params).then(function (response) { return response.data; });
+        return (0, rest_client_1.request)(method, this.getBaseUri('v4'), url, this.apiToken, params).then(function (response) { return response.data; });
     };
     WorkspaceUsersClient.prototype.getUserLocalTime = function (args, options) {
         var method = 'GET';
@@ -68,7 +81,7 @@ var WorkspaceUsersClient = /** @class */ (function () {
         if (options === null || options === void 0 ? void 0 : options.batch) {
             return { method: method, url: url, params: params };
         }
-        return (0, rest_client_1.request)(method, this.getBaseUri(), url, this.apiToken, params).then(function (response) { return response.data; });
+        return (0, rest_client_1.request)(method, this.getBaseUri('v4'), url, this.apiToken, params).then(function (response) { return response.data; });
     };
     WorkspaceUsersClient.prototype.addUser = function (args, options) {
         var params = {
@@ -84,7 +97,7 @@ var WorkspaceUsersClient = /** @class */ (function () {
         if (options === null || options === void 0 ? void 0 : options.batch) {
             return { method: method, url: url, params: params, schema: schema };
         }
-        return (0, rest_client_1.request)(method, this.getBaseUri(), url, this.apiToken, params).then(function (response) { return schema.parse(response.data); });
+        return (0, rest_client_1.request)(method, this.getBaseUri('v4'), url, this.apiToken, params).then(function (response) { return schema.parse(response.data); });
     };
     WorkspaceUsersClient.prototype.updateUser = function (args, options) {
         var params = {
@@ -99,7 +112,7 @@ var WorkspaceUsersClient = /** @class */ (function () {
         if (options === null || options === void 0 ? void 0 : options.batch) {
             return { method: method, url: url, params: params, schema: schema };
         }
-        return (0, rest_client_1.request)(method, this.getBaseUri(), url, this.apiToken, params).then(function (response) { return schema.parse(response.data); });
+        return (0, rest_client_1.request)(method, this.getBaseUri('v4'), url, this.apiToken, params).then(function (response) { return schema.parse(response.data); });
     };
     WorkspaceUsersClient.prototype.removeUser = function (args, options) {
         var params = {
@@ -112,7 +125,7 @@ var WorkspaceUsersClient = /** @class */ (function () {
         if (options === null || options === void 0 ? void 0 : options.batch) {
             return { method: method, url: url, params: params };
         }
-        return (0, rest_client_1.request)(method, this.getBaseUri(), url, this.apiToken, params).then(function () { return undefined; });
+        return (0, rest_client_1.request)(method, this.getBaseUri('v4'), url, this.apiToken, params).then(function () { return undefined; });
     };
     WorkspaceUsersClient.prototype.resendInvite = function (args, options) {
         var params = {
@@ -125,8 +138,8 @@ var WorkspaceUsersClient = /** @class */ (function () {
         if (options === null || options === void 0 ? void 0 : options.batch) {
             return { method: method, url: url, params: params };
         }
-        return (0, rest_client_1.request)(method, this.getBaseUri(), url, this.apiToken, params).then(function () { return undefined; });
+        return (0, rest_client_1.request)(method, this.getBaseUri('v4'), url, this.apiToken, params).then(function () { return undefined; });
     };
     return WorkspaceUsersClient;
-}());
+}(base_client_1.BaseClient));
 exports.WorkspaceUsersClient = WorkspaceUsersClient;

package/dist/clients/workspaces-client.d.ts

@@ -1,13 +1,10 @@
 import type { BatchRequestDescriptor } from '../types/batch';
 import { Channel, Workspace } from '../types/entities';
+import { BaseClient } from './base-client';
 /**
  * Client for interacting with Twist workspace endpoints.
  */
-export declare class WorkspacesClient {
-    private apiToken;
-    private baseUrl?;
-    constructor(apiToken: string, baseUrl?: string | undefined);
-    private getBaseUri;
+export declare class WorkspacesClient extends BaseClient {
     /**
      * Gets all the user's workspaces.
      *

package/dist/clients/workspaces-client.js

@@ -1,20 +1,33 @@
 "use strict";
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WorkspacesClient = void 0;
 var endpoints_1 = require("../consts/endpoints");
 var rest_client_1 = require("../rest-client");
 var entities_1 = require("../types/entities");
+var base_client_1 = require("./base-client");
 /**
  * Client for interacting with Twist workspace endpoints.
  */
-var WorkspacesClient = /** @class */ (function () {
-    function WorkspacesClient(apiToken, baseUrl) {
-        this.apiToken = apiToken;
-        this.baseUrl = baseUrl;
+var WorkspacesClient = /** @class */ (function (_super) {
+    __extends(WorkspacesClient, _super);
+    function WorkspacesClient() {
+        return _super !== null && _super.apply(this, arguments) || this;
     }
-    WorkspacesClient.prototype.getBaseUri = function () {
-        return this.baseUrl ? "".concat(this.baseUrl, "/api/v3") : (0, endpoints_1.getTwistBaseUri)();
-    };
     WorkspacesClient.prototype.getWorkspaces = function (options) {
         var method = 'GET';
         var url = "".concat(endpoints_1.ENDPOINT_WORKSPACES, "/get");
@@ -85,5 +98,5 @@ var WorkspacesClient = /** @class */ (function () {
         return (0, rest_client_1.request)(method, this.getBaseUri(), url, this.apiToken, params).then(function (response) { return response.data.map(function (channel) { return entities_1.ChannelSchema.parse(channel); }); });
     };
     return WorkspacesClient;
-}());
+}(base_client_1.BaseClient));
 exports.WorkspacesClient = WorkspacesClient;

package/dist/consts/endpoints.d.ts

@@ -1,6 +1,17 @@
+import type { ApiVersion } from '../types/api-version';
 export declare const API_VERSION = "v3";
+/**
+ * @deprecated Use getTwistBaseUri() instead. This constant is kept for backward compatibility.
+ */
 export declare const API_BASE_URI = "/api/v3/";
-export declare function getTwistBaseUri(domainBase?: string): string;
+/**
+ * Gets the base URI for Twist API requests.
+ *
+ * @param version - API version ('v3' or 'v4'). Defaults to 'v3'.
+ * @param domainBase - Custom domain base URL. Defaults to Twist's API domain.
+ * @returns Complete base URI with trailing slash (e.g., 'https://api.twist.com/api/v3/')
+ */
+export declare function getTwistBaseUri(version?: ApiVersion, domainBase?: string): string;
 export declare const ENDPOINT_USERS = "users";
 export declare const ENDPOINT_WORKSPACES = "workspaces";
 export declare const ENDPOINT_CHANNELS = "channels";

package/dist/consts/endpoints.js

@@ -4,10 +4,21 @@ exports.ENDPOINT_CONVERSATION_MESSAGES = exports.ENDPOINT_SEARCH = exports.ENDPO
 exports.getTwistBaseUri = getTwistBaseUri;
 var BASE_URI = 'https://api.twist.com';
 exports.API_VERSION = 'v3';
+/**
+ * @deprecated Use getTwistBaseUri() instead. This constant is kept for backward compatibility.
+ */
 exports.API_BASE_URI = "/api/".concat(exports.API_VERSION, "/");
-function getTwistBaseUri(domainBase) {
+/**
+ * Gets the base URI for Twist API requests.
+ *
+ * @param version - API version ('v3' or 'v4'). Defaults to 'v3'.
+ * @param domainBase - Custom domain base URL. Defaults to Twist's API domain.
+ * @returns Complete base URI with trailing slash (e.g., 'https://api.twist.com/api/v3/')
+ */
+function getTwistBaseUri(version, domainBase) {
+    if (version === void 0) { version = 'v3'; }
     if (domainBase === void 0) { domainBase = BASE_URI; }
-    return new URL(exports.API_BASE_URI, domainBase).toString();
+    return new URL("/api/".concat(version, "/"), domainBase).toString();
 }
 exports.ENDPOINT_USERS = 'users';
 exports.ENDPOINT_WORKSPACES = 'workspaces';

package/dist/twist-api.js

@@ -35,18 +35,20 @@ var TwistApi = /** @class */ (function () {
     function TwistApi(authToken, baseUrl) {
         this.authToken = authToken;
         this.baseUrl = baseUrl;
-        this.users = new users_client_1.UsersClient(authToken, baseUrl);
-        this.workspaces = new workspaces_client_1.WorkspacesClient(authToken, baseUrl);
-        this.workspaceUsers = new workspace_users_client_1.WorkspaceUsersClient(authToken, baseUrl);
-        this.channels = new channels_client_1.ChannelsClient(authToken, baseUrl);
-        this.threads = new threads_client_1.ThreadsClient(authToken, baseUrl);
-        this.groups = new groups_client_1.GroupsClient(authToken, baseUrl);
-        this.conversations = new conversations_client_1.ConversationsClient(authToken, baseUrl);
-        this.comments = new comments_client_1.CommentsClient(authToken, baseUrl);
-        this.conversationMessages = new conversation_messages_client_1.ConversationMessagesClient(authToken, baseUrl);
-        this.inbox = new inbox_client_1.InboxClient(authToken, baseUrl);
-        this.reactions = new reactions_client_1.ReactionsClient(authToken, baseUrl);
-        this.search = new search_client_1.SearchClient(authToken, baseUrl);
+        var clientConfig = { apiToken: authToken, baseUrl: baseUrl };
+        var workspaceUserConfig = { apiToken: authToken, baseUrl: baseUrl, version: 'v4' };
+        this.users = new users_client_1.UsersClient(clientConfig);
+        this.workspaces = new workspaces_client_1.WorkspacesClient(clientConfig);
+        this.workspaceUsers = new workspace_users_client_1.WorkspaceUsersClient(workspaceUserConfig);
+        this.channels = new channels_client_1.ChannelsClient(clientConfig);
+        this.threads = new threads_client_1.ThreadsClient(clientConfig);
+        this.groups = new groups_client_1.GroupsClient(clientConfig);
+        this.conversations = new conversations_client_1.ConversationsClient(clientConfig);
+        this.comments = new comments_client_1.CommentsClient(clientConfig);
+        this.conversationMessages = new conversation_messages_client_1.ConversationMessagesClient(clientConfig);
+        this.inbox = new inbox_client_1.InboxClient(clientConfig);
+        this.reactions = new reactions_client_1.ReactionsClient(clientConfig);
+        this.search = new search_client_1.SearchClient(clientConfig);
     }
     /**
      * Executes multiple API requests in a single HTTP call using the batch endpoint.
@@ -68,7 +70,7 @@ var TwistApi = /** @class */ (function () {
         for (var _i = 0; _i < arguments.length; _i++) {
             requests[_i] = arguments[_i];
         }
-        var builder = new batch_builder_1.BatchBuilder(this.authToken, this.baseUrl);
+        var builder = new batch_builder_1.BatchBuilder({ apiToken: this.authToken, baseUrl: this.baseUrl });
         return builder.execute(requests);
     };
     return TwistApi;

package/dist/types/api-version.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Supported Twist API versions
+ */
+export type ApiVersion = 'v3' | 'v4';

package/dist/types/api-version.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@doist/twist-sdk",
-    "version": "0.1.0-alpha.3",
+    "version": "0.1.0-alpha.4",
     "description": "A TypeScript wrapper for the Twist REST API.",
     "author": "Doist developers",
     "homepage": "https://doist.github.io/twist-sdk-typescript/",
@@ -44,17 +44,17 @@
         "@biomejs/biome": "2.2.5",
         "@types/uuid": "9.0.8",
         "husky": "9.1.7",
-        "lint-staged": "13.3.0",
+        "lint-staged": "16.2.6",
         "msw": "^2.11.3",
         "npm-run-all2": "8.0.4",
-        "rimraf": "3.0.2",
+        "rimraf": "6.0.1",
         "ts-node": "10.9.2",
-        "type-fest": "^4.12.0",
+        "type-fest": "^5.0.0",
         "typescript": "5.9.3",
         "vitest": "3.2.4"
     },
     "peerDependencies": {
-        "type-fest": "^4.12.0"
+        "type-fest": "^4.12.0 || ^5.1.0"
     },
     "husky": {
         "hooks": {