@dotta/xc 0.1.0

package/dist/commands/lists.js

@@ -0,0 +1,384 @@
+/**
+ * Lists commands: view, create, update, delete, manage members, follow/pin.
+ *
+ * Usage:
+ *   xc lists                                — list your lists
+ *   xc list <list-id>                       — view posts in a list
+ *   xc list create <name> [options]         — create a list
+ *   xc list update <id> [options]           — update a list
+ *   xc list delete <id>                     — delete a list
+ *   xc list members <id>                    — list members
+ *   xc list add <id> <username>             — add a member
+ *   xc list remove <id> <username>          — remove a member
+ *   xc list follow <id>                     — follow a list
+ *   xc list unfollow <id>                   — unfollow a list
+ *   xc list pin <id>                        — pin a list
+ *   xc list unpin <id>                      — unpin a list
+ */
+import { getClient } from "../lib/api.js";
+import { outputJson } from "../lib/cost.js";
+import { resolveAuthenticatedUserId, resolveUserId, } from "../lib/resolve.js";
+import { buildUserMap, formatTweetList, formatUserLine, } from "../lib/format.js";
+const TWEET_FIELDS = ["created_at", "public_metrics", "author_id"];
+const EXPANSIONS = ["author_id"];
+const USER_FIELDS = ["name", "username"];
+async function viewListPosts(listId, opts) {
+    const client = await getClient(opts.account);
+    const result = await client.lists.getPosts(listId, {
+        tweetFields: TWEET_FIELDS,
+        expansions: EXPANSIONS,
+        userFields: USER_FIELDS,
+        maxResults: parseInt(opts.limit, 10),
+    });
+    if (opts.json) {
+        outputJson(result);
+        return;
+    }
+    const tweets = result.data ?? [];
+    if (tweets.length === 0) {
+        console.log("No posts in this list.");
+        return;
+    }
+    const usersById = buildUserMap(result.includes?.users);
+    console.log(formatTweetList(tweets, usersById));
+}
+export function registerListsCommand(program) {
+    program
+        .command("lists")
+        .description("List your owned lists")
+        .option("--json", "Output raw JSON")
+        .option("--account <name>", "Account to use")
+        .action(async (opts) => {
+        try {
+            const userId = await resolveAuthenticatedUserId(opts.account);
+            const client = await getClient(opts.account);
+            const result = await client.users.getOwnedLists(userId, {
+                listFields: ["description", "member_count", "follower_count", "private"],
+            });
+            if (opts.json) {
+                outputJson(result);
+                return;
+            }
+            const lists = (result.data ?? []);
+            if (lists.length === 0) {
+                console.log("No lists found.");
+                return;
+            }
+            console.log("Your lists:\n");
+            for (const list of lists) {
+                const visibility = list.private ? " (private)" : "";
+                console.log(`  ${list.name}${visibility}  [id:${list.id}]`);
+                if (list.description) {
+                    console.log(`    ${list.description}`);
+                }
+                const parts = [];
+                if (list.memberCount !== undefined) {
+                    parts.push(`${list.memberCount} members`);
+                }
+                if (list.followerCount !== undefined) {
+                    parts.push(`${list.followerCount} followers`);
+                }
+                if (parts.length > 0) {
+                    console.log(`    ${parts.join(" · ")}`);
+                }
+            }
+        }
+        catch (err) {
+            console.error(`Error: ${err instanceof Error ? err.message : err}`);
+            process.exit(1);
+        }
+    });
+}
+export function registerListCommand(program) {
+    const list = program
+        .command("list")
+        .description("List operations (view posts, create, update, delete, members, follow, pin)")
+        .argument("[list-id]", "View posts in a list")
+        .option("-n, --limit <n>", "Max results (1-100)", "20")
+        .option("--json", "Output raw JSON")
+        .option("--account <name>", "Account to use")
+        .action(async (listId, opts, command) => {
+        if (!listId) {
+            command.outputHelp();
+            return;
+        }
+        try {
+            await viewListPosts(listId, opts);
+        }
+        catch (err) {
+            console.error(`Error: ${err instanceof Error ? err.message : err}`);
+            process.exit(1);
+        }
+    });
+    // Explicit subcommand variant: xc list view <list-id>
+    list
+        .command("view <list-id>")
+        .description("View posts in a list")
+        .option("-n, --limit <n>", "Max results (1-100)", "20")
+        .option("--json", "Output raw JSON")
+        .option("--account <name>", "Account to use")
+        .action(async (listId, opts) => {
+        try {
+            await viewListPosts(listId, opts);
+        }
+        catch (err) {
+            console.error(`Error: ${err instanceof Error ? err.message : err}`);
+            process.exit(1);
+        }
+    });
+    // xc list create <name>
+    list
+        .command("create <name>")
+        .description("Create a new list")
+        .option("--description <text>", "List description")
+        .option("--private", "Make the list private")
+        .option("--json", "Output raw JSON")
+        .option("--account <name>", "Account to use")
+        .action(async (name, opts) => {
+        try {
+            const client = await getClient(opts.account);
+            const body = { name };
+            if (opts.description)
+                body.description = opts.description;
+            if (opts.private)
+                body.private = true;
+            const result = await client.lists.create({ body });
+            if (opts.json) {
+                outputJson(result);
+                return;
+            }
+            const data = result.data;
+            console.log(`Created list "${name}" (id:${data?.id ?? "unknown"})`);
+        }
+        catch (err) {
+            console.error(`Error: ${err instanceof Error ? err.message : err}`);
+            process.exit(1);
+        }
+    });
+    // xc list update <id>
+    list
+        .command("update <list-id>")
+        .description("Update a list")
+        .option("--name <name>", "New list name")
+        .option("--description <text>", "New description")
+        .option("--private", "Make private")
+        .option("--public", "Make public")
+        .option("--json", "Output raw JSON")
+        .option("--account <name>", "Account to use")
+        .action(async (listId, opts) => {
+        try {
+            const client = await getClient(opts.account);
+            const body = {};
+            if (opts.name)
+                body.name = opts.name;
+            if (opts.description)
+                body.description = opts.description;
+            if (opts.private)
+                body.private = true;
+            if (opts.public)
+                body.private = false;
+            const result = await client.lists.update(listId, { body });
+            if (opts.json) {
+                outputJson(result);
+                return;
+            }
+            console.log(`Updated list ${listId}`);
+        }
+        catch (err) {
+            console.error(`Error: ${err instanceof Error ? err.message : err}`);
+            process.exit(1);
+        }
+    });
+    // xc list delete <id>
+    list
+        .command("delete <list-id>")
+        .description("Delete a list")
+        .option("--json", "Output raw JSON")
+        .option("--account <name>", "Account to use")
+        .action(async (listId, opts) => {
+        try {
+            const client = await getClient(opts.account);
+            const result = await client.lists.delete(listId);
+            if (opts.json) {
+                outputJson(result);
+                return;
+            }
+            console.log(`Deleted list ${listId}`);
+        }
+        catch (err) {
+            console.error(`Error: ${err instanceof Error ? err.message : err}`);
+            process.exit(1);
+        }
+    });
+    // xc list members <id>
+    list
+        .command("members <list-id>")
+        .description("List members of a list")
+        .option("-n, --limit <n>", "Max results (1-100)", "100")
+        .option("--json", "Output raw JSON")
+        .option("--account <name>", "Account to use")
+        .action(async (listId, opts) => {
+        try {
+            const client = await getClient(opts.account);
+            const result = await client.lists.getMembers(listId, {
+                userFields: ["username", "name", "public_metrics"],
+                maxResults: parseInt(opts.limit, 10),
+            });
+            if (opts.json) {
+                outputJson(result);
+                return;
+            }
+            const users = (result.data ?? []);
+            if (users.length === 0) {
+                console.log("No members in this list.");
+                return;
+            }
+            console.log(`Members of list ${listId}:\n`);
+            for (const user of users) {
+                console.log(formatUserLine(user));
+            }
+            console.log(`\n— ${users.length} shown`);
+        }
+        catch (err) {
+            console.error(`Error: ${err instanceof Error ? err.message : err}`);
+            process.exit(1);
+        }
+    });
+    // xc list add <id> <username>
+    list
+        .command("add <list-id> <username>")
+        .description("Add a member to a list")
+        .option("--json", "Output raw JSON")
+        .option("--account <name>", "Account to use")
+        .action(async (listId, username, opts) => {
+        try {
+            const targetId = await resolveUserId(username, opts.account);
+            const client = await getClient(opts.account);
+            const result = await client.lists.addMember(listId, {
+                body: { userId: targetId },
+            });
+            if (opts.json) {
+                outputJson(result);
+                return;
+            }
+            console.log(`Added @${username.replace(/^@/, "")} to list ${listId}`);
+        }
+        catch (err) {
+            console.error(`Error: ${err instanceof Error ? err.message : err}`);
+            process.exit(1);
+        }
+    });
+    // xc list remove <id> <username>
+    list
+        .command("remove <list-id> <username>")
+        .description("Remove a member from a list")
+        .option("--json", "Output raw JSON")
+        .option("--account <name>", "Account to use")
+        .action(async (listId, username, opts) => {
+        try {
+            const targetId = await resolveUserId(username, opts.account);
+            const client = await getClient(opts.account);
+            const result = await client.lists.removeMemberByUserId(listId, targetId);
+            if (opts.json) {
+                outputJson(result);
+                return;
+            }
+            console.log(`Removed @${username.replace(/^@/, "")} from list ${listId}`);
+        }
+        catch (err) {
+            console.error(`Error: ${err instanceof Error ? err.message : err}`);
+            process.exit(1);
+        }
+    });
+    // xc list follow <id>
+    list
+        .command("follow <list-id>")
+        .description("Follow a list")
+        .option("--json", "Output raw JSON")
+        .option("--account <name>", "Account to use")
+        .action(async (listId, opts) => {
+        try {
+            const userId = await resolveAuthenticatedUserId(opts.account);
+            const client = await getClient(opts.account);
+            const result = await client.users.followList(userId, {
+                body: { listId },
+            });
+            if (opts.json) {
+                outputJson(result);
+                return;
+            }
+            console.log(`Following list ${listId}`);
+        }
+        catch (err) {
+            console.error(`Error: ${err instanceof Error ? err.message : err}`);
+            process.exit(1);
+        }
+    });
+    // xc list unfollow <id>
+    list
+        .command("unfollow <list-id>")
+        .description("Unfollow a list")
+        .option("--json", "Output raw JSON")
+        .option("--account <name>", "Account to use")
+        .action(async (listId, opts) => {
+        try {
+            const userId = await resolveAuthenticatedUserId(opts.account);
+            const client = await getClient(opts.account);
+            const result = await client.users.unfollowList(userId, listId);
+            if (opts.json) {
+                outputJson(result);
+                return;
+            }
+            console.log(`Unfollowed list ${listId}`);
+        }
+        catch (err) {
+            console.error(`Error: ${err instanceof Error ? err.message : err}`);
+            process.exit(1);
+        }
+    });
+    // xc list pin <id>
+    list
+        .command("pin <list-id>")
+        .description("Pin a list")
+        .option("--json", "Output raw JSON")
+        .option("--account <name>", "Account to use")
+        .action(async (listId, opts) => {
+        try {
+            const userId = await resolveAuthenticatedUserId(opts.account);
+            const client = await getClient(opts.account);
+            const result = await client.users.pinList(userId, { listId });
+            if (opts.json) {
+                outputJson(result);
+                return;
+            }
+            console.log(`Pinned list ${listId}`);
+        }
+        catch (err) {
+            console.error(`Error: ${err instanceof Error ? err.message : err}`);
+            process.exit(1);
+        }
+    });
+    // xc list unpin <id>
+    list
+        .command("unpin <list-id>")
+        .description("Unpin a list")
+        .option("--json", "Output raw JSON")
+        .option("--account <name>", "Account to use")
+        .action(async (listId, opts) => {
+        try {
+            const userId = await resolveAuthenticatedUserId(opts.account);
+            const client = await getClient(opts.account);
+            const result = await client.users.unpinList(userId, listId);
+            if (opts.json) {
+                outputJson(result);
+                return;
+            }
+            console.log(`Unpinned list ${listId}`);
+        }
+        catch (err) {
+            console.error(`Error: ${err instanceof Error ? err.message : err}`);
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=lists.js.map

package/dist/commands/lists.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lists.js","sourceRoot":"","sources":["../../src/commands/lists.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EACL,0BAA0B,EAC1B,aAAa,GACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,YAAY,EACZ,eAAe,EACf,cAAc,GAEf,MAAM,kBAAkB,CAAC;AAE1B,MAAM,YAAY,GAAG,CAAC,YAAY,EAAE,gBAAgB,EAAE,WAAW,CAAC,CAAC;AACnE,MAAM,UAAU,GAAG,CAAC,WAAW,CAAC,CAAC;AACjC,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAkBzC,KAAK,UAAU,aAAa,CAAC,MAAc,EAAE,IAAqB;IAChE,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAE7C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE;QACjD,WAAW,EAAE,YAAY;QACzB,UAAU,EAAE,UAAU;QACtB,UAAU,EAAE,WAAW;QACvB,UAAU,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;KACrC,CAAC,CAAC;IAEH,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,UAAU,CAAC,MAAM,CAAC,CAAC;QACnB,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;IACjC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;QACtC,OAAO;IACT,CAAC;IAED,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACvD,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,uBAAuB,CAAC;SACpC,MAAM,CAAC,QAAQ,EAAE,iBAAiB,CAAC;SACnC,MAAM,CAAC,kBAAkB,EAAE,gBAAgB,CAAC;SAC5C,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,0BAA0B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC9D,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAE7C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,EAAE;gBACtD,UAAU,EAAE,CAAC,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,SAAS,CAAC;aACrB,CAAC,CAAC;YAEvD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,UAAU,CAAC,MAAM,CAAC,CAAC;gBACnB,OAAO;YACT,CAAC;YAED,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAY,CAAC;YAC7C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;gBAC/B,OAAO;YACT,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;YAC7B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;gBACpD,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,IAAI,GAAG,UAAU,SAAS,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;gBAC5D,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;oBACrB,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;gBACzC,CAAC;gBACD,MAAM,KAAK,GAAa,EAAE,CAAC;gBAC3B,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;oBACnC,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,WAAW,UAAU,CAAC,CAAC;gBAC5C,CAAC;gBACD,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;oBACrC,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,aAAa,YAAY,CAAC,CAAC;gBAChD,CAAC;gBACD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACrB,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBAC1C,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;YACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,MAAM,IAAI,GAAG,OAAO;SACjB,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,4EAA4E,CAAC;SACzF,QAAQ,CAAC,WAAW,EAAE,sBAAsB,CAAC;SAC7C,MAAM,CAAC,iBAAiB,EAAE,qBAAqB,EAAE,IAAI,CAAC;SACtD,MAAM,CAAC,QAAQ,EAAE,iBAAiB,CAAC;SACnC,MAAM,CAAC,kBAAkB,EAAE,gBAAgB,CAAC;SAC5C,MAAM,CAAC,KAAK,EAAE,MAA0B,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;QAC1D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,CAAC,UAAU,EAAE,CAAC;YACrB,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,aAAa,CAAC,MAAM,EAAE,IAAuB,CAAC,CAAC;QACvD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;YACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,sDAAsD;IACtD,IAAI;SACD,OAAO,CAAC,gBAAgB,CAAC;SACzB,WAAW,CAAC,sBAAsB,CAAC;SACnC,MAAM,CAAC,iBAAiB,EAAE,qBAAqB,EAAE,IAAI,CAAC;SACtD,MAAM,CAAC,QAAQ,EAAE,iBAAiB,CAAC;SACnC,MAAM,CAAC,kBAAkB,EAAE,gBAAgB,CAAC;SAC5C,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,IAAI,EAAE,EAAE;QACrC,IAAI,CAAC;YACH,MAAM,aAAa,CAAC,MAAM,EAAE,IAAuB,CAAC,CAAC;QACvD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;YACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,wBAAwB;IACxB,IAAI;SACD,OAAO,CAAC,eAAe,CAAC;SACxB,WAAW,CAAC,mBAAmB,CAAC;SAChC,MAAM,CAAC,sBAAsB,EAAE,kBAAkB,CAAC;SAClD,MAAM,CAAC,WAAW,EAAE,uBAAuB,CAAC;SAC5C,MAAM,CAAC,QAAQ,EAAE,iBAAiB,CAAC;SACnC,MAAM,CAAC,kBAAkB,EAAE,gBAAgB,CAAC;SAC5C,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,IAAI,EAAE,EAAE;QACnC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAE7C,MAAM,IAAI,GAA8D,EAAE,IAAI,EAAE,CAAC;YACjF,IAAI,IAAI,CAAC,WAAW;gBAAE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;YAC1D,IAAI,IAAI,CAAC,OAAO;gBAAE,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;YAEtC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;YAEnD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,UAAU,CAAC,MAAM,CAAC,CAAC;gBACnB,OAAO;YACT,CAAC;YAED,MAAM,IAAI,GAAI,MAAwD,CAAC,IAAI,CAAC;YAC5E,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,SAAS,IAAI,EAAE,EAAE,IAAI,SAAS,GAAG,CAAC,CAAC;QACtE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;YACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,sBAAsB;IACtB,IAAI;SACD,OAAO,CAAC,kBAAkB,CAAC;SAC3B,WAAW,CAAC,eAAe,CAAC;SAC5B,MAAM,CAAC,eAAe,EAAE,eAAe,CAAC;SACxC,MAAM,CAAC,sBAAsB,EAAE,iBAAiB,CAAC;SACjD,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC;SACnC,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC;SACjC,MAAM,CAAC,QAAQ,EAAE,iBAAiB,CAAC;SACnC,MAAM,CAAC,kBAAkB,EAAE,gBAAgB,CAAC;SAC5C,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,IAAI,EAAE,EAAE;QACrC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAE7C,MAAM,IAAI,GAA4B,EAAE,CAAC;YACzC,IAAI,IAAI,CAAC,IAAI;gBAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;YACrC,IAAI,IAAI,CAAC,WAAW;gBAAE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;YAC1D,IAAI,IAAI,CAAC,OAAO;gBAAE,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;YACtC,IAAI,IAAI,CAAC,MAAM;gBAAE,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;YAEtC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;YAE3D,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,UAAU,CAAC,MAAM,CAAC,CAAC;gBACnB,OAAO;YACT,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,gBAAgB,MAAM,EAAE,CAAC,CAAC;QACxC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;YACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,sBAAsB;IACtB,IAAI;SACD,OAAO,CAAC,kBAAkB,CAAC;SAC3B,WAAW,CAAC,eAAe,CAAC;SAC5B,MAAM,CAAC,QAAQ,EAAE,iBAAiB,CAAC;SACnC,MAAM,CAAC,kBAAkB,EAAE,gBAAgB,CAAC;SAC5C,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,IAAI,EAAE,EAAE;QACrC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAE7C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAEjD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,UAAU,CAAC,MAAM,CAAC,CAAC;gBACnB,OAAO;YACT,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,gBAAgB,MAAM,EAAE,CAAC,CAAC;QACxC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;YACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,uBAAuB;IACvB,IAAI;SACD,OAAO,CAAC,mBAAmB,CAAC;SAC5B,WAAW,CAAC,wBAAwB,CAAC;SACrC,MAAM,CAAC,iBAAiB,EAAE,qBAAqB,EAAE,KAAK,CAAC;SACvD,MAAM,CAAC,QAAQ,EAAE,iBAAiB,CAAC;SACnC,MAAM,CAAC,kBAAkB,EAAE,gBAAgB,CAAC;SAC5C,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,IAAI,EAAE,EAAE;QACrC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAE7C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,EAAE;gBACnD,UAAU,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,gBAAgB,CAAC;gBAClD,UAAU,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;aACrC,CAAC,CAAC;YAEH,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,UAAU,CAAC,MAAM,CAAC,CAAC;gBACnB,OAAO;YACT,CAAC;YAED,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAiB,CAAC;YAClD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;gBACxC,OAAO;YACT,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,mBAAmB,MAAM,KAAK,CAAC,CAAC;YAC5C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;YACpC,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;YACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,8BAA8B;IAC9B,IAAI;SACD,OAAO,CAAC,0BAA0B,CAAC;SACnC,WAAW,CAAC,wBAAwB,CAAC;SACrC,MAAM,CAAC,QAAQ,EAAE,iBAAiB,CAAC;SACnC,MAAM,CAAC,kBAAkB,EAAE,gBAAgB,CAAC;SAC5C,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,QAAgB,EAAE,IAAI,EAAE,EAAE;QACvD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YAC7D,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAE7C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE;gBAClD,IAAI,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE;aAC3B,CAAC,CAAC;YAEH,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,UAAU,CAAC,MAAM,CAAC,CAAC;gBACnB,OAAO;YACT,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,UAAU,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,MAAM,EAAE,CAAC,CAAC;QACxE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;YACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,iCAAiC;IACjC,IAAI;SACD,OAAO,CAAC,6BAA6B,CAAC;SACtC,WAAW,CAAC,6BAA6B,CAAC;SAC1C,MAAM,CAAC,QAAQ,EAAE,iBAAiB,CAAC;SACnC,MAAM,CAAC,kBAAkB,EAAE,gBAAgB,CAAC;SAC5C,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,QAAgB,EAAE,IAAI,EAAE,EAAE;QACvD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YAC7D,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAE7C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YAEzE,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,UAAU,CAAC,MAAM,CAAC,CAAC;gBACnB,OAAO;YACT,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,YAAY,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,MAAM,EAAE,CAAC,CAAC;QAC5E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;YACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,sBAAsB;IACtB,IAAI;SACD,OAAO,CAAC,kBAAkB,CAAC;SAC3B,WAAW,CAAC,eAAe,CAAC;SAC5B,MAAM,CAAC,QAAQ,EAAE,iBAAiB,CAAC;SACnC,MAAM,CAAC,kBAAkB,EAAE,gBAAgB,CAAC;SAC5C,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,IAAI,EAAE,EAAE;QACrC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,0BAA0B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC9D,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAE7C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,EAAE;gBACnD,IAAI,EAAE,EAAE,MAAM,EAAE;aACjB,CAAC,CAAC;YAEH,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,UAAU,CAAC,MAAM,CAAC,CAAC;gBACnB,OAAO;YACT,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,kBAAkB,MAAM,EAAE,CAAC,CAAC;QAC1C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;YACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,wBAAwB;IACxB,IAAI;SACD,OAAO,CAAC,oBAAoB,CAAC;SAC7B,WAAW,CAAC,iBAAiB,CAAC;SAC9B,MAAM,CAAC,QAAQ,EAAE,iBAAiB,CAAC;SACnC,MAAM,CAAC,kBAAkB,EAAE,gBAAgB,CAAC;SAC5C,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,IAAI,EAAE,EAAE;QACrC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,0BAA0B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC9D,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAE7C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAE/D,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,UAAU,CAAC,MAAM,CAAC,CAAC;gBACnB,OAAO;YACT,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,mBAAmB,MAAM,EAAE,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;YACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,mBAAmB;IACnB,IAAI;SACD,OAAO,CAAC,eAAe,CAAC;SACxB,WAAW,CAAC,YAAY,CAAC;SACzB,MAAM,CAAC,QAAQ,EAAE,iBAAiB,CAAC;SACnC,MAAM,CAAC,kBAAkB,EAAE,gBAAgB,CAAC;SAC5C,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,IAAI,EAAE,EAAE;QACrC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,0BAA0B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC9D,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAE7C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;YAE9D,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,UAAU,CAAC,MAAM,CAAC,CAAC;gBACnB,OAAO;YACT,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,eAAe,MAAM,EAAE,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;YACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,qBAAqB;IACrB,IAAI;SACD,OAAO,CAAC,iBAAiB,CAAC;SAC1B,WAAW,CAAC,cAAc,CAAC;SAC3B,MAAM,CAAC,QAAQ,EAAE,iBAAiB,CAAC;SACnC,MAAM,CAAC,kBAAkB,EAAE,gBAAgB,CAAC;SAC5C,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,IAAI,EAAE,EAAE;QACrC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,0BAA0B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC9D,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAE7C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAE5D,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,UAAU,CAAC,MAAM,CAAC,CAAC;gBACnB,OAAO;YACT,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,iBAAiB,MAAM,EAAE,CAAC,CAAC;QACzC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;YACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/media.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Media upload command: upload images, GIFs, or videos to the X API.
+ *
+ * Usage:
+ *   xc media upload <file>              — upload and return media_id
+ *   xc media upload <file> --type video — force video category
+ *
+ * Supports:
+ *   Images: up to 5MB  (one-shot upload)
+ *   GIFs:   up to 15MB (chunked upload)
+ *   Video:  up to 512MB (chunked upload)
+ */
+import { Command } from "commander";
+/**
+ * Upload a file and return its media_id.
+ * Automatically selects one-shot vs. chunked upload based on type.
+ */
+export declare function uploadMedia(filePath: string, accountName?: string): Promise<string>;
+export declare function registerMediaCommand(program: Command): void;

package/dist/commands/media.js

@@ -0,0 +1,205 @@
+/**
+ * Media upload command: upload images, GIFs, or videos to the X API.
+ *
+ * Usage:
+ *   xc media upload <file>              — upload and return media_id
+ *   xc media upload <file> --type video — force video category
+ *
+ * Supports:
+ *   Images: up to 5MB  (one-shot upload)
+ *   GIFs:   up to 15MB (chunked upload)
+ *   Video:  up to 512MB (chunked upload)
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { getClient } from "../lib/api.js";
+import { outputJson } from "../lib/cost.js";
+/** MIME type detection based on file extension. */
+const MIME_MAP = {
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".png": "image/png",
+    ".gif": "image/gif",
+    ".bmp": "image/bmp",
+    ".webp": "image/webp",
+    ".tiff": "image/tiff",
+    ".mp4": "video/mp4",
+    ".webm": "video/webm",
+    ".mov": "video/quicktime",
+    ".ts": "video/mp2t",
+};
+/** File extension to media category mapping. */
+const CATEGORY_MAP = {
+    ".jpg": "tweet_image",
+    ".jpeg": "tweet_image",
+    ".png": "tweet_image",
+    ".bmp": "tweet_image",
+    ".webp": "tweet_image",
+    ".tiff": "tweet_image",
+    ".gif": "tweet_gif",
+    ".mp4": "tweet_video",
+    ".webm": "tweet_video",
+    ".mov": "tweet_video",
+    ".ts": "tweet_video",
+};
+/** Size limits by category in bytes. */
+const SIZE_LIMITS = {
+    tweet_image: 5 * 1024 * 1024,
+    tweet_gif: 15 * 1024 * 1024,
+    tweet_video: 512 * 1024 * 1024,
+};
+/** Chunk size for chunked uploads (5MB). */
+const CHUNK_SIZE = 5 * 1024 * 1024;
+/**
+ * Upload media using chunked (INIT/APPEND/FINALIZE) flow.
+ * Used for GIFs and videos that exceed one-shot limits.
+ */
+async function chunkedUpload(client, filePath, mediaType, mediaCategory) {
+    const fileSize = fs.statSync(filePath).size;
+    // INIT — tell API what we're uploading
+    const initResult = await client.media.initializeUpload({
+        body: {
+            mediaType,
+            mediaCategory,
+            totalBytes: fileSize,
+        },
+    });
+    const mediaId = initResult.data
+        ?.id;
+    if (!mediaId) {
+        throw new Error("Failed to initialize upload (no media ID returned)");
+    }
+    // APPEND — send file in chunks through SDK so auth and request formatting
+    // stay consistent with the rest of the client.
+    const fd = fs.openSync(filePath, "r");
+    try {
+        let segmentIndex = 0;
+        let bytesRead = 0;
+        while (bytesRead < fileSize) {
+            const chunkLen = Math.min(CHUNK_SIZE, fileSize - bytesRead);
+            const buffer = Buffer.alloc(chunkLen);
+            fs.readSync(fd, buffer, 0, chunkLen, bytesRead);
+            await client.media.appendUpload(mediaId, {
+                body: {
+                    media: buffer.toString("base64"),
+                    segmentIndex,
+                },
+            });
+            bytesRead += chunkLen;
+            segmentIndex++;
+            // Show progress for large uploads
+            const pct = Math.round((bytesRead / fileSize) * 100);
+            console.error(`Uploading... ${pct}%`);
+        }
+    }
+    finally {
+        fs.closeSync(fd);
+    }
+    // FINALIZE — tell API we're done
+    const finalResult = await client.media.finalizeUpload(mediaId);
+    const finalData = finalResult.data;
+    // Poll for processing completion if needed (video transcoding)
+    if (mediaCategory === "tweet_video" || finalData?.processingInfo) {
+        await waitForProcessing(client, mediaId);
+    }
+    return mediaId;
+}
+/**
+ * Poll the upload status endpoint until processing completes.
+ * Videos require server-side transcoding that takes time.
+ */
+async function waitForProcessing(client, mediaId) {
+    const maxAttempts = 60;
+    for (let i = 0; i < maxAttempts; i++) {
+        const status = await client.media.getUploadStatus(mediaId, {
+            command: "STATUS",
+        });
+        const data = status.data;
+        const info = data?.processingInfo;
+        if (!info || info.state === "succeeded")
+            return;
+        if (info.state === "failed") {
+            throw new Error(`Media processing failed: ${info.error?.message ?? "unknown error"}`);
+        }
+        // Wait the suggested interval or default to 5 seconds
+        const waitSecs = info.checkAfterSecs ?? 5;
+        console.error(`Processing... (check again in ${waitSecs}s)`);
+        await new Promise((r) => setTimeout(r, waitSecs * 1000));
+    }
+    throw new Error("Media processing timed out");
+}
+/**
+ * Upload a file using one-shot upload (images only, ≤5MB).
+ * Returns the media_id string.
+ */
+async function oneShotUpload(client, filePath, mediaType, mediaCategory) {
+    const fileData = fs.readFileSync(filePath);
+    const base64 = fileData.toString("base64");
+    const result = await client.media.upload({
+        body: {
+            media: base64,
+            mediaType,
+            mediaCategory,
+        },
+    });
+    const mediaId = result.data?.id;
+    if (!mediaId) {
+        throw new Error("Upload failed (no media ID returned)");
+    }
+    return mediaId;
+}
+/**
+ * Upload a file and return its media_id.
+ * Automatically selects one-shot vs. chunked upload based on type.
+ */
+export async function uploadMedia(filePath, accountName) {
+    const ext = path.extname(filePath).toLowerCase();
+    const mediaType = MIME_MAP[ext];
+    if (!mediaType) {
+        throw new Error(`Unsupported file type: ${ext}`);
+    }
+    const mediaCategory = CATEGORY_MAP[ext] ?? "tweet_image";
+    const sizeLimit = SIZE_LIMITS[mediaCategory] ?? SIZE_LIMITS.tweet_image;
+    const fileSize = fs.statSync(filePath).size;
+    if (fileSize > sizeLimit) {
+        const limitMB = Math.round(sizeLimit / 1024 / 1024);
+        throw new Error(`File too large (${Math.round(fileSize / 1024 / 1024)}MB). ` +
+            `${mediaCategory} limit is ${limitMB}MB.`);
+    }
+    const client = await getClient(accountName);
+    // Use one-shot for small images, chunked for GIFs and videos
+    if (mediaCategory === "tweet_image") {
+        return oneShotUpload(client, filePath, mediaType, mediaCategory);
+    }
+    return chunkedUpload(client, filePath, mediaType, mediaCategory);
+}
+export function registerMediaCommand(program) {
+    const media = program
+        .command("media")
+        .description("Media upload operations");
+    media
+        .command("upload <file>")
+        .description("Upload media and return media_id")
+        .option("--json", "Output raw JSON")
+        .option("--account <name>", "Account to use")
+        .action(async (file, opts) => {
+        try {
+            const filePath = path.resolve(file);
+            if (!fs.existsSync(filePath)) {
+                console.error(`Error: file not found: ${filePath}`);
+                process.exit(1);
+            }
+            const mediaId = await uploadMedia(filePath, opts.account);
+            if (opts.json) {
+                outputJson({ mediaId });
+                return;
+            }
+            console.log(`Uploaded: media_id=${mediaId}`);
+        }
+        catch (err) {
+            console.error(`Error: ${err instanceof Error ? err.message : err}`);
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=media.js.map

package/dist/commands/media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.js","sourceRoot":"","sources":["../../src/commands/media.ts"],"names":[],"mappings":"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"}

package/dist/commands/mentions.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Mentions timeline command.
+ *
+ * Usage:
+ *   xc mentions [username]  — view mentions (defaults to authenticated user)
+ */
+import { Command } from "commander";
+export declare function registerMentionsCommand(program: Command): void;