@xpoz/xpoz 0.3.1 → 0.4.0

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.
@@ -731,6 +849,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

@@ -36,6 +36,8 @@ __export(index_exports, {
   OperationTimeoutError: () => OperationTimeoutError,
   PaginatedResult: () => PaginatedResult,
   ResponseType: () => ResponseType,
+  TrackedItemPlatform: () => TrackedItemPlatform,
+  TrackedItemType: () => TrackedItemType,
   VERSION: () => VERSION,
   XpozClient: () => XpozClient,
   XpozConnectionError: () => XpozConnectionError,
@@ -294,7 +296,7 @@ function coerce(value) {
 }
 
 // src/version.ts
-var VERSION = "0.3.1";
+var VERSION = "0.4.0";
 
 // src/mcp/transport.ts
 var USER_AGENT = `xpoz-ts-sdk/${VERSION}`;
@@ -437,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;
@@ -532,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" || "results" in result) {
       return result;
     }
     const operationId = result["operationId"];
@@ -625,6 +633,9 @@ var GET_TIKTOK_COMMENTS = "getTiktokCommentsByPostId";
 var GET_TIKTOK_USER = "getTiktokUser";
 var SEARCH_TIKTOK_USERS = "searchTiktokUsers";
 var GET_TIKTOK_USERS_BY_KEYWORDS = "getTiktokUsersByKeywords";
+var GET_TRACKED_ITEMS = "getTrackedItems";
+var ADD_TRACKED_ITEMS = "addTrackedItems";
+var REMOVE_TRACKED_ITEMS = "removeTrackedItems";
 
 // src/namespaces/twitter.ts
 function parseTwitterPost(item) {
@@ -1118,6 +1129,24 @@ var TiktokNamespace = class extends BaseNamespace {
   }
 };
 
+// src/namespaces/tracking.ts
+var TrackingNamespace = class extends BaseNamespace {
+  async getTrackedItems() {
+    const result = await this.callTool(GET_TRACKED_ITEMS, {});
+    return result["data"] ?? [];
+  }
+  async addTrackedItems(items) {
+    const args = this.buildArgs({ items });
+    const result = await this.callTool(ADD_TRACKED_ITEMS, args);
+    return result;
+  }
+  async removeTrackedItems(items) {
+    const args = this.buildArgs({ items });
+    const result = await this.callTool(REMOVE_TRACKED_ITEMS, args);
+    return result;
+  }
+};
+
 // src/versionCheck.ts
 var NPM_REGISTRY_URL = "https://registry.npmjs.org/@xpoz/xpoz/latest";
 var CHECK_TIMEOUT_MS = 3e3;
@@ -1164,6 +1193,7 @@ var XpozClient = class {
   instagram;
   reddit;
   tiktok;
+  tracking;
   transport;
   versionCheck;
   constructor(options = {}) {
@@ -1182,6 +1212,7 @@ var XpozClient = class {
     this.instagram = new InstagramNamespace(callTool, timeoutMs);
     this.reddit = new RedditNamespace(callTool, timeoutMs);
     this.tiktok = new TiktokNamespace(callTool, timeoutMs);
+    this.tracking = new TrackingNamespace(callTool, timeoutMs);
   }
   async connect() {
     await this.transport.connect();
@@ -1196,6 +1227,21 @@ var XpozClient = class {
     await this.close();
   }
 };
+
+// src/types/tracking.ts
+var TrackedItemType = /* @__PURE__ */ ((TrackedItemType2) => {
+  TrackedItemType2["Keyword"] = "keyword";
+  TrackedItemType2["User"] = "user";
+  TrackedItemType2["Subreddit"] = "subreddit";
+  return TrackedItemType2;
+})(TrackedItemType || {});
+var TrackedItemPlatform = /* @__PURE__ */ ((TrackedItemPlatform2) => {
+  TrackedItemPlatform2["Twitter"] = "twitter";
+  TrackedItemPlatform2["Instagram"] = "instagram";
+  TrackedItemPlatform2["Reddit"] = "reddit";
+  TrackedItemPlatform2["TikTok"] = "tiktok";
+  return TrackedItemPlatform2;
+})(TrackedItemPlatform || {});
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AuthenticationError,
@@ -1204,6 +1250,8 @@ var XpozClient = class {
   OperationTimeoutError,
   PaginatedResult,
   ResponseType,
+  TrackedItemPlatform,
+  TrackedItemType,
   VERSION,
   XpozClient,
   XpozConnectionError,

package/dist/index.d.cts

@@ -679,11 +679,48 @@ declare class TiktokNamespace extends BaseNamespace {
     }): Promise<PaginatedResult<TiktokUser>>;
 }
 
+declare enum TrackedItemType {
+    Keyword = "keyword",
+    User = "user",
+    Subreddit = "subreddit"
+}
+declare enum TrackedItemPlatform {
+    Twitter = "twitter",
+    Instagram = "instagram",
+    Reddit = "reddit",
+    TikTok = "tiktok"
+}
+interface TrackedItem {
+    phrase?: string;
+    type?: TrackedItemType;
+    platform?: TrackedItemPlatform;
+}
+interface AddTrackedItemsResult {
+    success?: boolean;
+    addedCount?: number;
+    message?: string;
+    currentCount?: number;
+    maxTrackedItems?: number;
+    planName?: string;
+}
+interface RemoveTrackedItemsResult {
+    success?: boolean;
+    removedCount?: number;
+    message?: string;
+}
+
+declare class TrackingNamespace extends BaseNamespace {
+    getTrackedItems(): Promise<TrackedItem[]>;
+    addTrackedItems(items: TrackedItem[]): Promise<AddTrackedItemsResult>;
+    removeTrackedItems(items: TrackedItem[]): Promise<RemoveTrackedItemsResult>;
+}
+
 declare class XpozClient {
     twitter: TwitterNamespace;
     instagram: InstagramNamespace;
     reddit: RedditNamespace;
     tiktok: TiktokNamespace;
+    tracking: TrackingNamespace;
     private transport;
     private versionCheck;
     constructor(options?: {
@@ -721,8 +758,8 @@ declare class OperationCancelledError extends XpozError {
     constructor(operationId: string);
 }
 
-declare const VERSION = "0.3.1";
+declare const VERSION = "0.4.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 TiktokComment, type TiktokPost, type TiktokUser, type TwitterPost, type TwitterUser, VERSION, XpozClient, XpozConnectionError, XpozError, checkForUpdates };
+export { type AddTrackedItemsResult, AuthenticationError, type InstagramComment, type InstagramPost, type InstagramUser, OperationCancelledError, OperationFailedError, OperationTimeoutError, PaginatedResult, type PaginationInfo, type RedditComment, type RedditPost, type RedditPostWithComments, type RedditSubreddit, type RedditUser, type RemoveTrackedItemsResult, ResponseType, type SubredditWithPosts, type TiktokComment, type TiktokPost, type TiktokUser, type TrackedItem, TrackedItemPlatform, TrackedItemType, type TwitterPost, type TwitterUser, VERSION, XpozClient, XpozConnectionError, XpozError, checkForUpdates };

package/dist/index.d.ts

@@ -679,11 +679,48 @@ declare class TiktokNamespace extends BaseNamespace {
     }): Promise<PaginatedResult<TiktokUser>>;
 }
 
+declare enum TrackedItemType {
+    Keyword = "keyword",
+    User = "user",
+    Subreddit = "subreddit"
+}
+declare enum TrackedItemPlatform {
+    Twitter = "twitter",
+    Instagram = "instagram",
+    Reddit = "reddit",
+    TikTok = "tiktok"
+}
+interface TrackedItem {
+    phrase?: string;
+    type?: TrackedItemType;
+    platform?: TrackedItemPlatform;
+}
+interface AddTrackedItemsResult {
+    success?: boolean;
+    addedCount?: number;
+    message?: string;
+    currentCount?: number;
+    maxTrackedItems?: number;
+    planName?: string;
+}
+interface RemoveTrackedItemsResult {
+    success?: boolean;
+    removedCount?: number;
+    message?: string;
+}
+
+declare class TrackingNamespace extends BaseNamespace {
+    getTrackedItems(): Promise<TrackedItem[]>;
+    addTrackedItems(items: TrackedItem[]): Promise<AddTrackedItemsResult>;
+    removeTrackedItems(items: TrackedItem[]): Promise<RemoveTrackedItemsResult>;
+}
+
 declare class XpozClient {
     twitter: TwitterNamespace;
     instagram: InstagramNamespace;
     reddit: RedditNamespace;
     tiktok: TiktokNamespace;
+    tracking: TrackingNamespace;
     private transport;
     private versionCheck;
     constructor(options?: {
@@ -721,8 +758,8 @@ declare class OperationCancelledError extends XpozError {
     constructor(operationId: string);
 }
 
-declare const VERSION = "0.3.1";
+declare const VERSION = "0.4.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 TiktokComment, type TiktokPost, type TiktokUser, type TwitterPost, type TwitterUser, VERSION, XpozClient, XpozConnectionError, XpozError, checkForUpdates };
+export { type AddTrackedItemsResult, AuthenticationError, type InstagramComment, type InstagramPost, type InstagramUser, OperationCancelledError, OperationFailedError, OperationTimeoutError, PaginatedResult, type PaginationInfo, type RedditComment, type RedditPost, type RedditPostWithComments, type RedditSubreddit, type RedditUser, type RemoveTrackedItemsResult, ResponseType, type SubredditWithPosts, type TiktokComment, type TiktokPost, type TiktokUser, type TrackedItem, TrackedItemPlatform, TrackedItemType, 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.3.1";
+var VERSION = "0.4.0";
 
 // 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" || "results" in result) {
       return result;
     }
     const operationId = result["operationId"];
@@ -579,6 +585,9 @@ var GET_TIKTOK_COMMENTS = "getTiktokCommentsByPostId";
 var GET_TIKTOK_USER = "getTiktokUser";
 var SEARCH_TIKTOK_USERS = "searchTiktokUsers";
 var GET_TIKTOK_USERS_BY_KEYWORDS = "getTiktokUsersByKeywords";
+var GET_TRACKED_ITEMS = "getTrackedItems";
+var ADD_TRACKED_ITEMS = "addTrackedItems";
+var REMOVE_TRACKED_ITEMS = "removeTrackedItems";
 
 // src/namespaces/twitter.ts
 function parseTwitterPost(item) {
@@ -1072,6 +1081,24 @@ var TiktokNamespace = class extends BaseNamespace {
   }
 };
 
+// src/namespaces/tracking.ts
+var TrackingNamespace = class extends BaseNamespace {
+  async getTrackedItems() {
+    const result = await this.callTool(GET_TRACKED_ITEMS, {});
+    return result["data"] ?? [];
+  }
+  async addTrackedItems(items) {
+    const args = this.buildArgs({ items });
+    const result = await this.callTool(ADD_TRACKED_ITEMS, args);
+    return result;
+  }
+  async removeTrackedItems(items) {
+    const args = this.buildArgs({ items });
+    const result = await this.callTool(REMOVE_TRACKED_ITEMS, args);
+    return result;
+  }
+};
+
 // src/versionCheck.ts
 var NPM_REGISTRY_URL = "https://registry.npmjs.org/@xpoz/xpoz/latest";
 var CHECK_TIMEOUT_MS = 3e3;
@@ -1118,6 +1145,7 @@ var XpozClient = class {
   instagram;
   reddit;
   tiktok;
+  tracking;
   transport;
   versionCheck;
   constructor(options = {}) {
@@ -1136,6 +1164,7 @@ var XpozClient = class {
     this.instagram = new InstagramNamespace(callTool, timeoutMs);
     this.reddit = new RedditNamespace(callTool, timeoutMs);
     this.tiktok = new TiktokNamespace(callTool, timeoutMs);
+    this.tracking = new TrackingNamespace(callTool, timeoutMs);
   }
   async connect() {
     await this.transport.connect();
@@ -1150,6 +1179,21 @@ var XpozClient = class {
     await this.close();
   }
 };
+
+// src/types/tracking.ts
+var TrackedItemType = /* @__PURE__ */ ((TrackedItemType2) => {
+  TrackedItemType2["Keyword"] = "keyword";
+  TrackedItemType2["User"] = "user";
+  TrackedItemType2["Subreddit"] = "subreddit";
+  return TrackedItemType2;
+})(TrackedItemType || {});
+var TrackedItemPlatform = /* @__PURE__ */ ((TrackedItemPlatform2) => {
+  TrackedItemPlatform2["Twitter"] = "twitter";
+  TrackedItemPlatform2["Instagram"] = "instagram";
+  TrackedItemPlatform2["Reddit"] = "reddit";
+  TrackedItemPlatform2["TikTok"] = "tiktok";
+  return TrackedItemPlatform2;
+})(TrackedItemPlatform || {});
 export {
   AuthenticationError,
   OperationCancelledError,
@@ -1157,6 +1201,8 @@ export {
   OperationTimeoutError,
   PaginatedResult,
   ResponseType,
+  TrackedItemPlatform,
+  TrackedItemType,
   VERSION,
   XpozClient,
   XpozConnectionError,

package/package.json

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