@spectratools/xapi-cli 0.3.0 → 0.5.0

package/dist/cli.js

@@ -189,6 +189,15 @@ function createXApiClient(bearerToken) {
   function likePost(userId, tweetId) {
     return post(`/users/${userId}/likes`, { tweet_id: tweetId });
   }
+  function unlikePost(userId, tweetId) {
+    return del(`/users/${userId}/likes/${tweetId}`);
+  }
+  function bookmarkPost(userId, tweetId) {
+    return post(`/users/${userId}/bookmarks`, { tweet_id: tweetId });
+  }
+  function unbookmarkPost(userId, tweetId) {
+    return del(`/users/${userId}/bookmarks/${tweetId}`);
+  }
   function retweetPost(userId, tweetId) {
     return post(`/users/${userId}/retweets`, { tweet_id: tweetId });
   }
@@ -225,6 +234,22 @@ function createXApiClient(bearerToken) {
   function unfollowUser(sourceUserId, targetUserId) {
     return del(`/users/${sourceUserId}/following/${targetUserId}`);
   }
+  function blockUser(sourceUserId, targetUserId) {
+    return post(`/users/${sourceUserId}/blocking`, {
+      target_user_id: targetUserId
+    });
+  }
+  function unblockUser(sourceUserId, targetUserId) {
+    return del(`/users/${sourceUserId}/blocking/${targetUserId}`);
+  }
+  function muteUser(sourceUserId, targetUserId) {
+    return post(`/users/${sourceUserId}/muting`, {
+      target_user_id: targetUserId
+    });
+  }
+  function unmuteUser(sourceUserId, targetUserId) {
+    return del(`/users/${sourceUserId}/muting/${targetUserId}`);
+  }
   function getUserPosts(id, maxResults, nextToken) {
     return get(`/users/${id}/tweets`, {
       max_results: maxResults,
@@ -280,6 +305,24 @@ function createXApiClient(bearerToken) {
       ...nextToken ? { pagination_token: nextToken } : {}
     });
   }
+  function createList(name, description, isPrivate) {
+    return post("/lists", {
+      name,
+      ...description ? { description } : {},
+      ...isPrivate !== void 0 ? { private: isPrivate } : {}
+    });
+  }
+  function deleteList(id) {
+    return del(`/lists/${id}`);
+  }
+  function addListMember(id, userId) {
+    return post(`/lists/${id}/members`, {
+      user_id: userId
+    });
+  }
+  function removeListMember(id, userId) {
+    return del(`/lists/${id}/members/${userId}`);
+  }
   function getTrendingPlaces() {
     return getV1_1(
       "/trends/available.json"
@@ -318,6 +361,9 @@ function createXApiClient(bearerToken) {
     getPostLikes,
     getPostRetweets,
     likePost,
+    unlikePost,
+    bookmarkPost,
+    unbookmarkPost,
     retweetPost,
     getUserByUsername,
     getUserById,
@@ -325,6 +371,10 @@ function createXApiClient(bearerToken) {
     getUserFollowing,
     followUser,
     unfollowUser,
+    blockUser,
+    unblockUser,
+    muteUser,
+    unmuteUser,
     getUserPosts,
     getUserMentions,
     searchUsers,
@@ -333,6 +383,10 @@ function createXApiClient(bearerToken) {
     getList,
     getListMembers,
     getListPosts,
+    createList,
+    deleteList,
+    addListMember,
+    removeListMember,
     getTrendingPlaces,
     getTrendsByLocation,
     getDmConversations,
@@ -791,6 +845,54 @@ posts.command("delete", {
     }
   }
 });
+posts.command("like", {
+  description: "Like a post by ID.",
+  args: z4.object({
+    id: z4.string().describe("Post ID to like")
+  }),
+  env: xApiWriteEnv,
+  output: z4.object({
+    liked: z4.boolean(),
+    id: z4.string()
+  }),
+  examples: [{ args: { id: "1234567890" }, description: "Like a post" }],
+  async run(c) {
+    try {
+      const client = createXApiClient(writeAuthToken(c.env));
+      const me = await client.getMe();
+      const res = await client.likePost(me.data.id, c.args.id);
+      return c.ok({ liked: res.data.liked, id: c.args.id });
+    } catch (error) {
+      const authError = toWriteAuthError("posts like", error);
+      if (authError) return c.error(authError);
+      throw error;
+    }
+  }
+});
+posts.command("retweet", {
+  description: "Retweet a post by ID.",
+  args: z4.object({
+    id: z4.string().describe("Post ID to retweet")
+  }),
+  env: xApiWriteEnv,
+  output: z4.object({
+    retweeted: z4.boolean(),
+    id: z4.string()
+  }),
+  examples: [{ args: { id: "1234567890" }, description: "Retweet a post" }],
+  async run(c) {
+    try {
+      const client = createXApiClient(writeAuthToken(c.env));
+      const me = await client.getMe();
+      const res = await client.retweetPost(me.data.id, c.args.id);
+      return c.ok({ retweeted: res.data.retweeted, id: c.args.id });
+    } catch (error) {
+      const authError = toWriteAuthError("posts retweet", error);
+      if (authError) return c.error(authError);
+      throw error;
+    }
+  }
+});
 posts.command("likes", {
   description: "List users who liked a post.",
   args: z4.object({
@@ -887,6 +989,7 @@ timeline.command("home", {
   description: "View your home timeline.",
   options: z5.object({
     maxResults: z5.number().default(25).describe("Maximum posts to return (5\u2013100)"),
+    sinceId: z5.string().optional().describe("Only return posts newer than this post ID"),
     verbose: z5.boolean().optional().describe("Show full text without truncation")
   }),
   alias: { maxResults: "n" },
@@ -906,14 +1009,18 @@ timeline.command("home", {
   }),
   examples: [
     { description: "View your home timeline" },
-    { options: { maxResults: 50 }, description: "View 50 posts" }
+    { options: { maxResults: 50 }, description: "View 50 posts" },
+    {
+      options: { sinceId: "1900123456789012345" },
+      description: "Resume from last-seen post ID"
+    }
   ],
   async run(c) {
     const client = createXApiClient(readAuthToken(c.env));
     const meRes = await client.getMe();
     const userId = meRes.data.id;
     const allPosts = await collectPaged(
-      (limit, cursor) => client.getHomeTimeline(userId, limit, cursor),
+      (limit, cursor) => client.getHomeTimeline(userId, limit, cursor, c.options.sinceId),
       (post) => ({
         id: post.id,
         text: c.options.verbose ? post.text : truncateText(post.text),
@@ -946,6 +1053,7 @@ timeline.command("mentions", {
   description: "View your recent mentions.",
   options: z5.object({
     maxResults: z5.number().default(25).describe("Maximum mentions to return"),
+    sinceId: z5.string().optional().describe("Only return mentions newer than this post ID"),
     verbose: z5.boolean().optional().describe("Show full text without truncation")
   }),
   alias: { maxResults: "n" },
@@ -961,13 +1069,19 @@ timeline.command("mentions", {
     ),
     count: z5.number()
   }),
-  examples: [{ description: "View your recent mentions" }],
+  examples: [
+    { description: "View your recent mentions" },
+    {
+      options: { sinceId: "1900123456789012345" },
+      description: "Resume mentions from last-seen post ID"
+    }
+  ],
   async run(c) {
     const client = createXApiClient(readAuthToken(c.env));
     const meRes = await client.getMe();
     const userId = meRes.data.id;
     const allPosts = await collectPaged(
-      (limit, cursor) => client.getMentionsTimeline(userId, limit, cursor),
+      (limit, cursor) => client.getMentionsTimeline(userId, limit, cursor, c.options.sinceId),
       (post) => ({
         id: post.id,
         text: c.options.verbose ? post.text : truncateText(post.text),
@@ -1198,6 +1312,70 @@ users.command("get", {
     );
   }
 });
+users.command("follow", {
+  description: "Follow a user by username or ID.",
+  args: z7.object({
+    username: z7.string().describe("Username (with or without @) or user ID")
+  }),
+  env: xApiWriteEnv,
+  output: z7.object({
+    id: z7.string(),
+    username: z7.string(),
+    following: z7.boolean(),
+    pending_follow: z7.boolean().optional()
+  }),
+  examples: [{ args: { username: "jack" }, description: "Follow @jack" }],
+  async run(c) {
+    try {
+      const client = createXApiClient(writeAuthToken(c.env));
+      const me = await client.getMe();
+      const targetRes = await resolveUser(client, c.args.username);
+      const target = targetRes.data;
+      const res = await client.followUser(me.data.id, target.id);
+      return c.ok({
+        id: target.id,
+        username: target.username,
+        following: res.data.following,
+        pending_follow: res.data.pending_follow
+      });
+    } catch (error) {
+      const authError = toWriteAuthError("users follow", error);
+      if (authError) return c.error(authError);
+      throw error;
+    }
+  }
+});
+users.command("unfollow", {
+  description: "Unfollow a user by username or ID.",
+  args: z7.object({
+    username: z7.string().describe("Username (with or without @) or user ID")
+  }),
+  env: xApiWriteEnv,
+  output: z7.object({
+    id: z7.string(),
+    username: z7.string(),
+    following: z7.boolean()
+  }),
+  examples: [{ args: { username: "jack" }, description: "Unfollow @jack" }],
+  async run(c) {
+    try {
+      const client = createXApiClient(writeAuthToken(c.env));
+      const me = await client.getMe();
+      const targetRes = await resolveUser(client, c.args.username);
+      const target = targetRes.data;
+      const res = await client.unfollowUser(me.data.id, target.id);
+      return c.ok({
+        id: target.id,
+        username: target.username,
+        following: res.data.following
+      });
+    } catch (error) {
+      const authError = toWriteAuthError("users unfollow", error);
+      if (authError) return c.error(authError);
+      throw error;
+    }
+  }
+});
 users.command("followers", {
   description: "List followers of a user. Supports optional client-side baseline diffing for new follower detection.",
   args: z7.object({
@@ -1439,7 +1617,15 @@ var cli = Cli7.create("xapi", {
   version: pkg.version,
   description: "X (Twitter) API CLI for spectra-the-bot."
 });
-var WRITE_OPERATIONS = /* @__PURE__ */ new Set(["posts create", "posts delete", "dm send"]);
+var WRITE_OPERATIONS = /* @__PURE__ */ new Set([
+  "posts create",
+  "posts delete",
+  "posts like",
+  "posts retweet",
+  "users follow",
+  "users unfollow",
+  "dm send"
+]);
 cli.use(async ({ command, error }, next) => {
   try {
     return await next();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spectratools/xapi-cli",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "X (Twitter) API CLI for spectra-the-bot",
   "type": "module",
   "license": "MIT",