@xpoz/xpoz 0.2.1 → 0.3.1

package/dist/index.cjs

@@ -1,7 +1,9 @@
 "use strict";
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -15,6 +17,14 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
@@ -284,10 +294,18 @@ function coerce(value) {
 }
 
 // src/version.ts
-var VERSION = "0.2.1";
+var VERSION = "0.3.1";
 
 // src/mcp/transport.ts
 var USER_AGENT = `xpoz-ts-sdk/${VERSION}`;
+function getProxyUrl() {
+  return process.env.HTTPS_PROXY ?? process.env.https_proxy ?? process.env.HTTP_PROXY ?? process.env.http_proxy;
+}
+async function createProxyFetch(proxyUrl) {
+  const { ProxyAgent, fetch: undiciFetch } = await import("undici");
+  const dispatcher = new ProxyAgent(proxyUrl);
+  return ((input, init) => undiciFetch(input, { ...init, dispatcher }));
+}
 var McpTransport = class {
   serverUrl;
   apiKey;
@@ -302,8 +320,11 @@ var McpTransport = class {
       "User-Agent": USER_AGENT,
       Authorization: `Bearer ${this.apiKey}`
     };
+    const proxyUrl = getProxyUrl();
+    const customFetch = proxyUrl ? await createProxyFetch(proxyUrl) : void 0;
     this.transport = new import_streamableHttp.StreamableHTTPClientTransport(new URL(this.serverUrl), {
-      requestInit: { headers }
+      requestInit: { headers },
+      ...customFetch ? { fetch: customFetch } : {}
     });
     this.client = new import_client.Client(
       { name: "xpoz-ts-sdk", version: VERSION },
@@ -313,6 +334,10 @@ var McpTransport = class {
   }
   async close() {
     if (this.client) {
+      try {
+        await this.transport?.terminateSession();
+      } catch {
+      }
       try {
         await this.client.close();
       } catch {
@@ -571,6 +596,7 @@ var GET_TWITTER_COMMENTS = "getTwitterPostComments";
 var GET_TWITTER_POST_INTERACTING_USERS = "getTwitterPostInteractingUsers";
 var COUNT_TWEETS = "countTweets";
 var GET_TWITTER_USER = "getTwitterUser";
+var GET_TWITTER_USERS = "getTwitterUsers";
 var SEARCH_TWITTER_USERS = "searchTwitterUsers";
 var GET_TWITTER_USER_CONNECTIONS = "getTwitterUserConnections";
 var GET_TWITTER_USERS_BY_KEYWORDS = "getTwitterUsersByKeywords";
@@ -592,6 +618,13 @@ var GET_REDDIT_USERS_BY_KEYWORDS = "getRedditUsersByKeywords";
 var SEARCH_REDDIT_SUBREDDITS = "searchRedditSubreddits";
 var GET_REDDIT_SUBREDDIT_WITH_POSTS = "getRedditSubredditWithPostsByName";
 var GET_REDDIT_SUBREDDITS_BY_KEYWORDS = "getRedditSubredditsByKeywords";
+var GET_TIKTOK_POSTS_BY_IDS = "getTiktokPostsByIds";
+var GET_TIKTOK_POSTS_BY_USER = "getTiktokPostsByUser";
+var SEARCH_TIKTOK_POSTS = "getTiktokPostsByKeywords";
+var GET_TIKTOK_COMMENTS = "getTiktokCommentsByPostId";
+var GET_TIKTOK_USER = "getTiktokUser";
+var SEARCH_TIKTOK_USERS = "searchTiktokUsers";
+var GET_TIKTOK_USERS_BY_KEYWORDS = "getTiktokUsersByKeywords";
 
 // src/namespaces/twitter.ts
 function parseTwitterPost(item) {
@@ -603,7 +636,10 @@ function parseUser(item) {
 var TwitterNamespace = class extends BaseNamespace {
   async getPostsByIds(postIds, options = {}) {
     const args = this.buildArgs({ postIds, ...options });
-    const result = await this.callAndMaybePoll(GET_TWITTER_POSTS_BY_IDS, args);
+    const result = await this.callAndMaybePoll(
+      GET_TWITTER_POSTS_BY_IDS,
+      args
+    );
     return (result["results"] ?? []).map(parseTwitterPost);
   }
   async getPostsByAuthor(identifier, options = {}) {
@@ -616,8 +652,16 @@ var TwitterNamespace = class extends BaseNamespace {
       responseType: options.responseType,
       limit: options.limit
     });
-    const result = await this.callAndMaybePoll(GET_TWITTER_POSTS_BY_AUTHOR, args);
-    return this.buildPaginatedResult(result, parseTwitterPost, GET_TWITTER_POSTS_BY_AUTHOR, args);
+    const result = await this.callAndMaybePoll(
+      GET_TWITTER_POSTS_BY_AUTHOR,
+      args
+    );
+    return this.buildPaginatedResult(
+      result,
+      parseTwitterPost,
+      GET_TWITTER_POSTS_BY_AUTHOR,
+      args
+    );
   }
   async searchPosts(query, options = {}) {
     const args = this.buildArgs({
@@ -628,6 +672,7 @@ var TwitterNamespace = class extends BaseNamespace {
       authorUsername: options.authorUsername,
       authorId: options.authorId,
       language: options.language,
+      filterOutRetweets: options.filterOutRetweets,
       forceLatest: options.forceLatest,
       responseType: options.responseType,
       limit: options.limit
@@ -635,30 +680,70 @@ var TwitterNamespace = class extends BaseNamespace {
     if (options.responseType === "csv" /* Csv */) {
       const raw = await this.callTool(SEARCH_TWITTER_POSTS, args);
       const exportOpId = raw["operationId"] ?? raw["dataDumpExportOperationId"] ?? null;
-      const csvRaw = { results: [], dataDumpExportOperationId: exportOpId };
-      return this.buildPaginatedResult(csvRaw, parseTwitterPost, SEARCH_TWITTER_POSTS, args);
+      const csvRaw = {
+        results: [],
+        dataDumpExportOperationId: exportOpId
+      };
+      return this.buildPaginatedResult(
+        csvRaw,
+        parseTwitterPost,
+        SEARCH_TWITTER_POSTS,
+        args
+      );
     }
-    const result = await this.callAndMaybePoll(SEARCH_TWITTER_POSTS, args);
-    return this.buildPaginatedResult(result, parseTwitterPost, SEARCH_TWITTER_POSTS, args);
+    const result = await this.callAndMaybePoll(
+      SEARCH_TWITTER_POSTS,
+      args
+    );
+    return this.buildPaginatedResult(
+      result,
+      parseTwitterPost,
+      SEARCH_TWITTER_POSTS,
+      args
+    );
   }
   async getRetweets(postId, options = {}) {
     const args = this.buildArgs({ postId, ...options });
-    const result = await this.callAndMaybePoll(GET_TWITTER_RETWEETS, args);
-    return this.buildPaginatedResult(result, parseTwitterPost, GET_TWITTER_RETWEETS, args);
+    const result = await this.callAndMaybePoll(
+      GET_TWITTER_RETWEETS,
+      args
+    );
+    return this.buildPaginatedResult(
+      result,
+      parseTwitterPost,
+      GET_TWITTER_RETWEETS,
+      args
+    );
   }
   async getQuotes(postId, options = {}) {
     const args = this.buildArgs({ postId, ...options });
     const result = await this.callAndMaybePoll(GET_TWITTER_QUOTES, args);
-    return this.buildPaginatedResult(result, parseTwitterPost, GET_TWITTER_QUOTES, args);
+    return this.buildPaginatedResult(
+      result,
+      parseTwitterPost,
+      GET_TWITTER_QUOTES,
+      args
+    );
   }
   async getComments(postId, options = {}) {
     const args = this.buildArgs({ postId, ...options });
-    const result = await this.callAndMaybePoll(GET_TWITTER_COMMENTS, args);
-    return this.buildPaginatedResult(result, parseTwitterPost, GET_TWITTER_COMMENTS, args);
+    const result = await this.callAndMaybePoll(
+      GET_TWITTER_COMMENTS,
+      args
+    );
+    return this.buildPaginatedResult(
+      result,
+      parseTwitterPost,
+      GET_TWITTER_COMMENTS,
+      args
+    );
   }
   async getPostInteractingUsers(postId, interactionType, options = {}) {
     const args = this.buildArgs({ postId, interactionType, ...options });
-    const result = await this.callAndMaybePoll(GET_TWITTER_POST_INTERACTING_USERS, args);
+    const result = await this.callAndMaybePoll(
+      GET_TWITTER_POST_INTERACTING_USERS,
+      args
+    );
     return this.buildPaginatedResult(
       result,
       parseUser,
@@ -680,6 +765,16 @@ var TwitterNamespace = class extends BaseNamespace {
     }
     return Number(count);
   }
+  async getUsers(identifiers, options = {}) {
+    const args = this.buildArgs({
+      identifiers,
+      identifierType: options.identifierType ?? "username",
+      fields: options.fields,
+      forceLatest: options.forceLatest
+    });
+    const result = await this.callAndMaybePoll(GET_TWITTER_USERS, args);
+    return (result["results"] ?? []).map(parseUser);
+  }
   async getUser(identifier, options = {}) {
     const args = this.buildArgs({
       identifier,
@@ -695,12 +790,18 @@ var TwitterNamespace = class extends BaseNamespace {
   }
   async searchUsers(name, options = {}) {
     const args = this.buildArgs({ name, ...options });
-    const result = await this.callAndMaybePoll(SEARCH_TWITTER_USERS, args);
+    const result = await this.callAndMaybePoll(
+      SEARCH_TWITTER_USERS,
+      args
+    );
     return (result["results"] ?? []).map(parseUser);
   }
   async getUserConnections(username, connectionType, options = {}) {
     const args = this.buildArgs({ username, connectionType, ...options });
-    const result = await this.callAndMaybePoll(GET_TWITTER_USER_CONNECTIONS, args);
+    const result = await this.callAndMaybePoll(
+      GET_TWITTER_USER_CONNECTIONS,
+      args
+    );
     return this.buildPaginatedResult(
       result,
       parseUser,
@@ -710,7 +811,10 @@ var TwitterNamespace = class extends BaseNamespace {
   }
   async getUsersByKeywords(query, options = {}) {
     const args = this.buildArgs({ query, ...options });
-    const result = await this.callAndMaybePoll(GET_TWITTER_USERS_BY_KEYWORDS, args);
+    const result = await this.callAndMaybePoll(
+      GET_TWITTER_USERS_BY_KEYWORDS,
+      args
+    );
     return this.buildPaginatedResult(
       result,
       parseUser,
@@ -931,6 +1035,89 @@ var RedditNamespace = class extends BaseNamespace {
   }
 };
 
+// src/namespaces/tiktok.ts
+function parsePost3(item) {
+  return item;
+}
+function parseUser4(item) {
+  return item;
+}
+function parseComment3(item) {
+  return item;
+}
+var TiktokNamespace = class extends BaseNamespace {
+  async getPostsByIds(postIds, options = {}) {
+    const args = this.buildArgs({ postIds, ...options });
+    const result = await this.callAndMaybePoll(GET_TIKTOK_POSTS_BY_IDS, args);
+    return (result["results"] ?? []).map(parsePost3);
+  }
+  async getPostsByUser(identifier, options = {}) {
+    const args = this.buildArgs({
+      identifier,
+      identifierType: options.identifierType ?? "username",
+      fields: options.fields,
+      startDate: options.startDate,
+      endDate: options.endDate,
+      forceLatest: options.forceLatest,
+      responseType: options.responseType,
+      limit: options.limit
+    });
+    const result = await this.callAndMaybePoll(GET_TIKTOK_POSTS_BY_USER, args);
+    return this.buildPaginatedResult(
+      result,
+      parsePost3,
+      GET_TIKTOK_POSTS_BY_USER,
+      args
+    );
+  }
+  async searchPosts(query, options = {}) {
+    const args = this.buildArgs({
+      query,
+      fields: options.fields,
+      startDate: options.startDate,
+      endDate: options.endDate,
+      forceLatest: options.forceLatest,
+      responseType: options.responseType,
+      limit: options.limit
+    });
+    const result = await this.callAndMaybePoll(SEARCH_TIKTOK_POSTS, args);
+    return this.buildPaginatedResult(result, parsePost3, SEARCH_TIKTOK_POSTS, args);
+  }
+  async getComments(postId, options = {}) {
+    const args = this.buildArgs({ postId, ...options });
+    const result = await this.callAndMaybePoll(GET_TIKTOK_COMMENTS, args);
+    return this.buildPaginatedResult(result, parseComment3, GET_TIKTOK_COMMENTS, args);
+  }
+  async getUser(identifier, options = {}) {
+    const args = this.buildArgs({
+      identifier,
+      identifierType: options.identifierType ?? "username",
+      fields: options.fields
+    });
+    const result = await this.callAndMaybePoll(GET_TIKTOK_USER, args);
+    const results = result["results"];
+    if (Array.isArray(results) && results.length > 0) {
+      return results[0];
+    }
+    return result;
+  }
+  async searchUsers(name, options = {}) {
+    const args = this.buildArgs({ name, ...options });
+    const result = await this.callAndMaybePoll(SEARCH_TIKTOK_USERS, args);
+    return (result["results"] ?? []).map(parseUser4);
+  }
+  async getUsersByKeywords(query, options = {}) {
+    const args = this.buildArgs({ query, ...options });
+    const result = await this.callAndMaybePoll(GET_TIKTOK_USERS_BY_KEYWORDS, args);
+    return this.buildPaginatedResult(
+      result,
+      parseUser4,
+      GET_TIKTOK_USERS_BY_KEYWORDS,
+      args
+    );
+  }
+};
+
 // src/versionCheck.ts
 var NPM_REGISTRY_URL = "https://registry.npmjs.org/@xpoz/xpoz/latest";
 var CHECK_TIMEOUT_MS = 3e3;
@@ -976,6 +1163,7 @@ var XpozClient = class {
   twitter;
   instagram;
   reddit;
+  tiktok;
   transport;
   versionCheck;
   constructor(options = {}) {
@@ -993,6 +1181,7 @@ var XpozClient = class {
     this.twitter = new TwitterNamespace(callTool, timeoutMs);
     this.instagram = new InstagramNamespace(callTool, timeoutMs);
     this.reddit = new RedditNamespace(callTool, timeoutMs);
+    this.tiktok = new TiktokNamespace(callTool, timeoutMs);
   }
   async connect() {
     await this.transport.connect();

package/dist/index.d.cts

@@ -170,6 +170,7 @@ declare class TwitterNamespace extends BaseNamespace {
         authorUsername?: string;
         authorId?: string;
         language?: string;
+        filterOutRetweets?: boolean;
         forceLatest?: boolean;
         responseType?: ResponseType;
         limit?: number;
@@ -196,6 +197,11 @@ declare class TwitterNamespace extends BaseNamespace {
         startDate?: string;
         endDate?: string;
     }): Promise<number>;
+    getUsers(identifiers: string[], options?: {
+        identifierType?: string;
+        fields?: string[];
+        forceLatest?: boolean;
+    }): Promise<TwitterUser[]>;
     getUser(identifier: string, options?: {
         identifierType?: string;
         fields?: string[];
@@ -553,10 +559,131 @@ declare class RedditNamespace extends BaseNamespace {
     private _parseSubredditWithPosts;
 }
 
+interface TiktokPost {
+    id?: string | null;
+    postType?: number | null;
+    isPrivate?: boolean | null;
+    videoThumbnail?: string | null;
+    description?: string | null;
+    descriptionLanguage?: string | null;
+    userId?: string | null;
+    username?: string | null;
+    nickname?: string | null;
+    collectCount?: number | null;
+    commentCount?: number | null;
+    likeCount?: number | null;
+    downloadCount?: number | null;
+    forwardCount?: number | null;
+    playCount?: number | null;
+    createdAt?: string | null;
+    createdAtTimestamp?: number | null;
+    createdAtDate?: string | null;
+    lastFetch?: string | null;
+    lastFetchDatetime?: string | null;
+    xLastUpdated?: string | null;
+    aggRelevance?: number | null;
+    relevantPostsCount?: number | null;
+    relevantPostsLikesSum?: number | null;
+    relevantPostsCommentsSum?: number | null;
+    relevantPostsPlaysSum?: number | null;
+    relevantPostsForwardsSum?: number | null;
+    [key: string]: unknown;
+}
+interface TiktokUser {
+    id?: string | null;
+    username?: string | null;
+    nickname?: string | null;
+    signature?: string | null;
+    secUid?: string | null;
+    avatar?: string | null;
+    isPrivate?: boolean | null;
+    isVerified?: boolean | null;
+    followerCount?: number | null;
+    followingCount?: number | null;
+    likeCount?: number | null;
+    postCount?: number | null;
+    language?: string | null;
+    region?: string | null;
+    createdAt?: string | null;
+    usernameModifyTime?: string | null;
+    lastFetch?: string | null;
+    lastFetchDatetime?: string | null;
+    xLastUpdated?: string | null;
+    aggRelevance?: number | null;
+    relevantPostsCount?: number | null;
+    relevantPostsLikesSum?: number | null;
+    relevantPostsCommentsSum?: number | null;
+    relevantPostsPlaysSum?: number | null;
+    relevantPostsForwardsSum?: number | null;
+    [key: string]: unknown;
+}
+interface TiktokComment {
+    id?: string | null;
+    postId?: string | null;
+    userId?: string | null;
+    username?: string | null;
+    text?: string | null;
+    likeCount?: number | null;
+    createdAt?: string | null;
+    createdAtTimestamp?: number | null;
+    createdAtDate?: string | null;
+    lastFetch?: string | null;
+    lastFetchDatetime?: string | null;
+    xLastUpdated?: string | null;
+    [key: string]: unknown;
+}
+
+declare class TiktokNamespace extends BaseNamespace {
+    getPostsByIds(postIds: string[], options?: {
+        fields?: string[];
+        forceLatest?: boolean;
+    }): Promise<TiktokPost[]>;
+    getPostsByUser(identifier: string, options?: {
+        identifierType?: string;
+        fields?: string[];
+        startDate?: string;
+        endDate?: string;
+        forceLatest?: boolean;
+        responseType?: ResponseType;
+        limit?: number;
+    }): Promise<PaginatedResult<TiktokPost>>;
+    searchPosts(query: string, options?: {
+        fields?: string[];
+        startDate?: string;
+        endDate?: string;
+        forceLatest?: boolean;
+        responseType?: ResponseType;
+        limit?: number;
+    }): Promise<PaginatedResult<TiktokPost>>;
+    getComments(postId: string, options?: {
+        fields?: string[];
+        startDate?: string;
+        endDate?: string;
+        forceLatest?: boolean;
+    }): Promise<PaginatedResult<TiktokComment>>;
+    getUser(identifier: string, options?: {
+        identifierType?: string;
+        fields?: string[];
+    }): Promise<TiktokUser>;
+    searchUsers(name: string, options?: {
+        limit?: number;
+        fields?: string[];
+    }): Promise<TiktokUser[]>;
+    getUsersByKeywords(query: string, options?: {
+        fields?: string[];
+        startDate?: string;
+        endDate?: string;
+        forceLatest?: boolean;
+        responseType?: ResponseType;
+        limit?: number;
+    }): Promise<PaginatedResult<TiktokUser>>;
+}
+
 declare class XpozClient {
     twitter: TwitterNamespace;
     instagram: InstagramNamespace;
     reddit: RedditNamespace;
+    tiktok: TiktokNamespace;
     private transport;
     private versionCheck;
     constructor(options?: {
@@ -594,8 +721,8 @@ declare class OperationCancelledError extends XpozError {
     constructor(operationId: string);
 }
 
-declare const VERSION = "0.2.1";
+declare const VERSION = "0.3.1";
 
 declare function checkForUpdates(): Promise<void>;
 
-export { AuthenticationError, type InstagramComment, type InstagramPost, type InstagramUser, OperationCancelledError, OperationFailedError, OperationTimeoutError, PaginatedResult, type PaginationInfo, type RedditComment, type RedditPost, type RedditPostWithComments, type RedditSubreddit, type RedditUser, ResponseType, type SubredditWithPosts, type TwitterPost, type TwitterUser, VERSION, XpozClient, XpozConnectionError, XpozError, checkForUpdates };
+export { AuthenticationError, type InstagramComment, type InstagramPost, type InstagramUser, OperationCancelledError, OperationFailedError, OperationTimeoutError, PaginatedResult, type PaginationInfo, type RedditComment, type RedditPost, type RedditPostWithComments, type RedditSubreddit, type RedditUser, ResponseType, type SubredditWithPosts, type TiktokComment, type TiktokPost, type TiktokUser, type TwitterPost, type TwitterUser, VERSION, XpozClient, XpozConnectionError, XpozError, checkForUpdates };

package/dist/index.d.ts

@@ -170,6 +170,7 @@ declare class TwitterNamespace extends BaseNamespace {
         authorUsername?: string;
         authorId?: string;
         language?: string;
+        filterOutRetweets?: boolean;
         forceLatest?: boolean;
         responseType?: ResponseType;
         limit?: number;
@@ -196,6 +197,11 @@ declare class TwitterNamespace extends BaseNamespace {
         startDate?: string;
         endDate?: string;
     }): Promise<number>;
+    getUsers(identifiers: string[], options?: {
+        identifierType?: string;
+        fields?: string[];
+        forceLatest?: boolean;
+    }): Promise<TwitterUser[]>;
     getUser(identifier: string, options?: {
         identifierType?: string;
         fields?: string[];
@@ -553,10 +559,131 @@ declare class RedditNamespace extends BaseNamespace {
     private _parseSubredditWithPosts;
 }
 
+interface TiktokPost {
+    id?: string | null;
+    postType?: number | null;
+    isPrivate?: boolean | null;
+    videoThumbnail?: string | null;
+    description?: string | null;
+    descriptionLanguage?: string | null;
+    userId?: string | null;
+    username?: string | null;
+    nickname?: string | null;
+    collectCount?: number | null;
+    commentCount?: number | null;
+    likeCount?: number | null;
+    downloadCount?: number | null;
+    forwardCount?: number | null;
+    playCount?: number | null;
+    createdAt?: string | null;
+    createdAtTimestamp?: number | null;
+    createdAtDate?: string | null;
+    lastFetch?: string | null;
+    lastFetchDatetime?: string | null;
+    xLastUpdated?: string | null;
+    aggRelevance?: number | null;
+    relevantPostsCount?: number | null;
+    relevantPostsLikesSum?: number | null;
+    relevantPostsCommentsSum?: number | null;
+    relevantPostsPlaysSum?: number | null;
+    relevantPostsForwardsSum?: number | null;
+    [key: string]: unknown;
+}
+interface TiktokUser {
+    id?: string | null;
+    username?: string | null;
+    nickname?: string | null;
+    signature?: string | null;
+    secUid?: string | null;
+    avatar?: string | null;
+    isPrivate?: boolean | null;
+    isVerified?: boolean | null;
+    followerCount?: number | null;
+    followingCount?: number | null;
+    likeCount?: number | null;
+    postCount?: number | null;
+    language?: string | null;
+    region?: string | null;
+    createdAt?: string | null;
+    usernameModifyTime?: string | null;
+    lastFetch?: string | null;
+    lastFetchDatetime?: string | null;
+    xLastUpdated?: string | null;
+    aggRelevance?: number | null;
+    relevantPostsCount?: number | null;
+    relevantPostsLikesSum?: number | null;
+    relevantPostsCommentsSum?: number | null;
+    relevantPostsPlaysSum?: number | null;
+    relevantPostsForwardsSum?: number | null;
+    [key: string]: unknown;
+}
+interface TiktokComment {
+    id?: string | null;
+    postId?: string | null;
+    userId?: string | null;
+    username?: string | null;
+    text?: string | null;
+    likeCount?: number | null;
+    createdAt?: string | null;
+    createdAtTimestamp?: number | null;
+    createdAtDate?: string | null;
+    lastFetch?: string | null;
+    lastFetchDatetime?: string | null;
+    xLastUpdated?: string | null;
+    [key: string]: unknown;
+}
+
+declare class TiktokNamespace extends BaseNamespace {
+    getPostsByIds(postIds: string[], options?: {
+        fields?: string[];
+        forceLatest?: boolean;
+    }): Promise<TiktokPost[]>;
+    getPostsByUser(identifier: string, options?: {
+        identifierType?: string;
+        fields?: string[];
+        startDate?: string;
+        endDate?: string;
+        forceLatest?: boolean;
+        responseType?: ResponseType;
+        limit?: number;
+    }): Promise<PaginatedResult<TiktokPost>>;
+    searchPosts(query: string, options?: {
+        fields?: string[];
+        startDate?: string;
+        endDate?: string;
+        forceLatest?: boolean;
+        responseType?: ResponseType;
+        limit?: number;
+    }): Promise<PaginatedResult<TiktokPost>>;
+    getComments(postId: string, options?: {
+        fields?: string[];
+        startDate?: string;
+        endDate?: string;
+        forceLatest?: boolean;
+    }): Promise<PaginatedResult<TiktokComment>>;
+    getUser(identifier: string, options?: {
+        identifierType?: string;
+        fields?: string[];
+    }): Promise<TiktokUser>;
+    searchUsers(name: string, options?: {
+        limit?: number;
+        fields?: string[];
+    }): Promise<TiktokUser[]>;
+    getUsersByKeywords(query: string, options?: {
+        fields?: string[];
+        startDate?: string;
+        endDate?: string;
+        forceLatest?: boolean;
+        responseType?: ResponseType;
+        limit?: number;
+    }): Promise<PaginatedResult<TiktokUser>>;
+}
+
 declare class XpozClient {
     twitter: TwitterNamespace;
     instagram: InstagramNamespace;
     reddit: RedditNamespace;
+    tiktok: TiktokNamespace;
     private transport;
     private versionCheck;
     constructor(options?: {
@@ -594,8 +721,8 @@ declare class OperationCancelledError extends XpozError {
     constructor(operationId: string);
 }
 
-declare const VERSION = "0.2.1";
+declare const VERSION = "0.3.1";
 
 declare function checkForUpdates(): Promise<void>;
 
-export { AuthenticationError, type InstagramComment, type InstagramPost, type InstagramUser, OperationCancelledError, OperationFailedError, OperationTimeoutError, PaginatedResult, type PaginationInfo, type RedditComment, type RedditPost, type RedditPostWithComments, type RedditSubreddit, type RedditUser, ResponseType, type SubredditWithPosts, type TwitterPost, type TwitterUser, VERSION, XpozClient, XpozConnectionError, XpozError, checkForUpdates };
+export { AuthenticationError, type InstagramComment, type InstagramPost, type InstagramUser, OperationCancelledError, OperationFailedError, OperationTimeoutError, PaginatedResult, type PaginationInfo, type RedditComment, type RedditPost, type RedditPostWithComments, type RedditSubreddit, type RedditUser, ResponseType, type SubredditWithPosts, type TiktokComment, type TiktokPost, type TiktokUser, type TwitterPost, type TwitterUser, VERSION, XpozClient, XpozConnectionError, XpozError, checkForUpdates };

package/dist/index.js

@@ -248,10 +248,18 @@ function coerce(value) {
 }
 
 // src/version.ts
-var VERSION = "0.2.1";
+var VERSION = "0.3.1";
 
 // src/mcp/transport.ts
 var USER_AGENT = `xpoz-ts-sdk/${VERSION}`;
+function getProxyUrl() {
+  return process.env.HTTPS_PROXY ?? process.env.https_proxy ?? process.env.HTTP_PROXY ?? process.env.http_proxy;
+}
+async function createProxyFetch(proxyUrl) {
+  const { ProxyAgent, fetch: undiciFetch } = await import("undici");
+  const dispatcher = new ProxyAgent(proxyUrl);
+  return ((input, init) => undiciFetch(input, { ...init, dispatcher }));
+}
 var McpTransport = class {
   serverUrl;
   apiKey;
@@ -266,8 +274,11 @@ var McpTransport = class {
       "User-Agent": USER_AGENT,
       Authorization: `Bearer ${this.apiKey}`
     };
+    const proxyUrl = getProxyUrl();
+    const customFetch = proxyUrl ? await createProxyFetch(proxyUrl) : void 0;
     this.transport = new StreamableHTTPClientTransport(new URL(this.serverUrl), {
-      requestInit: { headers }
+      requestInit: { headers },
+      ...customFetch ? { fetch: customFetch } : {}
     });
     this.client = new Client(
       { name: "xpoz-ts-sdk", version: VERSION },
@@ -277,6 +288,10 @@ var McpTransport = class {
   }
   async close() {
     if (this.client) {
+      try {
+        await this.transport?.terminateSession();
+      } catch {
+      }
       try {
         await this.client.close();
       } catch {
@@ -535,6 +550,7 @@ var GET_TWITTER_COMMENTS = "getTwitterPostComments";
 var GET_TWITTER_POST_INTERACTING_USERS = "getTwitterPostInteractingUsers";
 var COUNT_TWEETS = "countTweets";
 var GET_TWITTER_USER = "getTwitterUser";
+var GET_TWITTER_USERS = "getTwitterUsers";
 var SEARCH_TWITTER_USERS = "searchTwitterUsers";
 var GET_TWITTER_USER_CONNECTIONS = "getTwitterUserConnections";
 var GET_TWITTER_USERS_BY_KEYWORDS = "getTwitterUsersByKeywords";
@@ -556,6 +572,13 @@ var GET_REDDIT_USERS_BY_KEYWORDS = "getRedditUsersByKeywords";
 var SEARCH_REDDIT_SUBREDDITS = "searchRedditSubreddits";
 var GET_REDDIT_SUBREDDIT_WITH_POSTS = "getRedditSubredditWithPostsByName";
 var GET_REDDIT_SUBREDDITS_BY_KEYWORDS = "getRedditSubredditsByKeywords";
+var GET_TIKTOK_POSTS_BY_IDS = "getTiktokPostsByIds";
+var GET_TIKTOK_POSTS_BY_USER = "getTiktokPostsByUser";
+var SEARCH_TIKTOK_POSTS = "getTiktokPostsByKeywords";
+var GET_TIKTOK_COMMENTS = "getTiktokCommentsByPostId";
+var GET_TIKTOK_USER = "getTiktokUser";
+var SEARCH_TIKTOK_USERS = "searchTiktokUsers";
+var GET_TIKTOK_USERS_BY_KEYWORDS = "getTiktokUsersByKeywords";
 
 // src/namespaces/twitter.ts
 function parseTwitterPost(item) {
@@ -567,7 +590,10 @@ function parseUser(item) {
 var TwitterNamespace = class extends BaseNamespace {
   async getPostsByIds(postIds, options = {}) {
     const args = this.buildArgs({ postIds, ...options });
-    const result = await this.callAndMaybePoll(GET_TWITTER_POSTS_BY_IDS, args);
+    const result = await this.callAndMaybePoll(
+      GET_TWITTER_POSTS_BY_IDS,
+      args
+    );
     return (result["results"] ?? []).map(parseTwitterPost);
   }
   async getPostsByAuthor(identifier, options = {}) {
@@ -580,8 +606,16 @@ var TwitterNamespace = class extends BaseNamespace {
       responseType: options.responseType,
       limit: options.limit
     });
-    const result = await this.callAndMaybePoll(GET_TWITTER_POSTS_BY_AUTHOR, args);
-    return this.buildPaginatedResult(result, parseTwitterPost, GET_TWITTER_POSTS_BY_AUTHOR, args);
+    const result = await this.callAndMaybePoll(
+      GET_TWITTER_POSTS_BY_AUTHOR,
+      args
+    );
+    return this.buildPaginatedResult(
+      result,
+      parseTwitterPost,
+      GET_TWITTER_POSTS_BY_AUTHOR,
+      args
+    );
   }
   async searchPosts(query, options = {}) {
     const args = this.buildArgs({
@@ -592,6 +626,7 @@ var TwitterNamespace = class extends BaseNamespace {
       authorUsername: options.authorUsername,
       authorId: options.authorId,
       language: options.language,
+      filterOutRetweets: options.filterOutRetweets,
       forceLatest: options.forceLatest,
       responseType: options.responseType,
       limit: options.limit
@@ -599,30 +634,70 @@ var TwitterNamespace = class extends BaseNamespace {
     if (options.responseType === "csv" /* Csv */) {
       const raw = await this.callTool(SEARCH_TWITTER_POSTS, args);
       const exportOpId = raw["operationId"] ?? raw["dataDumpExportOperationId"] ?? null;
-      const csvRaw = { results: [], dataDumpExportOperationId: exportOpId };
-      return this.buildPaginatedResult(csvRaw, parseTwitterPost, SEARCH_TWITTER_POSTS, args);
+      const csvRaw = {
+        results: [],
+        dataDumpExportOperationId: exportOpId
+      };
+      return this.buildPaginatedResult(
+        csvRaw,
+        parseTwitterPost,
+        SEARCH_TWITTER_POSTS,
+        args
+      );
     }
-    const result = await this.callAndMaybePoll(SEARCH_TWITTER_POSTS, args);
-    return this.buildPaginatedResult(result, parseTwitterPost, SEARCH_TWITTER_POSTS, args);
+    const result = await this.callAndMaybePoll(
+      SEARCH_TWITTER_POSTS,
+      args
+    );
+    return this.buildPaginatedResult(
+      result,
+      parseTwitterPost,
+      SEARCH_TWITTER_POSTS,
+      args
+    );
   }
   async getRetweets(postId, options = {}) {
     const args = this.buildArgs({ postId, ...options });
-    const result = await this.callAndMaybePoll(GET_TWITTER_RETWEETS, args);
-    return this.buildPaginatedResult(result, parseTwitterPost, GET_TWITTER_RETWEETS, args);
+    const result = await this.callAndMaybePoll(
+      GET_TWITTER_RETWEETS,
+      args
+    );
+    return this.buildPaginatedResult(
+      result,
+      parseTwitterPost,
+      GET_TWITTER_RETWEETS,
+      args
+    );
   }
   async getQuotes(postId, options = {}) {
     const args = this.buildArgs({ postId, ...options });
     const result = await this.callAndMaybePoll(GET_TWITTER_QUOTES, args);
-    return this.buildPaginatedResult(result, parseTwitterPost, GET_TWITTER_QUOTES, args);
+    return this.buildPaginatedResult(
+      result,
+      parseTwitterPost,
+      GET_TWITTER_QUOTES,
+      args
+    );
   }
   async getComments(postId, options = {}) {
     const args = this.buildArgs({ postId, ...options });
-    const result = await this.callAndMaybePoll(GET_TWITTER_COMMENTS, args);
-    return this.buildPaginatedResult(result, parseTwitterPost, GET_TWITTER_COMMENTS, args);
+    const result = await this.callAndMaybePoll(
+      GET_TWITTER_COMMENTS,
+      args
+    );
+    return this.buildPaginatedResult(
+      result,
+      parseTwitterPost,
+      GET_TWITTER_COMMENTS,
+      args
+    );
   }
   async getPostInteractingUsers(postId, interactionType, options = {}) {
     const args = this.buildArgs({ postId, interactionType, ...options });
-    const result = await this.callAndMaybePoll(GET_TWITTER_POST_INTERACTING_USERS, args);
+    const result = await this.callAndMaybePoll(
+      GET_TWITTER_POST_INTERACTING_USERS,
+      args
+    );
     return this.buildPaginatedResult(
       result,
       parseUser,
@@ -644,6 +719,16 @@ var TwitterNamespace = class extends BaseNamespace {
     }
     return Number(count);
   }
+  async getUsers(identifiers, options = {}) {
+    const args = this.buildArgs({
+      identifiers,
+      identifierType: options.identifierType ?? "username",
+      fields: options.fields,
+      forceLatest: options.forceLatest
+    });
+    const result = await this.callAndMaybePoll(GET_TWITTER_USERS, args);
+    return (result["results"] ?? []).map(parseUser);
+  }
   async getUser(identifier, options = {}) {
     const args = this.buildArgs({
       identifier,
@@ -659,12 +744,18 @@ var TwitterNamespace = class extends BaseNamespace {
   }
   async searchUsers(name, options = {}) {
     const args = this.buildArgs({ name, ...options });
-    const result = await this.callAndMaybePoll(SEARCH_TWITTER_USERS, args);
+    const result = await this.callAndMaybePoll(
+      SEARCH_TWITTER_USERS,
+      args
+    );
     return (result["results"] ?? []).map(parseUser);
   }
   async getUserConnections(username, connectionType, options = {}) {
     const args = this.buildArgs({ username, connectionType, ...options });
-    const result = await this.callAndMaybePoll(GET_TWITTER_USER_CONNECTIONS, args);
+    const result = await this.callAndMaybePoll(
+      GET_TWITTER_USER_CONNECTIONS,
+      args
+    );
     return this.buildPaginatedResult(
       result,
       parseUser,
@@ -674,7 +765,10 @@ var TwitterNamespace = class extends BaseNamespace {
   }
   async getUsersByKeywords(query, options = {}) {
     const args = this.buildArgs({ query, ...options });
-    const result = await this.callAndMaybePoll(GET_TWITTER_USERS_BY_KEYWORDS, args);
+    const result = await this.callAndMaybePoll(
+      GET_TWITTER_USERS_BY_KEYWORDS,
+      args
+    );
     return this.buildPaginatedResult(
       result,
       parseUser,
@@ -895,6 +989,89 @@ var RedditNamespace = class extends BaseNamespace {
   }
 };
 
+// src/namespaces/tiktok.ts
+function parsePost3(item) {
+  return item;
+}
+function parseUser4(item) {
+  return item;
+}
+function parseComment3(item) {
+  return item;
+}
+var TiktokNamespace = class extends BaseNamespace {
+  async getPostsByIds(postIds, options = {}) {
+    const args = this.buildArgs({ postIds, ...options });
+    const result = await this.callAndMaybePoll(GET_TIKTOK_POSTS_BY_IDS, args);
+    return (result["results"] ?? []).map(parsePost3);
+  }
+  async getPostsByUser(identifier, options = {}) {
+    const args = this.buildArgs({
+      identifier,
+      identifierType: options.identifierType ?? "username",
+      fields: options.fields,
+      startDate: options.startDate,
+      endDate: options.endDate,
+      forceLatest: options.forceLatest,
+      responseType: options.responseType,
+      limit: options.limit
+    });
+    const result = await this.callAndMaybePoll(GET_TIKTOK_POSTS_BY_USER, args);
+    return this.buildPaginatedResult(
+      result,
+      parsePost3,
+      GET_TIKTOK_POSTS_BY_USER,
+      args
+    );
+  }
+  async searchPosts(query, options = {}) {
+    const args = this.buildArgs({
+      query,
+      fields: options.fields,
+      startDate: options.startDate,
+      endDate: options.endDate,
+      forceLatest: options.forceLatest,
+      responseType: options.responseType,
+      limit: options.limit
+    });
+    const result = await this.callAndMaybePoll(SEARCH_TIKTOK_POSTS, args);
+    return this.buildPaginatedResult(result, parsePost3, SEARCH_TIKTOK_POSTS, args);
+  }
+  async getComments(postId, options = {}) {
+    const args = this.buildArgs({ postId, ...options });
+    const result = await this.callAndMaybePoll(GET_TIKTOK_COMMENTS, args);
+    return this.buildPaginatedResult(result, parseComment3, GET_TIKTOK_COMMENTS, args);
+  }
+  async getUser(identifier, options = {}) {
+    const args = this.buildArgs({
+      identifier,
+      identifierType: options.identifierType ?? "username",
+      fields: options.fields
+    });
+    const result = await this.callAndMaybePoll(GET_TIKTOK_USER, args);
+    const results = result["results"];
+    if (Array.isArray(results) && results.length > 0) {
+      return results[0];
+    }
+    return result;
+  }
+  async searchUsers(name, options = {}) {
+    const args = this.buildArgs({ name, ...options });
+    const result = await this.callAndMaybePoll(SEARCH_TIKTOK_USERS, args);
+    return (result["results"] ?? []).map(parseUser4);
+  }
+  async getUsersByKeywords(query, options = {}) {
+    const args = this.buildArgs({ query, ...options });
+    const result = await this.callAndMaybePoll(GET_TIKTOK_USERS_BY_KEYWORDS, args);
+    return this.buildPaginatedResult(
+      result,
+      parseUser4,
+      GET_TIKTOK_USERS_BY_KEYWORDS,
+      args
+    );
+  }
+};
+
 // src/versionCheck.ts
 var NPM_REGISTRY_URL = "https://registry.npmjs.org/@xpoz/xpoz/latest";
 var CHECK_TIMEOUT_MS = 3e3;
@@ -940,6 +1117,7 @@ var XpozClient = class {
   twitter;
   instagram;
   reddit;
+  tiktok;
   transport;
   versionCheck;
   constructor(options = {}) {
@@ -957,6 +1135,7 @@ var XpozClient = class {
     this.twitter = new TwitterNamespace(callTool, timeoutMs);
     this.instagram = new InstagramNamespace(callTool, timeoutMs);
     this.reddit = new RedditNamespace(callTool, timeoutMs);
+    this.tiktok = new TiktokNamespace(callTool, timeoutMs);
   }
   async connect() {
     await this.transport.connect();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xpoz/xpoz",
-  "version": "0.2.1",
+  "version": "0.3.1",
   "description": "TypeScript SDK for the Xpoz social media intelligence platform",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -23,7 +23,8 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.0"
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "undici": "^7.24.6"
   },
   "devDependencies": {
     "@types/node": "^25.3.0",