@xpoz/xpoz 0.3.2 → 0.4.1

package/README.md

@@ -30,7 +30,7 @@ The SDK wraps Xpoz's [MCP](https://modelcontextprotocol.io) server, abstracting
 
 ## Features
 
-- **30 data methods** across Twitter, Instagram, and Reddit
+- **40 data methods** across Twitter, Instagram, Reddit, and TikTok
 - **Fully async** — all methods return `Promise<T>`
 - **Automatic operation polling** — long-running queries are abstracted away
 - **Response types** — choose between fast (immediate), paging (full pagination), or CSV export
@@ -38,7 +38,7 @@ The SDK wraps Xpoz's [MCP](https://modelcontextprotocol.io) server, abstracting
 - **CSV export** — `exportCsv()` on any paginated result
 - **Field selection** — request only the fields you need
 - **TypeScript-first** — fully typed results with autocomplete support
-- **Namespaced API** — `client.twitter.*`, `client.instagram.*`, `client.reddit.*`
+- **Namespaced API** — `client.twitter.*`, `client.instagram.*`, `client.reddit.*`, `client.tiktok.*`, `client.tracking.*`
 
 ## Quick Start
 
@@ -200,10 +200,12 @@ The following methods accept both `responseType` and `limit`:
 - `twitter.getPostsByAuthor()`, `twitter.searchPosts()`, `twitter.getUsersByKeywords()`
 - `instagram.getPostsByUser()`, `instagram.searchPosts()`, `instagram.getUsersByKeywords()`
 - `reddit.searchPosts()`
+- `tiktok.getPostsByUser()`, `tiktok.searchPosts()`, `tiktok.getUsersByKeywords()`
 
 These methods accept `limit` only:
 
 - `twitter.searchUsers()`, `instagram.searchUsers()`, `reddit.searchUsers()`, `reddit.searchSubreddits()`
+- `tiktok.searchUsers()`
 
 ## Query Syntax
 
@@ -574,6 +576,122 @@ const subs = await client.reddit.getSubredditsByKeywords("cryptocurrency");
 
 ---
 
+### TikTok — `client.tiktok`
+
+#### `getUser(identifier, options?) -> Promise<TiktokUser>`
+
+```typescript
+const user = await client.tiktok.getUser("charlidamelio");
+console.log(`${user.nickname} — ${user.followerCount?.toLocaleString()} followers`);
+
+// By numeric ID
+const user = await client.tiktok.getUser("123456789", { identifierType: "id" });
+```
+
+#### `searchUsers(name, options?) -> Promise<TiktokUser[]>`
+
+Search users by name. Use `limit` to adjust the number of results.
+
+```typescript
+const users = await client.tiktok.searchUsers("charli");
+const topFive = await client.tiktok.searchUsers("charli", { limit: 5 });
+```
+
+#### `getUsersByKeywords(query, options?) -> Promise<PaginatedResult<TiktokUser>>`
+
+Find users who authored posts matching a keyword query. Supports `responseType` and `limit`.
+
+```typescript
+const users = await client.tiktok.getUsersByKeywords('"machine learning"', {
+  responseType: ResponseType.Fast,
+  limit: 20,
+});
+```
+
+#### `getPostsByIds(postIds, options?) -> Promise<TiktokPost[]>`
+
+Get 1-100 posts by their IDs.
+
+```typescript
+const posts = await client.tiktok.getPostsByIds(["7123456789012345678"]);
+```
+
+#### `getPostsByUser(identifier, options?) -> Promise<PaginatedResult<TiktokPost>>`
+
+Get all posts by a user. Supports `responseType` and `limit`.
+
+```typescript
+const results = await client.tiktok.getPostsByUser("charlidamelio", {
+  startDate: "2025-01-01",
+  responseType: ResponseType.Fast,
+  limit: 50,
+});
+```
+
+#### `searchPosts(query, options?) -> Promise<PaginatedResult<TiktokPost>>`
+
+Full-text search with filters. Supports `responseType` and `limit`.
+
+```typescript
+const results = await client.tiktok.searchPosts("travel vlog", {
+  startDate: "2025-01-01",
+  responseType: ResponseType.Fast,
+  limit: 30,
+});
+```
+
+#### `getComments(postId, options?) -> Promise<PaginatedResult<TiktokComment>>`
+
+```typescript
+const comments = await client.tiktok.getComments("7123456789012345678");
+```
+
+---
+
+### Tracking — `client.tracking`
+
+Manage tracked items (keywords, users, subreddits) that Xpoz monitors on your behalf. Import the enums to build items:
+
+```typescript
+import { XpozClient, TrackedItemType, TrackedItemPlatform } from "@xpoz/xpoz";
+```
+
+#### `getTrackedItems() -> Promise<TrackedItem[]>`
+
+List all currently tracked items on your account.
+
+```typescript
+const items = await client.tracking.getTrackedItems();
+for (const item of items) {
+  console.log(`${item.platform} / ${item.type}: ${item.phrase}`);
+}
+```
+
+#### `addTrackedItems(items) -> Promise<AddTrackedItemsResult>`
+
+Add one or more items to track.
+
+```typescript
+const result = await client.tracking.addTrackedItems([
+  { phrase: "bitcoin", type: TrackedItemType.Keyword, platform: TrackedItemPlatform.Twitter },
+  { phrase: "nasa", type: TrackedItemType.User, platform: TrackedItemPlatform.Instagram },
+]);
+console.log(`Added ${result.addedCount} items (${result.currentCount}/${result.maxTrackedItems} used)`);
+```
+
+#### `removeTrackedItems(items) -> Promise<RemoveTrackedItemsResult>`
+
+Remove one or more tracked items.
+
+```typescript
+const result = await client.tracking.removeTrackedItems([
+  { phrase: "bitcoin", type: TrackedItemType.Keyword, platform: TrackedItemPlatform.Twitter },
+]);
+console.log(`Removed ${result.removedCount} items`);
+```
+
+---
+
 ## Type Models
 
 All fields are optional and typed as their respective TypeScript types. Unknown fields are preserved on the object.
@@ -596,15 +714,20 @@ All fields are optional and typed as their respective TypeScript types. Unknown
 | `hashtags`          | `string[]` | Hashtags in tweet          |
 | `mentions`          | `string[]` | Mentioned usernames        |
 | `mediaUrls`         | `string[]` | Media attachment URLs      |
-| `urls`              | `string[]` | URLs in tweet              |
+| `urls`              | `string[]` | URLs in tweet text         |
 | `country`           | `string`   | Country (if geo-tagged)    |
 | `createdAt`         | `string`   | Creation timestamp         |
 | `createdAtDate`     | `string`   | Creation date (YYYY-MM-DD) |
 | `conversationId`    | `string`   | Thread conversation ID     |
 | `quotedTweetId`     | `string`   | ID of quoted tweet         |
 | `replyToTweetId`    | `string`   | ID of parent tweet         |
-| `isRetweet`         | `boolean`  | Whether this is a retweet  |
 | `possiblySensitive` | `boolean`  | Sensitive content flag     |
+| `isRetweet`         | `boolean`  | Whether this is a retweet  |
+| `hasBirdwatchNotes` | `boolean`  | Has community notes        |
+| `birdwatchNotesId`  | `string`   | Birdwatch note ID          |
+| `birdwatchNotesText`| `string`   | Birdwatch note text        |
+| `birdwatchNotesUrl` | `string`   | Birdwatch note URL         |
+| `status`            | `string`   | Tweet status               |
 
 ### TwitterUser
 
@@ -624,9 +747,6 @@ All fields are optional and typed as their respective TypeScript types. Unknown
 | `profileImageUrl`            | `string`  | Profile picture URL        |
 | `createdAt`                  | `string`  | Account creation timestamp |
 | `accountBasedIn`             | `string`  | Account location           |
-| `isInauthentic`              | `boolean` | Inauthenticity flag        |
-| `isInauthenticProbScore`     | `number`  | Inauthenticity probability |
-| `avgTweetsPerDayLastMonth`   | `number`  | Tweeting frequency         |
 
 ### InstagramPost
 
@@ -642,8 +762,10 @@ All fields are optional and typed as their respective TypeScript types. Unknown
 | `videoPlayCount` | `number` | Video play count           |
 | `mediaType`      | `string` | Media type                 |
 | `imageUrl`       | `string` | Image URL                  |
-| `videoUrl`       | `string` | Video URL                  |
-| `createdAtDate`  | `string` | Creation date              |
+| `videoUrl`                          | `string`  | Video URL                         |
+| `createdAtDate`                     | `string`  | Creation date                     |
+| `genAiChatWithAiCtaInfo`            | `string`  | Gen AI chat CTA info              |
+| `hasHighRiskGenAiInformTreatment`   | `boolean` | High risk Gen AI treatment flag   |
 
 ### InstagramUser
 
@@ -731,6 +853,88 @@ All fields are optional and typed as their respective TypeScript types. Unknown
 | `over18`            | `boolean` | NSFW flag         |
 | `createdAtDate`     | `string`  | Creation date     |
 
+### TiktokPost
+
+| Field                        | Type      | Description                  |
+| ---------------------------- | --------- | ---------------------------- |
+| `id`                         | `string`  | Post ID                      |
+| `description`                | `string`  | Post caption/description     |
+| `descriptionLanguage`        | `string`  | Language of description      |
+| `userId`                     | `string`  | Author user ID               |
+| `username`                   | `string`  | Author username              |
+| `nickname`                   | `string`  | Author display name          |
+| `likeCount`                  | `number`  | Number of likes              |
+| `commentCount`               | `number`  | Number of comments           |
+| `playCount`                  | `number`  | Video play count             |
+| `collectCount`               | `number`  | Number of collects/saves     |
+| `downloadCount`              | `number`  | Number of downloads          |
+| `forwardCount`               | `number`  | Number of forwards/shares    |
+| `videoThumbnail`             | `string`  | Thumbnail URL                |
+| `postType`                   | `number`  | Post type code               |
+| `isPrivate`                  | `boolean` | Private post flag            |
+| `createdAt`                  | `string`  | Creation timestamp           |
+| `createdAtDate`              | `string`  | Creation date (YYYY-MM-DD)   |
+
+### TiktokUser
+
+| Field            | Type      | Description              |
+| ---------------- | --------- | ------------------------ |
+| `id`             | `string`  | User ID                  |
+| `username`       | `string`  | Username                 |
+| `nickname`       | `string`  | Display name             |
+| `signature`      | `string`  | Bio text                 |
+| `secUid`         | `string`  | Secure user ID           |
+| `avatar`         | `string`  | Profile picture URL      |
+| `isPrivate`      | `boolean` | Private account          |
+| `isVerified`     | `boolean` | Verified status          |
+| `followerCount`  | `number`  | Number of followers      |
+| `followingCount` | `number`  | Number of following      |
+| `likeCount`      | `number`  | Total likes received     |
+| `postCount`      | `number`  | Total posts              |
+| `language`       | `string`  | Profile language         |
+| `region`         | `string`  | Account region           |
+| `createdAt`      | `string`  | Account creation date    |
+
+### TiktokComment
+
+| Field           | Type     | Description              |
+| --------------- | -------- | ------------------------ |
+| `id`            | `string` | Comment ID               |
+| `postId`        | `string` | Parent post ID           |
+| `userId`        | `string` | Author user ID           |
+| `username`      | `string` | Author username          |
+| `text`          | `string` | Comment text             |
+| `likeCount`     | `number` | Number of likes          |
+| `createdAt`     | `string` | Creation timestamp       |
+| `createdAtDate` | `string` | Creation date (YYYY-MM-DD) |
+
+### TrackedItem
+
+| Field      | Type                   | Description                                              |
+| ---------- | ---------------------- | -------------------------------------------------------- |
+| `phrase`   | `string`               | Keyword, username, or subreddit name to track            |
+| `type`     | `TrackedItemType`      | `"keyword"`, `"user"`, or `"subreddit"`                  |
+| `platform` | `TrackedItemPlatform`  | `"twitter"`, `"instagram"`, `"reddit"`, or `"tiktok"`   |
+
+### AddTrackedItemsResult
+
+| Field             | Type      | Description                        |
+| ----------------- | --------- | ---------------------------------- |
+| `success`         | `boolean` | Whether the operation succeeded    |
+| `addedCount`      | `number`  | Number of items added              |
+| `message`         | `string`  | Status message                     |
+| `currentCount`    | `number`  | Total tracked items after addition |
+| `maxTrackedItems` | `number`  | Plan limit for tracked items       |
+| `planName`        | `string`  | Current plan name                  |
+
+### RemoveTrackedItemsResult
+
+| Field          | Type      | Description                     |
+| -------------- | --------- | ------------------------------- |
+| `success`      | `boolean` | Whether the operation succeeded |
+| `removedCount` | `number`  | Number of items removed         |
+| `message`      | `string`  | Status message                  |
+
 ### Composite Types
 
 **`RedditPostWithComments`** — returned by `getPostWithComments()`:

package/dist/index.cjs

@@ -296,7 +296,7 @@ function coerce(value) {
 }
 
 // src/version.ts
-var VERSION = "0.3.2";
+var VERSION = "0.4.1";
 
 // src/mcp/transport.ts
 var USER_AGENT = `xpoz-ts-sdk/${VERSION}`;
@@ -439,14 +439,14 @@ async function waitForResult(callTool, operationId, timeoutMs = DEFAULT_TIMEOUT_
   while (true) {
     const result = await callTool("checkOperationStatus", { operationId });
     const status = result["status"];
-    if (status === "failed") {
+    if (status === "error") {
       const error = result["error"] ?? "Unknown error";
       throw new OperationFailedError(operationId, String(error));
     }
     if (status === "cancelled") {
       throw new OperationCancelledError(operationId);
     }
-    if (status === "completed" || "results" in result || "downloadUrl" in result) {
+    if (status === "success" || status === "no_data" || "results" in result || "downloadUrl" in result) {
       return result;
     }
     const elapsed = Date.now() - start;
@@ -534,7 +534,13 @@ var BaseNamespace = class {
   }
   async callAndMaybePoll(toolName, args) {
     const result = await this.callTool(toolName, args);
-    if ("results" in result) {
+    if (result["status"] === "error") {
+      throw new OperationFailedError(
+        "",
+        String(result["error"] ?? "Unknown error")
+      );
+    }
+    if (result["status"] === "success" || result["status"] === "no_data" || "results" in result) {
       return result;
     }
     const operationId = result["operationId"];

package/dist/index.d.cts

@@ -53,11 +53,15 @@ interface TwitterPost {
     conversationId?: string | null;
     lang?: string | null;
     source?: string | null;
-    status?: string | null;
     deleted?: boolean | null;
     suspended?: boolean | null;
     possiblySensitive?: boolean | null;
     isRetweet?: boolean | null;
+    hasBirdwatchNotes?: boolean | null;
+    birdwatchNotesId?: string | null;
+    birdwatchNotesText?: string | null;
+    birdwatchNotesUrl?: string | null;
+    status?: string | null;
     likeCount?: number | null;
     retweetCount?: number | null;
     replyCount?: number | null;
@@ -71,22 +75,16 @@ interface TwitterPost {
     replyToUsername?: string | null;
     originalTweetId?: string | null;
     editedTweets?: string[] | null;
-    replySettings?: string | null;
     hashtags?: string[] | null;
     mentions?: string[] | null;
     mediaUrls?: string[] | null;
-    grokGeneratedContent?: Record<string, unknown>[] | null;
     urls?: string[] | null;
+    grokGeneratedContent?: Record<string, unknown>[] | null;
     country?: string | null;
     region?: string | null;
     city?: string | null;
-    hasBirdwatchNotes?: boolean | null;
-    birdwatchNotesId?: string | null;
-    birdwatchNotesText?: string | null;
-    birdwatchNotesUrl?: string | null;
     createdAt?: string | null;
     createdAtDate?: string | null;
-    xFetchedAt?: string | null;
     [key: string]: unknown;
 }
 interface TwitterUser {
@@ -115,25 +113,13 @@ interface TwitterUser {
     locationAccurate?: boolean | null;
     label?: string | null;
     labelType?: string | null;
-    collectedFollowingCount?: number | null;
-    collectedFollowersCount?: number | null;
-    collectedFollowersCoverage?: number | null;
-    collectedFollowingCoverage?: number | null;
-    avgTweetsPerDayLastMonth?: number | null;
     nLang?: number | null;
     nLangsFiltered?: number | null;
-    inauthenticType?: string | null;
-    isInauthentic?: boolean | null;
-    isInauthenticProbScore?: number | null;
-    isInauthenticCalculatedAt?: string | null;
     verifiedSinceDatetime?: string | null;
     usernameChanges?: string[] | null;
     lastUsernameChangeDatetime?: string | null;
     createdAt?: string | null;
-    createdAtDate?: string | null;
-    xFetchedAt?: string | null;
     modifiedAt?: string | null;
-    xModifiedAt?: string | null;
     aggRelevance?: number | null;
     relevantTweetsCount?: number | null;
     relevantTweetsImpressionsSum?: number | null;
@@ -246,12 +232,11 @@ interface InstagramPost {
     reshareCount?: number | null;
     videoPlayCount?: number | null;
     location?: string | null;
+    genAiChatWithAiCtaInfo?: string | null;
+    hasHighRiskGenAiInformTreatment?: boolean | null;
     createdAt?: string | null;
     createdAtTimestamp?: number | null;
     createdAtDate?: string | null;
-    lastFetch?: string | null;
-    lastFetchDatetime?: string | null;
-    xLastUpdated?: string | null;
     [key: string]: unknown;
 }
 interface InstagramUser {
@@ -269,9 +254,6 @@ interface InstagramUser {
     profileUrl?: string | null;
     externalUrl?: string | null;
     hasAnonymousProfilePicture?: boolean | null;
-    lastFetch?: string | null;
-    lastFetchDatetime?: string | null;
-    xLastUpdated?: string | null;
     aggRelevance?: number | null;
     relevantPostsCount?: number | null;
     relevantPostsLikesSum?: number | null;
@@ -299,9 +281,6 @@ interface InstagramComment {
     createdAt?: string | null;
     createdAtTimestamp?: number | null;
     createdAtDate?: string | null;
-    lastFetch?: string | null;
-    lastFetchDatetime?: string | null;
-    xLastUpdated?: string | null;
     [key: string]: unknown;
 }
 
@@ -392,9 +371,6 @@ interface RedditPost {
     createdAt?: string | null;
     createdAtTimestamp?: number | null;
     createdAtDate?: string | null;
-    lastFetch?: string | null;
-    lastFetchDatetime?: string | null;
-    xLastUpdated?: string | null;
     [key: string]: unknown;
 }
 interface RedditUser {
@@ -425,9 +401,6 @@ interface RedditUser {
     createdAt?: string | null;
     createdAtTimestamp?: number | null;
     createdAtDate?: string | null;
-    lastFetch?: string | null;
-    lastFetchDatetime?: string | null;
-    xLastUpdated?: string | null;
     aggRelevance?: number | null;
     relevantPostsCount?: number | null;
     relevantPostsUpvotesSum?: number | null;
@@ -456,9 +429,6 @@ interface RedditComment {
     createdAt?: string | null;
     createdAtTimestamp?: number | null;
     createdAtDate?: string | null;
-    lastFetch?: string | null;
-    lastFetchDatetime?: string | null;
-    xLastUpdated?: string | null;
     [key: string]: unknown;
 }
 interface RedditSubreddit {
@@ -481,9 +451,6 @@ interface RedditSubreddit {
     createdAt?: string | null;
     createdAtTimestamp?: number | null;
     createdAtDate?: string | null;
-    lastFetch?: string | null;
-    lastFetchDatetime?: string | null;
-    xLastUpdated?: string | null;
     aggRelevance?: number | null;
     relevantPostsCount?: number | null;
     relevantPostsUpvotesSum?: number | null;
@@ -578,15 +545,6 @@ interface TiktokPost {
     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 {
@@ -606,9 +564,6 @@ interface TiktokUser {
     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;
@@ -627,9 +582,6 @@ interface TiktokComment {
     createdAt?: string | null;
     createdAtTimestamp?: number | null;
     createdAtDate?: string | null;
-    lastFetch?: string | null;
-    lastFetchDatetime?: string | null;
-    xLastUpdated?: string | null;
     [key: string]: unknown;
 }
 
@@ -758,7 +710,7 @@ declare class OperationCancelledError extends XpozError {
     constructor(operationId: string);
 }
 
-declare const VERSION = "0.3.2";
+declare const VERSION = "0.4.1";
 
 declare function checkForUpdates(): Promise<void>;
 

package/dist/index.d.ts

@@ -53,11 +53,15 @@ interface TwitterPost {
     conversationId?: string | null;
     lang?: string | null;
     source?: string | null;
-    status?: string | null;
     deleted?: boolean | null;
     suspended?: boolean | null;
     possiblySensitive?: boolean | null;
     isRetweet?: boolean | null;
+    hasBirdwatchNotes?: boolean | null;
+    birdwatchNotesId?: string | null;
+    birdwatchNotesText?: string | null;
+    birdwatchNotesUrl?: string | null;
+    status?: string | null;
     likeCount?: number | null;
     retweetCount?: number | null;
     replyCount?: number | null;
@@ -71,22 +75,16 @@ interface TwitterPost {
     replyToUsername?: string | null;
     originalTweetId?: string | null;
     editedTweets?: string[] | null;
-    replySettings?: string | null;
     hashtags?: string[] | null;
     mentions?: string[] | null;
     mediaUrls?: string[] | null;
-    grokGeneratedContent?: Record<string, unknown>[] | null;
     urls?: string[] | null;
+    grokGeneratedContent?: Record<string, unknown>[] | null;
     country?: string | null;
     region?: string | null;
     city?: string | null;
-    hasBirdwatchNotes?: boolean | null;
-    birdwatchNotesId?: string | null;
-    birdwatchNotesText?: string | null;
-    birdwatchNotesUrl?: string | null;
     createdAt?: string | null;
     createdAtDate?: string | null;
-    xFetchedAt?: string | null;
     [key: string]: unknown;
 }
 interface TwitterUser {
@@ -115,25 +113,13 @@ interface TwitterUser {
     locationAccurate?: boolean | null;
     label?: string | null;
     labelType?: string | null;
-    collectedFollowingCount?: number | null;
-    collectedFollowersCount?: number | null;
-    collectedFollowersCoverage?: number | null;
-    collectedFollowingCoverage?: number | null;
-    avgTweetsPerDayLastMonth?: number | null;
     nLang?: number | null;
     nLangsFiltered?: number | null;
-    inauthenticType?: string | null;
-    isInauthentic?: boolean | null;
-    isInauthenticProbScore?: number | null;
-    isInauthenticCalculatedAt?: string | null;
     verifiedSinceDatetime?: string | null;
     usernameChanges?: string[] | null;
     lastUsernameChangeDatetime?: string | null;
     createdAt?: string | null;
-    createdAtDate?: string | null;
-    xFetchedAt?: string | null;
     modifiedAt?: string | null;
-    xModifiedAt?: string | null;
     aggRelevance?: number | null;
     relevantTweetsCount?: number | null;
     relevantTweetsImpressionsSum?: number | null;
@@ -246,12 +232,11 @@ interface InstagramPost {
     reshareCount?: number | null;
     videoPlayCount?: number | null;
     location?: string | null;
+    genAiChatWithAiCtaInfo?: string | null;
+    hasHighRiskGenAiInformTreatment?: boolean | null;
     createdAt?: string | null;
     createdAtTimestamp?: number | null;
     createdAtDate?: string | null;
-    lastFetch?: string | null;
-    lastFetchDatetime?: string | null;
-    xLastUpdated?: string | null;
     [key: string]: unknown;
 }
 interface InstagramUser {
@@ -269,9 +254,6 @@ interface InstagramUser {
     profileUrl?: string | null;
     externalUrl?: string | null;
     hasAnonymousProfilePicture?: boolean | null;
-    lastFetch?: string | null;
-    lastFetchDatetime?: string | null;
-    xLastUpdated?: string | null;
     aggRelevance?: number | null;
     relevantPostsCount?: number | null;
     relevantPostsLikesSum?: number | null;
@@ -299,9 +281,6 @@ interface InstagramComment {
     createdAt?: string | null;
     createdAtTimestamp?: number | null;
     createdAtDate?: string | null;
-    lastFetch?: string | null;
-    lastFetchDatetime?: string | null;
-    xLastUpdated?: string | null;
     [key: string]: unknown;
 }
 
@@ -392,9 +371,6 @@ interface RedditPost {
     createdAt?: string | null;
     createdAtTimestamp?: number | null;
     createdAtDate?: string | null;
-    lastFetch?: string | null;
-    lastFetchDatetime?: string | null;
-    xLastUpdated?: string | null;
     [key: string]: unknown;
 }
 interface RedditUser {
@@ -425,9 +401,6 @@ interface RedditUser {
     createdAt?: string | null;
     createdAtTimestamp?: number | null;
     createdAtDate?: string | null;
-    lastFetch?: string | null;
-    lastFetchDatetime?: string | null;
-    xLastUpdated?: string | null;
     aggRelevance?: number | null;
     relevantPostsCount?: number | null;
     relevantPostsUpvotesSum?: number | null;
@@ -456,9 +429,6 @@ interface RedditComment {
     createdAt?: string | null;
     createdAtTimestamp?: number | null;
     createdAtDate?: string | null;
-    lastFetch?: string | null;
-    lastFetchDatetime?: string | null;
-    xLastUpdated?: string | null;
     [key: string]: unknown;
 }
 interface RedditSubreddit {
@@ -481,9 +451,6 @@ interface RedditSubreddit {
     createdAt?: string | null;
     createdAtTimestamp?: number | null;
     createdAtDate?: string | null;
-    lastFetch?: string | null;
-    lastFetchDatetime?: string | null;
-    xLastUpdated?: string | null;
     aggRelevance?: number | null;
     relevantPostsCount?: number | null;
     relevantPostsUpvotesSum?: number | null;
@@ -578,15 +545,6 @@ interface TiktokPost {
     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 {
@@ -606,9 +564,6 @@ interface TiktokUser {
     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;
@@ -627,9 +582,6 @@ interface TiktokComment {
     createdAt?: string | null;
     createdAtTimestamp?: number | null;
     createdAtDate?: string | null;
-    lastFetch?: string | null;
-    lastFetchDatetime?: string | null;
-    xLastUpdated?: string | null;
     [key: string]: unknown;
 }
 
@@ -758,7 +710,7 @@ declare class OperationCancelledError extends XpozError {
     constructor(operationId: string);
 }
 
-declare const VERSION = "0.3.2";
+declare const VERSION = "0.4.1";
 
 declare function checkForUpdates(): Promise<void>;
 

package/dist/index.js

@@ -248,7 +248,7 @@ function coerce(value) {
 }
 
 // src/version.ts
-var VERSION = "0.3.2";
+var VERSION = "0.4.1";
 
 // src/mcp/transport.ts
 var USER_AGENT = `xpoz-ts-sdk/${VERSION}`;
@@ -391,14 +391,14 @@ async function waitForResult(callTool, operationId, timeoutMs = DEFAULT_TIMEOUT_
   while (true) {
     const result = await callTool("checkOperationStatus", { operationId });
     const status = result["status"];
-    if (status === "failed") {
+    if (status === "error") {
       const error = result["error"] ?? "Unknown error";
       throw new OperationFailedError(operationId, String(error));
     }
     if (status === "cancelled") {
       throw new OperationCancelledError(operationId);
     }
-    if (status === "completed" || "results" in result || "downloadUrl" in result) {
+    if (status === "success" || status === "no_data" || "results" in result || "downloadUrl" in result) {
       return result;
     }
     const elapsed = Date.now() - start;
@@ -486,7 +486,13 @@ var BaseNamespace = class {
   }
   async callAndMaybePoll(toolName, args) {
     const result = await this.callTool(toolName, args);
-    if ("results" in result) {
+    if (result["status"] === "error") {
+      throw new OperationFailedError(
+        "",
+        String(result["error"] ?? "Unknown error")
+      );
+    }
+    if (result["status"] === "success" || result["status"] === "no_data" || "results" in result) {
       return result;
     }
     const operationId = result["operationId"];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xpoz/xpoz",
-  "version": "0.3.2",
+  "version": "0.4.1",
   "description": "TypeScript SDK for the Xpoz social media intelligence platform",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -18,6 +18,8 @@
   ],
   "scripts": {
     "build": "tsup src/index.ts --format cjs,esm --dts --clean",
+    "build:scripts": "tsup src/scripts/generate-expectations.ts --format esm --out-dir dist/scripts",
+    "generate-expectations": "node dist/scripts/generate-expectations.js",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
     "prepublishOnly": "npm run build"