@xpoz/xpoz 0.2.1 → 0.3.0

package/dist/index.cjs

@@ -284,7 +284,7 @@ function coerce(value) {
 }
 
 // src/version.ts
-var VERSION = "0.2.1";
+var VERSION = "0.3.0";
 
 // src/mcp/transport.ts
 var USER_AGENT = `xpoz-ts-sdk/${VERSION}`;
@@ -571,6 +571,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";
@@ -603,7 +604,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 +620,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 +640,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 +648,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 +733,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 +758,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 +779,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,

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[];
@@ -594,7 +600,7 @@ declare class OperationCancelledError extends XpozError {
     constructor(operationId: string);
 }
 
-declare const VERSION = "0.2.1";
+declare const VERSION = "0.3.0";
 
 declare function checkForUpdates(): Promise<void>;
 

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[];
@@ -594,7 +600,7 @@ declare class OperationCancelledError extends XpozError {
     constructor(operationId: string);
 }
 
-declare const VERSION = "0.2.1";
+declare const VERSION = "0.3.0";
 
 declare function checkForUpdates(): Promise<void>;
 

package/dist/index.js

@@ -248,7 +248,7 @@ function coerce(value) {
 }
 
 // src/version.ts
-var VERSION = "0.2.1";
+var VERSION = "0.3.0";
 
 // src/mcp/transport.ts
 var USER_AGENT = `xpoz-ts-sdk/${VERSION}`;
@@ -535,6 +535,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";
@@ -567,7 +568,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 +584,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 +604,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 +612,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 +697,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 +722,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 +743,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,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xpoz/xpoz",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "TypeScript SDK for the Xpoz social media intelligence platform",
   "type": "module",
   "main": "./dist/index.cjs",