@xpoz/xpoz 0.2.0 → 0.3.0

package/dist/index.cjs

@@ -29,7 +29,8 @@ __export(index_exports, {
   VERSION: () => VERSION,
   XpozClient: () => XpozClient,
   XpozConnectionError: () => XpozConnectionError,
-  XpozError: () => XpozError
+  XpozError: () => XpozError,
+  checkForUpdates: () => checkForUpdates
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -283,7 +284,7 @@ function coerce(value) {
 }
 
 // src/version.ts
-var VERSION = "0.2.0";
+var VERSION = "0.3.0";
 
 // src/mcp/transport.ts
 var USER_AGENT = `xpoz-ts-sdk/${VERSION}`;
@@ -570,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";
@@ -602,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 = {}) {
@@ -615,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({
@@ -627,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
@@ -634,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,
@@ -679,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,
@@ -694,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,
@@ -709,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,
@@ -930,12 +1003,53 @@ var RedditNamespace = class extends BaseNamespace {
   }
 };
 
+// src/versionCheck.ts
+var NPM_REGISTRY_URL = "https://registry.npmjs.org/@xpoz/xpoz/latest";
+var CHECK_TIMEOUT_MS = 3e3;
+var PACKAGE_NAME = "@xpoz/xpoz";
+var hasWarned = false;
+async function checkForUpdates() {
+  if (hasWarned) return;
+  try {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), CHECK_TIMEOUT_MS);
+    const response = await fetch(NPM_REGISTRY_URL, {
+      signal: controller.signal,
+      headers: { Accept: "application/json" }
+    });
+    clearTimeout(timeout);
+    if (!response.ok) return;
+    const data = await response.json();
+    const latest = data.version;
+    if (!latest || latest === VERSION) return;
+    if (isNewerVersion(latest, VERSION)) {
+      hasWarned = true;
+      console.warn(
+        `[xpoz] A newer version of ${PACKAGE_NAME} is available: ${latest} (current: ${VERSION}). Run \`npm install ${PACKAGE_NAME}@latest\` to update.`
+      );
+    }
+  } catch {
+  }
+}
+function isNewerVersion(latestVersion, currentVersion) {
+  const latestVersionParts = latestVersion.split(".").map(Number);
+  const currentVersionParts = currentVersion.split(".").map(Number);
+  for (let i = 0; i < 3; i++) {
+    const latestVersionPart = latestVersionParts[i] ?? 0;
+    const currentVersionPart = currentVersionParts[i] ?? 0;
+    if (latestVersionPart > currentVersionPart) return true;
+    if (latestVersionPart < currentVersionPart) return false;
+  }
+  return false;
+}
+
 // src/client.ts
 var XpozClient = class {
   twitter;
   instagram;
   reddit;
   transport;
+  versionCheck;
   constructor(options = {}) {
     const apiKey = options.apiKey ?? process.env[ENV_API_KEY];
     if (!apiKey) {
@@ -943,6 +1057,7 @@ var XpozClient = class {
         `API key required. Get your token at http://xpoz.ai/get-token?utm_source=ts_sdk&utm_medium=sdk (login \u2192 copy token), then pass it as apiKey or set the ${ENV_API_KEY} environment variable.`
       );
     }
+    this.versionCheck = options.versionCheck ?? true;
     const serverUrl = options.serverUrl ?? process.env[ENV_SERVER_URL] ?? DEFAULT_SERVER_URL;
     const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
     this.transport = new McpTransport(serverUrl, apiKey);
@@ -953,6 +1068,9 @@ var XpozClient = class {
   }
   async connect() {
     await this.transport.connect();
+    if (this.versionCheck) {
+      checkForUpdates();
+    }
   }
   async close() {
     await this.transport.close();
@@ -972,5 +1090,6 @@ var XpozClient = class {
   VERSION,
   XpozClient,
   XpozConnectionError,
-  XpozError
+  XpozError,
+  checkForUpdates
 });

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[];
@@ -558,10 +564,12 @@ declare class XpozClient {
     instagram: InstagramNamespace;
     reddit: RedditNamespace;
     private transport;
+    private versionCheck;
     constructor(options?: {
         apiKey?: string;
         serverUrl?: string;
         timeoutMs?: number;
+        versionCheck?: boolean;
     });
     connect(): Promise<void>;
     close(): Promise<void>;
@@ -592,6 +600,8 @@ declare class OperationCancelledError extends XpozError {
     constructor(operationId: string);
 }
 
-declare const VERSION = "0.2.0";
+declare const VERSION = "0.3.0";
+
+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 };
+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 };

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[];
@@ -558,10 +564,12 @@ declare class XpozClient {
     instagram: InstagramNamespace;
     reddit: RedditNamespace;
     private transport;
+    private versionCheck;
     constructor(options?: {
         apiKey?: string;
         serverUrl?: string;
         timeoutMs?: number;
+        versionCheck?: boolean;
     });
     connect(): Promise<void>;
     close(): Promise<void>;
@@ -592,6 +600,8 @@ declare class OperationCancelledError extends XpozError {
     constructor(operationId: string);
 }
 
-declare const VERSION = "0.2.0";
+declare const VERSION = "0.3.0";
+
+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 };
+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 };

package/dist/index.js

@@ -248,7 +248,7 @@ function coerce(value) {
 }
 
 // src/version.ts
-var VERSION = "0.2.0";
+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,
@@ -895,12 +967,53 @@ var RedditNamespace = class extends BaseNamespace {
   }
 };
 
+// src/versionCheck.ts
+var NPM_REGISTRY_URL = "https://registry.npmjs.org/@xpoz/xpoz/latest";
+var CHECK_TIMEOUT_MS = 3e3;
+var PACKAGE_NAME = "@xpoz/xpoz";
+var hasWarned = false;
+async function checkForUpdates() {
+  if (hasWarned) return;
+  try {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), CHECK_TIMEOUT_MS);
+    const response = await fetch(NPM_REGISTRY_URL, {
+      signal: controller.signal,
+      headers: { Accept: "application/json" }
+    });
+    clearTimeout(timeout);
+    if (!response.ok) return;
+    const data = await response.json();
+    const latest = data.version;
+    if (!latest || latest === VERSION) return;
+    if (isNewerVersion(latest, VERSION)) {
+      hasWarned = true;
+      console.warn(
+        `[xpoz] A newer version of ${PACKAGE_NAME} is available: ${latest} (current: ${VERSION}). Run \`npm install ${PACKAGE_NAME}@latest\` to update.`
+      );
+    }
+  } catch {
+  }
+}
+function isNewerVersion(latestVersion, currentVersion) {
+  const latestVersionParts = latestVersion.split(".").map(Number);
+  const currentVersionParts = currentVersion.split(".").map(Number);
+  for (let i = 0; i < 3; i++) {
+    const latestVersionPart = latestVersionParts[i] ?? 0;
+    const currentVersionPart = currentVersionParts[i] ?? 0;
+    if (latestVersionPart > currentVersionPart) return true;
+    if (latestVersionPart < currentVersionPart) return false;
+  }
+  return false;
+}
+
 // src/client.ts
 var XpozClient = class {
   twitter;
   instagram;
   reddit;
   transport;
+  versionCheck;
   constructor(options = {}) {
     const apiKey = options.apiKey ?? process.env[ENV_API_KEY];
     if (!apiKey) {
@@ -908,6 +1021,7 @@ var XpozClient = class {
         `API key required. Get your token at http://xpoz.ai/get-token?utm_source=ts_sdk&utm_medium=sdk (login \u2192 copy token), then pass it as apiKey or set the ${ENV_API_KEY} environment variable.`
       );
     }
+    this.versionCheck = options.versionCheck ?? true;
     const serverUrl = options.serverUrl ?? process.env[ENV_SERVER_URL] ?? DEFAULT_SERVER_URL;
     const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
     this.transport = new McpTransport(serverUrl, apiKey);
@@ -918,6 +1032,9 @@ var XpozClient = class {
   }
   async connect() {
     await this.transport.connect();
+    if (this.versionCheck) {
+      checkForUpdates();
+    }
   }
   async close() {
     await this.transport.close();
@@ -936,5 +1053,6 @@ export {
   VERSION,
   XpozClient,
   XpozConnectionError,
-  XpozError
+  XpozError,
+  checkForUpdates
 };

package/package.json

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