@xpoz/xpoz 0.2.0 → 0.2.1

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.2.1";
 
 // src/mcp/transport.ts
 var USER_AGENT = `xpoz-ts-sdk/${VERSION}`;
@@ -930,12 +931,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 +985,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 +996,9 @@ var XpozClient = class {
   }
   async connect() {
     await this.transport.connect();
+    if (this.versionCheck) {
+      checkForUpdates();
+    }
   }
   async close() {
     await this.transport.close();
@@ -972,5 +1018,6 @@ var XpozClient = class {
   VERSION,
   XpozClient,
   XpozConnectionError,
-  XpozError
+  XpozError,
+  checkForUpdates
 });

package/dist/index.d.cts

@@ -558,10 +558,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 +594,8 @@ declare class OperationCancelledError extends XpozError {
     constructor(operationId: string);
 }
 
-declare const VERSION = "0.2.0";
+declare const VERSION = "0.2.1";
 
-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 };
+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 };

package/dist/index.d.ts

@@ -558,10 +558,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 +594,8 @@ declare class OperationCancelledError extends XpozError {
     constructor(operationId: string);
 }
 
-declare const VERSION = "0.2.0";
+declare const VERSION = "0.2.1";
 
-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 };
+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 };

package/dist/index.js

@@ -248,7 +248,7 @@ function coerce(value) {
 }
 
 // src/version.ts
-var VERSION = "0.2.0";
+var VERSION = "0.2.1";
 
 // src/mcp/transport.ts
 var USER_AGENT = `xpoz-ts-sdk/${VERSION}`;
@@ -895,12 +895,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 +949,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 +960,9 @@ var XpozClient = class {
   }
   async connect() {
     await this.transport.connect();
+    if (this.versionCheck) {
+      checkForUpdates();
+    }
   }
   async close() {
     await this.transport.close();
@@ -936,5 +981,6 @@ export {
   VERSION,
   XpozClient,
   XpozConnectionError,
-  XpozError
+  XpozError,
+  checkForUpdates
 };

package/package.json

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