@xpoz/xpoz 0.4.2 → 0.6.6

package/dist/index.cjs

@@ -31,6 +31,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   AuthenticationError: () => AuthenticationError,
+  BillingPeriod: () => BillingPeriod,
+  CreditResetFrequency: () => CreditResetFrequency,
   OperationCancelledError: () => OperationCancelledError,
   OperationFailedError: () => OperationFailedError,
   OperationTimeoutError: () => OperationTimeoutError,
@@ -296,7 +298,7 @@ function coerce(value) {
 }
 
 // src/version.ts
-var VERSION = "0.4.2";
+var VERSION = "0.6.6";
 
 // src/mcp/transport.ts
 var USER_AGENT = `xpoz-ts-sdk/${VERSION}`;
@@ -638,6 +640,7 @@ var GET_TIKTOK_USERS_BY_HASHTAGS = "getTiktokUsersByHashtags";
 var GET_TRACKED_ITEMS = "getTrackedItems";
 var ADD_TRACKED_ITEMS = "addTrackedItems";
 var REMOVE_TRACKED_ITEMS = "removeTrackedItems";
+var GET_ACCOUNT_DETAILS = "getAccountDetails";
 
 // src/namespaces/twitter.ts
 function parseTwitterPost(item) {
@@ -792,7 +795,8 @@ var TwitterNamespace = class extends BaseNamespace {
     const args = this.buildArgs({
       identifier,
       identifierType: options.identifierType ?? "username",
-      fields: options.fields
+      fields: options.fields,
+      forceLatest: options.forceLatest
     });
     const result = await this.callAndMaybePoll(GET_TWITTER_USER, args);
     const results = result["results"];
@@ -894,7 +898,8 @@ var InstagramNamespace = class extends BaseNamespace {
     const args = this.buildArgs({
       identifier,
       identifierType: options.identifierType ?? "username",
-      fields: options.fields
+      fields: options.fields,
+      forceLatest: options.forceLatest
     });
     const result = await this.callAndMaybePoll(GET_INSTAGRAM_USER, args);
     const results = result["results"];
@@ -1105,7 +1110,8 @@ var TiktokNamespace = class extends BaseNamespace {
     const args = this.buildArgs({
       identifier,
       identifierType: options.identifierType ?? "username",
-      fields: options.fields
+      fields: options.fields,
+      forceLatest: options.forceLatest
     });
     const result = await this.callAndMaybePoll(GET_TIKTOK_USER, args);
     const results = result["results"];
@@ -1155,7 +1161,7 @@ var TiktokNamespace = class extends BaseNamespace {
 var TrackingNamespace = class extends BaseNamespace {
   async getTrackedItems() {
     const result = await this.callTool(GET_TRACKED_ITEMS, {});
-    return result["data"] ?? [];
+    return result["results"] ?? [];
   }
   async addTrackedItems(items) {
     const args = this.buildArgs({ items });
@@ -1169,6 +1175,14 @@ var TrackingNamespace = class extends BaseNamespace {
   }
 };
 
+// src/namespaces/account.ts
+var AccountNamespace = class extends BaseNamespace {
+  async getAccountDetails() {
+    const result = await this.callTool(GET_ACCOUNT_DETAILS, {});
+    return result["data"];
+  }
+};
+
 // src/versionCheck.ts
 var NPM_REGISTRY_URL = "https://registry.npmjs.org/@xpoz/xpoz/latest";
 var CHECK_TIMEOUT_MS = 3e3;
@@ -1216,6 +1230,7 @@ var XpozClient = class {
   reddit;
   tiktok;
   tracking;
+  account;
   transport;
   versionCheck;
   constructor(options = {}) {
@@ -1235,6 +1250,7 @@ var XpozClient = class {
     this.reddit = new RedditNamespace(callTool, timeoutMs);
     this.tiktok = new TiktokNamespace(callTool, timeoutMs);
     this.tracking = new TrackingNamespace(callTool, timeoutMs);
+    this.account = new AccountNamespace(callTool, timeoutMs);
   }
   async connect() {
     await this.transport.connect();
@@ -1255,6 +1271,7 @@ var TrackedItemType = /* @__PURE__ */ ((TrackedItemType2) => {
   TrackedItemType2["Keyword"] = "keyword";
   TrackedItemType2["User"] = "user";
   TrackedItemType2["Subreddit"] = "subreddit";
+  TrackedItemType2["Hashtag"] = "hashtag";
   return TrackedItemType2;
 })(TrackedItemType || {});
 var TrackedItemPlatform = /* @__PURE__ */ ((TrackedItemPlatform2) => {
@@ -1264,9 +1281,23 @@ var TrackedItemPlatform = /* @__PURE__ */ ((TrackedItemPlatform2) => {
   TrackedItemPlatform2["TikTok"] = "tiktok";
   return TrackedItemPlatform2;
 })(TrackedItemPlatform || {});
+
+// src/types/account.ts
+var BillingPeriod = /* @__PURE__ */ ((BillingPeriod2) => {
+  BillingPeriod2["Monthly"] = "monthly";
+  BillingPeriod2["Annual"] = "annual";
+  return BillingPeriod2;
+})(BillingPeriod || {});
+var CreditResetFrequency = /* @__PURE__ */ ((CreditResetFrequency2) => {
+  CreditResetFrequency2["Monthly"] = "monthly";
+  CreditResetFrequency2["Never"] = "never";
+  return CreditResetFrequency2;
+})(CreditResetFrequency || {});
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AuthenticationError,
+  BillingPeriod,
+  CreditResetFrequency,
   OperationCancelledError,
   OperationFailedError,
   OperationTimeoutError,

package/dist/index.d.cts

@@ -191,6 +191,7 @@ declare class TwitterNamespace extends BaseNamespace {
     getUser(identifier: string, options?: {
         identifierType?: string;
         fields?: string[];
+        forceLatest?: boolean;
     }): Promise<TwitterUser>;
     searchUsers(name: string, options?: {
         limit?: number;
@@ -317,6 +318,7 @@ declare class InstagramNamespace extends BaseNamespace {
     getUser(identifier: string, options?: {
         identifierType?: string;
         fields?: string[];
+        forceLatest?: boolean;
     }): Promise<InstagramUser>;
     searchUsers(name: string, options?: {
         limit?: number;
@@ -497,6 +499,7 @@ declare class RedditNamespace extends BaseNamespace {
     }): Promise<PaginatedResult<RedditComment>>;
     getUser(username: string, options?: {
         fields?: string[];
+        forceLatest?: boolean;
     }): Promise<RedditUser>;
     searchUsers(name: string, options?: {
         limit?: number;
@@ -547,6 +550,7 @@ interface TiktokPost {
     hashtags?: string[] | null;
     duration?: number | null;
     videoUrl?: string[] | null;
+    transcriptsJson?: Record<string, string> | null;
     createdAt?: string | null;
     createdAtTimestamp?: number | null;
     createdAtDate?: string | null;
@@ -621,6 +625,7 @@ declare class TiktokNamespace extends BaseNamespace {
     getUser(identifier: string, options?: {
         identifierType?: string;
         fields?: string[];
+        forceLatest?: boolean;
     }): Promise<TiktokUser>;
     searchUsers(name: string, options?: {
         limit?: number;
@@ -655,7 +660,8 @@ declare class TiktokNamespace extends BaseNamespace {
 declare enum TrackedItemType {
     Keyword = "keyword",
     User = "user",
-    Subreddit = "subreddit"
+    Subreddit = "subreddit",
+    Hashtag = "hashtag"
 }
 declare enum TrackedItemPlatform {
     Twitter = "twitter",
@@ -688,12 +694,53 @@ declare class TrackingNamespace extends BaseNamespace {
     removeTrackedItems(items: TrackedItem[]): Promise<RemoveTrackedItemsResult>;
 }
 
+declare enum BillingPeriod {
+    Monthly = "monthly",
+    Annual = "annual"
+}
+declare enum CreditResetFrequency {
+    Monthly = "monthly",
+    Never = "never"
+}
+interface PlanFeatures {
+    credits: number;
+    creditResetFrequency: CreditResetFrequency;
+    extraCreditPrice: number;
+    trackedItems?: number;
+    csvRowExportLimit: number;
+    extraCsvRowPrice: number;
+    extraTrackedItemPrice?: number;
+    maxRowsPerExport?: number;
+}
+interface AccountBilling {
+    billingPeriod: BillingPeriod;
+    nextRenewalDate: string | null;
+}
+interface AccountUsage {
+    subscriptionCreditsRemaining: number;
+    extraCreditsRemaining: number;
+    extraTrackedItems: number;
+}
+interface AccountDetails {
+    plan: {
+        name: string;
+        features: PlanFeatures;
+    };
+    billing: AccountBilling | null;
+    usage: AccountUsage;
+}
+
+declare class AccountNamespace extends BaseNamespace {
+    getAccountDetails(): Promise<AccountDetails>;
+}
+
 declare class XpozClient {
     twitter: TwitterNamespace;
     instagram: InstagramNamespace;
     reddit: RedditNamespace;
     tiktok: TiktokNamespace;
     tracking: TrackingNamespace;
+    account: AccountNamespace;
     private transport;
     private versionCheck;
     constructor(options?: {
@@ -731,8 +778,8 @@ declare class OperationCancelledError extends XpozError {
     constructor(operationId: string);
 }
 
-declare const VERSION = "0.4.2";
+declare const VERSION = "0.6.6";
 
 declare function checkForUpdates(): Promise<void>;
 
-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 };
+export { type AccountBilling, type AccountDetails, type AccountUsage, type AddTrackedItemsResult, AuthenticationError, BillingPeriod, CreditResetFrequency, type InstagramComment, type InstagramPost, type InstagramUser, OperationCancelledError, OperationFailedError, OperationTimeoutError, PaginatedResult, type PaginationInfo, type PlanFeatures, 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

@@ -191,6 +191,7 @@ declare class TwitterNamespace extends BaseNamespace {
     getUser(identifier: string, options?: {
         identifierType?: string;
         fields?: string[];
+        forceLatest?: boolean;
     }): Promise<TwitterUser>;
     searchUsers(name: string, options?: {
         limit?: number;
@@ -317,6 +318,7 @@ declare class InstagramNamespace extends BaseNamespace {
     getUser(identifier: string, options?: {
         identifierType?: string;
         fields?: string[];
+        forceLatest?: boolean;
     }): Promise<InstagramUser>;
     searchUsers(name: string, options?: {
         limit?: number;
@@ -497,6 +499,7 @@ declare class RedditNamespace extends BaseNamespace {
     }): Promise<PaginatedResult<RedditComment>>;
     getUser(username: string, options?: {
         fields?: string[];
+        forceLatest?: boolean;
     }): Promise<RedditUser>;
     searchUsers(name: string, options?: {
         limit?: number;
@@ -547,6 +550,7 @@ interface TiktokPost {
     hashtags?: string[] | null;
     duration?: number | null;
     videoUrl?: string[] | null;
+    transcriptsJson?: Record<string, string> | null;
     createdAt?: string | null;
     createdAtTimestamp?: number | null;
     createdAtDate?: string | null;
@@ -621,6 +625,7 @@ declare class TiktokNamespace extends BaseNamespace {
     getUser(identifier: string, options?: {
         identifierType?: string;
         fields?: string[];
+        forceLatest?: boolean;
     }): Promise<TiktokUser>;
     searchUsers(name: string, options?: {
         limit?: number;
@@ -655,7 +660,8 @@ declare class TiktokNamespace extends BaseNamespace {
 declare enum TrackedItemType {
     Keyword = "keyword",
     User = "user",
-    Subreddit = "subreddit"
+    Subreddit = "subreddit",
+    Hashtag = "hashtag"
 }
 declare enum TrackedItemPlatform {
     Twitter = "twitter",
@@ -688,12 +694,53 @@ declare class TrackingNamespace extends BaseNamespace {
     removeTrackedItems(items: TrackedItem[]): Promise<RemoveTrackedItemsResult>;
 }
 
+declare enum BillingPeriod {
+    Monthly = "monthly",
+    Annual = "annual"
+}
+declare enum CreditResetFrequency {
+    Monthly = "monthly",
+    Never = "never"
+}
+interface PlanFeatures {
+    credits: number;
+    creditResetFrequency: CreditResetFrequency;
+    extraCreditPrice: number;
+    trackedItems?: number;
+    csvRowExportLimit: number;
+    extraCsvRowPrice: number;
+    extraTrackedItemPrice?: number;
+    maxRowsPerExport?: number;
+}
+interface AccountBilling {
+    billingPeriod: BillingPeriod;
+    nextRenewalDate: string | null;
+}
+interface AccountUsage {
+    subscriptionCreditsRemaining: number;
+    extraCreditsRemaining: number;
+    extraTrackedItems: number;
+}
+interface AccountDetails {
+    plan: {
+        name: string;
+        features: PlanFeatures;
+    };
+    billing: AccountBilling | null;
+    usage: AccountUsage;
+}
+
+declare class AccountNamespace extends BaseNamespace {
+    getAccountDetails(): Promise<AccountDetails>;
+}
+
 declare class XpozClient {
     twitter: TwitterNamespace;
     instagram: InstagramNamespace;
     reddit: RedditNamespace;
     tiktok: TiktokNamespace;
     tracking: TrackingNamespace;
+    account: AccountNamespace;
     private transport;
     private versionCheck;
     constructor(options?: {
@@ -731,8 +778,8 @@ declare class OperationCancelledError extends XpozError {
     constructor(operationId: string);
 }
 
-declare const VERSION = "0.4.2";
+declare const VERSION = "0.6.6";
 
 declare function checkForUpdates(): Promise<void>;
 
-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 };
+export { type AccountBilling, type AccountDetails, type AccountUsage, type AddTrackedItemsResult, AuthenticationError, BillingPeriod, CreditResetFrequency, type InstagramComment, type InstagramPost, type InstagramUser, OperationCancelledError, OperationFailedError, OperationTimeoutError, PaginatedResult, type PaginationInfo, type PlanFeatures, 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.4.2";
+var VERSION = "0.6.6";
 
 // src/mcp/transport.ts
 var USER_AGENT = `xpoz-ts-sdk/${VERSION}`;
@@ -590,6 +590,7 @@ var GET_TIKTOK_USERS_BY_HASHTAGS = "getTiktokUsersByHashtags";
 var GET_TRACKED_ITEMS = "getTrackedItems";
 var ADD_TRACKED_ITEMS = "addTrackedItems";
 var REMOVE_TRACKED_ITEMS = "removeTrackedItems";
+var GET_ACCOUNT_DETAILS = "getAccountDetails";
 
 // src/namespaces/twitter.ts
 function parseTwitterPost(item) {
@@ -744,7 +745,8 @@ var TwitterNamespace = class extends BaseNamespace {
     const args = this.buildArgs({
       identifier,
       identifierType: options.identifierType ?? "username",
-      fields: options.fields
+      fields: options.fields,
+      forceLatest: options.forceLatest
     });
     const result = await this.callAndMaybePoll(GET_TWITTER_USER, args);
     const results = result["results"];
@@ -846,7 +848,8 @@ var InstagramNamespace = class extends BaseNamespace {
     const args = this.buildArgs({
       identifier,
       identifierType: options.identifierType ?? "username",
-      fields: options.fields
+      fields: options.fields,
+      forceLatest: options.forceLatest
     });
     const result = await this.callAndMaybePoll(GET_INSTAGRAM_USER, args);
     const results = result["results"];
@@ -1057,7 +1060,8 @@ var TiktokNamespace = class extends BaseNamespace {
     const args = this.buildArgs({
       identifier,
       identifierType: options.identifierType ?? "username",
-      fields: options.fields
+      fields: options.fields,
+      forceLatest: options.forceLatest
     });
     const result = await this.callAndMaybePoll(GET_TIKTOK_USER, args);
     const results = result["results"];
@@ -1107,7 +1111,7 @@ var TiktokNamespace = class extends BaseNamespace {
 var TrackingNamespace = class extends BaseNamespace {
   async getTrackedItems() {
     const result = await this.callTool(GET_TRACKED_ITEMS, {});
-    return result["data"] ?? [];
+    return result["results"] ?? [];
   }
   async addTrackedItems(items) {
     const args = this.buildArgs({ items });
@@ -1121,6 +1125,14 @@ var TrackingNamespace = class extends BaseNamespace {
   }
 };
 
+// src/namespaces/account.ts
+var AccountNamespace = class extends BaseNamespace {
+  async getAccountDetails() {
+    const result = await this.callTool(GET_ACCOUNT_DETAILS, {});
+    return result["data"];
+  }
+};
+
 // src/versionCheck.ts
 var NPM_REGISTRY_URL = "https://registry.npmjs.org/@xpoz/xpoz/latest";
 var CHECK_TIMEOUT_MS = 3e3;
@@ -1168,6 +1180,7 @@ var XpozClient = class {
   reddit;
   tiktok;
   tracking;
+  account;
   transport;
   versionCheck;
   constructor(options = {}) {
@@ -1187,6 +1200,7 @@ var XpozClient = class {
     this.reddit = new RedditNamespace(callTool, timeoutMs);
     this.tiktok = new TiktokNamespace(callTool, timeoutMs);
     this.tracking = new TrackingNamespace(callTool, timeoutMs);
+    this.account = new AccountNamespace(callTool, timeoutMs);
   }
   async connect() {
     await this.transport.connect();
@@ -1207,6 +1221,7 @@ var TrackedItemType = /* @__PURE__ */ ((TrackedItemType2) => {
   TrackedItemType2["Keyword"] = "keyword";
   TrackedItemType2["User"] = "user";
   TrackedItemType2["Subreddit"] = "subreddit";
+  TrackedItemType2["Hashtag"] = "hashtag";
   return TrackedItemType2;
 })(TrackedItemType || {});
 var TrackedItemPlatform = /* @__PURE__ */ ((TrackedItemPlatform2) => {
@@ -1216,8 +1231,22 @@ var TrackedItemPlatform = /* @__PURE__ */ ((TrackedItemPlatform2) => {
   TrackedItemPlatform2["TikTok"] = "tiktok";
   return TrackedItemPlatform2;
 })(TrackedItemPlatform || {});
+
+// src/types/account.ts
+var BillingPeriod = /* @__PURE__ */ ((BillingPeriod2) => {
+  BillingPeriod2["Monthly"] = "monthly";
+  BillingPeriod2["Annual"] = "annual";
+  return BillingPeriod2;
+})(BillingPeriod || {});
+var CreditResetFrequency = /* @__PURE__ */ ((CreditResetFrequency2) => {
+  CreditResetFrequency2["Monthly"] = "monthly";
+  CreditResetFrequency2["Never"] = "never";
+  return CreditResetFrequency2;
+})(CreditResetFrequency || {});
 export {
   AuthenticationError,
+  BillingPeriod,
+  CreditResetFrequency,
   OperationCancelledError,
   OperationFailedError,
   OperationTimeoutError,

package/package.json

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