@dotta/xc 0.1.0

package/dist/__tests__/media.test.js

@@ -0,0 +1,132 @@
+/**
+ * Tests for media upload command.
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+import { Command } from "commander";
+import { registerMediaCommand, uploadMedia } from "../commands/media.js";
+vi.mock("../lib/api.js", () => ({
+    getClient: vi.fn(),
+}));
+vi.mock("../lib/resolve.js", () => ({
+    resolveUserId: vi.fn(),
+    resolveAuthenticatedUserId: vi.fn(),
+}));
+vi.mock("../lib/cost.js", () => ({
+    logApiCall: vi.fn(),
+    formatCostFooter: vi.fn(() => ""),
+    estimateCost: vi.fn(() => 0),
+    loadUsageLog: vi.fn(() => []),
+    computeTodaySpend: vi.fn(() => 0),
+}));
+vi.mock("../lib/budget.js", () => ({
+    checkBudget: vi.fn(),
+    loadBudget: vi.fn(() => ({ action: "warn" })),
+}));
+import { getClient } from "../lib/api.js";
+describe("media command registration", () => {
+    it("registers media upload subcommand", () => {
+        const program = new Command();
+        program.exitOverride();
+        registerMediaCommand(program);
+        const media = program.commands.find((c) => c.name() === "media");
+        expect(media).toBeDefined();
+        const subNames = media.commands.map((c) => c.name());
+        expect(subNames).toContain("upload");
+    });
+});
+describe("uploadMedia", () => {
+    let tmpDir;
+    beforeEach(() => {
+        tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "xc-media-test-"));
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+    });
+    it("rejects unsupported file types", async () => {
+        const file = path.join(tmpDir, "test.xyz");
+        fs.writeFileSync(file, "data");
+        await expect(uploadMedia(file)).rejects.toThrow("Unsupported file type");
+    });
+    it("rejects files exceeding size limit", async () => {
+        const file = path.join(tmpDir, "huge.jpg");
+        // Create a sparse file that reports > 5MB
+        const fd = fs.openSync(file, "w");
+        fs.ftruncateSync(fd, 6 * 1024 * 1024);
+        fs.closeSync(fd);
+        await expect(uploadMedia(file)).rejects.toThrow("File too large");
+    });
+    it("uses one-shot upload for images", async () => {
+        const file = path.join(tmpDir, "photo.jpg");
+        fs.writeFileSync(file, Buffer.alloc(1024)); // 1KB image
+        const mockUpload = vi.fn().mockResolvedValue({
+            data: { id: "media_123" },
+        });
+        vi.mocked(getClient).mockResolvedValue({
+            media: { upload: mockUpload },
+        });
+        const result = await uploadMedia(file);
+        expect(result).toBe("media_123");
+        expect(mockUpload).toHaveBeenCalledWith(expect.objectContaining({
+            body: expect.objectContaining({
+                mediaType: "image/jpeg",
+                mediaCategory: "tweet_image",
+            }),
+        }));
+    });
+    it("uses chunked upload for GIFs", async () => {
+        const file = path.join(tmpDir, "anim.gif");
+        fs.writeFileSync(file, Buffer.alloc(1024));
+        const mockInit = vi.fn().mockResolvedValue({ data: { id: "m_456" } });
+        const mockAppend = vi.fn().mockResolvedValue({});
+        const mockFinalize = vi.fn().mockResolvedValue({ data: {} });
+        vi.mocked(getClient).mockResolvedValue({
+            media: {
+                initializeUpload: mockInit,
+                appendUpload: mockAppend,
+                finalizeUpload: mockFinalize,
+            },
+        });
+        // Suppress progress output
+        vi.spyOn(console, "error").mockImplementation(() => { });
+        const result = await uploadMedia(file);
+        expect(result).toBe("m_456");
+        expect(mockInit).toHaveBeenCalled();
+        expect(mockAppend).toHaveBeenCalledWith("m_456", expect.anything());
+        expect(mockFinalize).toHaveBeenCalledWith("m_456");
+        vi.mocked(console.error).mockRestore();
+    });
+    it("polls processing status for videos", async () => {
+        const file = path.join(tmpDir, "clip.mp4");
+        fs.writeFileSync(file, Buffer.alloc(1024));
+        const mockInit = vi.fn().mockResolvedValue({ data: { id: "m_789" } });
+        const mockAppend = vi.fn().mockResolvedValue({});
+        const mockFinalize = vi.fn().mockResolvedValue({
+            data: { processingInfo: { state: "pending", checkAfterSecs: 0 } },
+        });
+        const mockStatus = vi.fn().mockResolvedValue({
+            data: { processingInfo: { state: "succeeded" } },
+        });
+        vi.mocked(getClient).mockResolvedValue({
+            media: {
+                initializeUpload: mockInit,
+                appendUpload: mockAppend,
+                finalizeUpload: mockFinalize,
+                getUploadStatus: mockStatus,
+            },
+        });
+        // Suppress progress output
+        vi.spyOn(console, "error").mockImplementation(() => { });
+        const result = await uploadMedia(file);
+        expect(result).toBe("m_789");
+        expect(mockFinalize).toHaveBeenCalledWith("m_789");
+        expect(mockStatus).toHaveBeenCalledWith("m_789", expect.objectContaining({
+            command: "STATUS",
+        }));
+        vi.mocked(console.error).mockRestore();
+    });
+});
+//# sourceMappingURL=media.test.js.map

package/dist/__tests__/media.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.test.js","sourceRoot":"","sources":["../../src/__tests__/media.test.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEzE,EAAE,CAAC,IAAI,CAAC,eAAe,EAAE,GAAG,EAAE,CAAC,CAAC;IAC9B,SAAS,EAAE,EAAE,CAAC,EAAE,EAAE;CACnB,CAAC,CAAC,CAAC;AAEJ,EAAE,CAAC,IAAI,CAAC,mBAAmB,EAAE,GAAG,EAAE,CAAC,CAAC;IAClC,aAAa,EAAE,EAAE,CAAC,EAAE,EAAE;IACtB,0BAA0B,EAAE,EAAE,CAAC,EAAE,EAAE;CACpC,CAAC,CAAC,CAAC;AAEJ,EAAE,CAAC,IAAI,CAAC,gBAAgB,EAAE,GAAG,EAAE,CAAC,CAAC;IAC/B,UAAU,EAAE,EAAE,CAAC,EAAE,EAAE;IACnB,gBAAgB,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC;IACjC,YAAY,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAC5B,YAAY,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC;IAC7B,iBAAiB,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;CAClC,CAAC,CAAC,CAAC;AAEJ,EAAE,CAAC,IAAI,CAAC,kBAAkB,EAAE,GAAG,EAAE,CAAC,CAAC;IACjC,WAAW,EAAE,EAAE,CAAC,EAAE,EAAE;IACpB,UAAU,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAC9C,CAAC,CAAC,CAAC;AAEJ,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;IAC1C,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;QAC9B,OAAO,CAAC,YAAY,EAAE,CAAC;QACvB,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAE9B,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,OAAO,CAAC,CAAC;QACjE,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;QAE5B,MAAM,QAAQ,GAAG,KAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACtD,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,IAAI,MAAc,CAAC;IAEnB,UAAU,CAAC,GAAG,EAAE;QACd,MAAM,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC;QAClE,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,KAAK,IAAI,EAAE;QAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAC3C,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAE/B,MAAM,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,KAAK,IAAI,EAAE;QAClD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAC3C,0CAA0C;QAC1C,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAClC,EAAE,CAAC,aAAa,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC;QACtC,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAEjB,MAAM,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,KAAK,IAAI,EAAE;QAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAC5C,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY;QAExD,MAAM,UAAU,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;YAC3C,IAAI,EAAE,EAAE,EAAE,EAAE,WAAW,EAAE;SAC1B,CAAC,CAAC;QAEH,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,iBAAiB,CAAC;YACrC,KAAK,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE;SACsB,CAAC,CAAC;QAEvD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACjC,MAAM,CAAC,UAAU,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC,gBAAgB,CAAC;YAC9D,IAAI,EAAE,MAAM,CAAC,gBAAgB,CAAC;gBAC5B,SAAS,EAAE,YAAY;gBACvB,aAAa,EAAE,aAAa;aAC7B,CAAC;SACH,CAAC,CAAC,CAAC;IACN,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,KAAK,IAAI,EAAE;QAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAC3C,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAE3C,MAAM,QAAQ,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;QACtE,MAAM,UAAU,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;QACjD,MAAM,YAAY,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QAE7D,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,iBAAiB,CAAC;YACrC,KAAK,EAAE;gBACL,gBAAgB,EAAE,QAAQ;gBAC1B,YAAY,EAAE,UAAU;gBACxB,cAAc,EAAE,YAAY;aAC7B;SACkD,CAAC,CAAC;QAEvD,2BAA2B;QAC3B,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAExD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7B,MAAM,CAAC,QAAQ,CAAC,CAAC,gBAAgB,EAAE,CAAC;QACpC,MAAM,CAAC,UAAU,CAAC,CAAC,oBAAoB,CAAC,OAAO,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QACpE,MAAM,CAAC,YAAY,CAAC,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAEnD,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,KAAK,IAAI,EAAE;QAClD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAC3C,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAE3C,MAAM,QAAQ,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;QACtE,MAAM,UAAU,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;QACjD,MAAM,YAAY,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;YAC7C,IAAI,EAAE,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC,EAAE,EAAE;SAClE,CAAC,CAAC;QACH,MAAM,UAAU,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;YAC3C,IAAI,EAAE,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE;SACjD,CAAC,CAAC;QAEH,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,iBAAiB,CAAC;YACrC,KAAK,EAAE;gBACL,gBAAgB,EAAE,QAAQ;gBAC1B,YAAY,EAAE,UAAU;gBACxB,cAAc,EAAE,YAAY;gBAC5B,eAAe,EAAE,UAAU;aAC5B;SACkD,CAAC,CAAC;QAEvD,2BAA2B;QAC3B,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAExD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7B,MAAM,CAAC,YAAY,CAAC,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;QACnD,MAAM,CAAC,UAAU,CAAC,CAAC,oBAAoB,CAAC,OAAO,EAAE,MAAM,CAAC,gBAAgB,CAAC;YACvE,OAAO,EAAE,QAAQ;SAClB,CAAC,CAAC,CAAC;QAEJ,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IACzC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,93 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { registerAuthCommand } from "./commands/auth.js";
+import { registerBlockCommand, registerUnblockCommand, registerBlockedCommand } from "./commands/block.js";
+import { registerBookmarksCommand, registerBookmarkCommand, registerUnbookmarkCommand, } from "./commands/bookmarks.js";
+import { registerBudgetCommand } from "./commands/budget.js";
+import { registerCostCommand } from "./commands/cost.js";
+import { registerDmCommand } from "./commands/dm.js";
+import { registerQuotesCommand, registerLikesCommand, registerRepostsCommand, registerLikedCommand, } from "./commands/engagement.js";
+import { registerFollowersCommand, registerFollowingCommand, registerFollowCommand, registerUnfollowCommand, } from "./commands/followers.js";
+import { registerHideCommand, registerUnhideCommand } from "./commands/hide.js";
+import { registerLikeCommand, registerUnlikeCommand } from "./commands/like.js";
+import { registerListsCommand, registerListCommand } from "./commands/lists.js";
+import { registerMediaCommand } from "./commands/media.js";
+import { registerMentionsCommand } from "./commands/mentions.js";
+import { registerMuteCommand, registerUnmuteCommand, registerMutedCommand } from "./commands/mute.js";
+import { registerDeleteCommand } from "./commands/delete.js";
+import { registerGetCommand } from "./commands/get.js";
+import { registerPostCommand } from "./commands/post.js";
+import { registerRepostCommand, registerUnrepostCommand } from "./commands/repost.js";
+import { registerSearchCommand } from "./commands/search.js";
+import { registerStreamCommand } from "./commands/stream.js";
+import { registerTimelineCommand } from "./commands/timeline.js";
+import { registerTrendsCommand } from "./commands/trends.js";
+import { registerUsageCommand } from "./commands/usage.js";
+import { registerUserCommand } from "./commands/user.js";
+import { registerUserSearchCommand } from "./commands/usersearch.js";
+import { registerWhoamiCommand } from "./commands/whoami.js";
+import { formatCostFooter } from "./lib/cost.js";
+const program = new Command();
+program
+    .name("xc")
+    .description("CLI client for the X API v2")
+    .version("0.1.0")
+    .option("--quiet", "Suppress cost footer");
+registerAuthCommand(program);
+registerWhoamiCommand(program);
+registerSearchCommand(program);
+registerStreamCommand(program);
+registerDeleteCommand(program);
+registerGetCommand(program);
+registerPostCommand(program);
+registerUserCommand(program);
+registerTimelineCommand(program);
+registerMentionsCommand(program);
+registerLikeCommand(program);
+registerUnlikeCommand(program);
+registerRepostCommand(program);
+registerUnrepostCommand(program);
+registerQuotesCommand(program);
+registerLikesCommand(program);
+registerRepostsCommand(program);
+registerLikedCommand(program);
+registerHideCommand(program);
+registerUnhideCommand(program);
+registerBlockCommand(program);
+registerUnblockCommand(program);
+registerBlockedCommand(program);
+registerMuteCommand(program);
+registerUnmuteCommand(program);
+registerMutedCommand(program);
+registerUserSearchCommand(program);
+registerUsageCommand(program);
+registerCostCommand(program);
+registerBudgetCommand(program);
+registerDmCommand(program);
+registerMediaCommand(program);
+registerBookmarksCommand(program);
+registerBookmarkCommand(program);
+registerUnbookmarkCommand(program);
+registerListsCommand(program);
+registerListCommand(program);
+registerTrendsCommand(program);
+registerFollowersCommand(program);
+registerFollowingCommand(program);
+registerFollowCommand(program);
+registerUnfollowCommand(program);
+// Show cost footer after every command (unless --quiet or --json)
+program.hook("postAction", (_, actionCommand) => {
+    const opts = program.opts();
+    if (opts.quiet)
+        return;
+    if (actionCommand.opts().json)
+        return;
+    const footer = formatCostFooter();
+    if (footer) {
+        console.error(`\n${footer}`);
+    }
+});
+program.parseAsync().then(() => {
+    process.exit(0);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/commands/auth.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function registerAuthCommand(program: Command): void;

package/dist/commands/auth.js

@@ -0,0 +1,191 @@
+import { Client } from "@xdevplatform/xdk";
+import open from "open";
+import { getConfigPath, loadConfig, saveConfig, setAccount, setDefaultAccount, } from "../lib/config.js";
+import { runOAuthFlow } from "../lib/oauth.js";
+export function registerAuthCommand(program) {
+    const auth = program.command("auth").description("Manage authentication");
+    // xc auth login
+    auth
+        .command("login")
+        .description("Authenticate with X via OAuth 2.0 (PKCE)")
+        .option("--account <name>", "Account name", "default")
+        .option("--client-id <id>", "OAuth 2.0 Client ID (or set XC_CLIENT_ID)")
+        .option("--client-secret <secret>", "OAuth 2.0 Client Secret (or set XC_CLIENT_SECRET)")
+        .option("--port <port>", "Local callback port", "3391")
+        .action(async (opts) => {
+        const clientId = opts.clientId ?? process.env.XC_CLIENT_ID;
+        if (!clientId) {
+            console.error("Error: OAuth Client ID required.");
+            console.error("");
+            console.error("Get one at https://console.x.com → Apps → Create App");
+            console.error("");
+            console.error("Then either:");
+            console.error("  xc auth login --client-id <YOUR_CLIENT_ID>");
+            console.error("  export XC_CLIENT_ID=<YOUR_CLIENT_ID>");
+            process.exit(1);
+        }
+        console.log("Starting OAuth 2.0 flow...");
+        console.log("A browser window will open for authorization.\n");
+        try {
+            const clientSecret = opts.clientSecret ?? process.env.XC_CLIENT_SECRET;
+            const result = await runOAuthFlow({
+                clientId,
+                clientSecret,
+                port: parseInt(opts.port, 10),
+                onOpenUrl: async (url) => {
+                    console.log("Opening browser...");
+                    console.log(`If it doesn't open, visit:\n${url}\n`);
+                    await open(url);
+                },
+            });
+            // Save credentials
+            setAccount(opts.account, {
+                name: opts.account,
+                auth: {
+                    type: "oauth2",
+                    accessToken: result.accessToken,
+                    refreshToken: result.refreshToken,
+                    expiresAt: result.expiresAt,
+                    clientId,
+                    ...(clientSecret ? { clientSecret } : {}),
+                },
+            });
+            // Fetch user info using SDK client directly with new token
+            try {
+                const client = new Client({ accessToken: result.accessToken });
+                const me = await client.users.getMe({ userFields: ["username"] });
+                if (me.data) {
+                    const config = loadConfig();
+                    const account = config.accounts[opts.account];
+                    if (account) {
+                        account.userId = me.data.id;
+                        account.username = me.data.username;
+                        saveConfig(config);
+                    }
+                    console.log(`\n✓ Authenticated as @${me.data.username} (${me.data.name})`);
+                    console.log(`  Account: ${opts.account}`);
+                    console.log(`  Scopes: ${result.scopes}`);
+                }
+                else {
+                    console.log(`\n✓ Authenticated (account: ${opts.account})`);
+                    console.log(`  Scopes: ${result.scopes}`);
+                }
+            }
+            catch {
+                console.log(`\n✓ Authenticated (account: ${opts.account})`);
+                console.log(`  Scopes: ${result.scopes}`);
+                console.log("  Note: Could not fetch user info.");
+            }
+            // Set as default if it's the first account
+            const config = loadConfig();
+            if (Object.keys(config.accounts).length === 1) {
+                setDefaultAccount(opts.account);
+                console.log(`  Set as default account.`);
+            }
+            console.log(`\nConfig: ${getConfigPath()}`);
+        }
+        catch (err) {
+            console.error(`\nAuth failed: ${err instanceof Error ? err.message : err}`);
+            process.exit(1);
+        }
+    });
+    // xc auth token
+    auth
+        .command("token <bearer-token>")
+        .description("Set a Bearer token for app-only auth")
+        .option("--account <name>", "Account name", "default")
+        .action((bearerToken, opts) => {
+        setAccount(opts.account, {
+            name: opts.account,
+            auth: {
+                type: "bearer",
+                bearerToken,
+            },
+        });
+        // Set as default if first account
+        const config = loadConfig();
+        if (Object.keys(config.accounts).length === 1) {
+            setDefaultAccount(opts.account);
+        }
+        console.log(`✓ Bearer token saved (account: ${opts.account})`);
+        console.log(`  Config: ${getConfigPath()}`);
+        console.log(`\nTest with: xc whoami`);
+    });
+    // xc auth status
+    auth
+        .command("status")
+        .description("Show current auth status")
+        .action(() => {
+        const config = loadConfig();
+        const accountNames = Object.keys(config.accounts);
+        if (accountNames.length === 0) {
+            console.log("No accounts configured.\n");
+            console.log("Get started:");
+            console.log("  xc auth login          # OAuth 2.0 (read + write)");
+            console.log("  xc auth token <TOKEN>  # Bearer token (read only)");
+            return;
+        }
+        console.log(`Accounts (${accountNames.length}):\n`);
+        for (const name of accountNames) {
+            const account = config.accounts[name];
+            const isDefault = name === config.defaultAccount;
+            const marker = isDefault ? " (default)" : "";
+            const { auth } = account;
+            const username = account.username ? `@${account.username}` : "unknown";
+            const type = auth.type === "oauth2" ? "OAuth 2.0" : "Bearer";
+            let status = "✓";
+            if (auth.type === "oauth2" && auth.expiresAt) {
+                const remaining = auth.expiresAt - Date.now();
+                if (remaining <= 0) {
+                    status = auth.refreshToken ? "⟳ expired (has refresh)" : "✗ expired";
+                }
+                else {
+                    const hours = Math.floor(remaining / 3_600_000);
+                    const mins = Math.floor((remaining % 3_600_000) / 60_000);
+                    status = `✓ ${hours}h${mins}m remaining`;
+                }
+            }
+            console.log(`  ${name}${marker}`);
+            console.log(`    User: ${username}`);
+            console.log(`    Auth: ${type} — ${status}`);
+            console.log("");
+        }
+    });
+    // xc auth switch
+    auth
+        .command("switch <account>")
+        .description("Switch default account")
+        .action((account) => {
+        const config = loadConfig();
+        if (!config.accounts[account]) {
+            console.error(`Account "${account}" not found.`);
+            console.error(`Available: ${Object.keys(config.accounts).join(", ")}`);
+            process.exit(1);
+        }
+        setDefaultAccount(account);
+        const username = config.accounts[account]?.username;
+        console.log(`✓ Switched to ${account}${username ? ` (@${username})` : ""}`);
+    });
+    // xc auth logout
+    auth
+        .command("logout")
+        .description("Remove an account")
+        .option("--account <name>", "Account to remove (default: current)")
+        .action((opts) => {
+        const config = loadConfig();
+        const name = opts.account ?? config.defaultAccount;
+        if (!config.accounts[name]) {
+            console.error(`Account "${name}" not found.`);
+            process.exit(1);
+        }
+        delete config.accounts[name];
+        // If we removed the default, pick another
+        if (config.defaultAccount === name) {
+            const remaining = Object.keys(config.accounts);
+            config.defaultAccount = remaining[0] ?? "default";
+        }
+        saveConfig(config);
+        console.log(`✓ Removed account "${name}"`);
+    });
+}
+//# sourceMappingURL=auth.js.map

package/dist/commands/auth.js.map

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

package/dist/commands/block.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Block/unblock/blocked commands.
+ *
+ * Note: The XDK SDK does not expose block/unblock user methods (only blockDms/unblockDms).
+ * We use the Client's httpClient for raw POST/DELETE to the X API v2 block endpoints.
+ *
+ * Usage:
+ *   xc block <username>    — block a user
+ *   xc unblock <username>  — unblock a user
+ *   xc blocked             — list blocked users
+ */
+import { Command } from "commander";
+export declare function registerBlockCommand(program: Command): void;
+export declare function registerUnblockCommand(program: Command): void;
+export declare function registerBlockedCommand(program: Command): void;

package/dist/commands/block.js

@@ -0,0 +1,117 @@
+/**
+ * Block/unblock/blocked commands.
+ *
+ * Note: The XDK SDK does not expose block/unblock user methods (only blockDms/unblockDms).
+ * We use the Client's httpClient for raw POST/DELETE to the X API v2 block endpoints.
+ *
+ * Usage:
+ *   xc block <username>    — block a user
+ *   xc unblock <username>  — unblock a user
+ *   xc blocked             — list blocked users
+ */
+import { getClient } from "../lib/api.js";
+import { outputJson } from "../lib/cost.js";
+import { resolveAuthenticatedUserId, resolveUserId, } from "../lib/resolve.js";
+import { formatUserLine } from "../lib/format.js";
+export function registerBlockCommand(program) {
+    program
+        .command("block <username>")
+        .description("Block a user")
+        .option("--json", "Output raw JSON")
+        .option("--account <name>", "Account to use")
+        .action(async (username, opts) => {
+        try {
+            const myId = await resolveAuthenticatedUserId(opts.account);
+            const targetId = await resolveUserId(username, opts.account);
+            const client = await getClient(opts.account);
+            // SDK gap: no blockUser method — use raw HTTP
+            const c = client;
+            const token = c.accessToken ?? c.bearerToken ?? "";
+            const headers = {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${token}`,
+            };
+            const url = `${c.baseUrl || "https://api.x.com"}/2/users/${myId}/blocking`;
+            const response = await c.httpClient.post(url, JSON.stringify({ target_user_id: targetId }), headers);
+            const result = JSON.parse(response.body);
+            if (opts.json) {
+                outputJson(result);
+                return;
+            }
+            console.log(`Blocked @${username.replace(/^@/, "")}`);
+        }
+        catch (err) {
+            console.error(`Error: ${err instanceof Error ? err.message : err}`);
+            process.exit(1);
+        }
+    });
+}
+export function registerUnblockCommand(program) {
+    program
+        .command("unblock <username>")
+        .description("Unblock a user")
+        .option("--json", "Output raw JSON")
+        .option("--account <name>", "Account to use")
+        .action(async (username, opts) => {
+        try {
+            const myId = await resolveAuthenticatedUserId(opts.account);
+            const targetId = await resolveUserId(username, opts.account);
+            const client = await getClient(opts.account);
+            // SDK gap: no unblockUser method — use raw HTTP
+            const c = client;
+            const token = c.accessToken ?? c.bearerToken ?? "";
+            const headers = {
+                Authorization: `Bearer ${token}`,
+            };
+            const url = `${c.baseUrl || "https://api.x.com"}/2/users/${myId}/blocking/${targetId}`;
+            const response = await c.httpClient.delete(url, headers);
+            const result = JSON.parse(response.body);
+            if (opts.json) {
+                outputJson(result);
+                return;
+            }
+            console.log(`Unblocked @${username.replace(/^@/, "")}`);
+        }
+        catch (err) {
+            console.error(`Error: ${err instanceof Error ? err.message : err}`);
+            process.exit(1);
+        }
+    });
+}
+export function registerBlockedCommand(program) {
+    program
+        .command("blocked")
+        .description("List blocked users")
+        .option("-n, --limit <n>", "Max results (1-1000)", "100")
+        .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.getBlocking(userId, {
+                userFields: ["username", "name", "public_metrics", "description"],
+                maxResults: parseInt(opts.limit, 10),
+            });
+            if (opts.json) {
+                outputJson(result);
+                return;
+            }
+            const users = (result.data ?? []);
+            if (users.length === 0) {
+                console.log("No blocked users.");
+                return;
+            }
+            console.log("Blocked users:\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);
+        }
+    });
+}
+//# sourceMappingURL=block.js.map

package/dist/commands/block.js.map

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

package/dist/commands/bookmarks.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Bookmarks commands: list, add, and remove bookmarks.
+ *
+ * Usage:
+ *   xc bookmarks              — list bookmarked posts
+ *   xc bookmark <post-id>     — add a post to bookmarks
+ *   xc unbookmark <post-id>   — remove from bookmarks
+ */
+import { Command } from "commander";
+export declare function registerBookmarksCommand(program: Command): void;
+export declare function registerBookmarkCommand(program: Command): void;
+export declare function registerUnbookmarkCommand(program: Command): void;