@dotta/xc 0.1.0

package/dist/commands/stream.js

@@ -0,0 +1,251 @@
+/**
+ * Stream commands: manage filtered stream rules and connect to the stream.
+ *
+ * Subcommands:
+ *   xc stream add <query> [--tag <name>]  — add a filtered stream rule
+ *   xc stream rules                       — list current rules
+ *   xc stream remove <rule-id>            — remove a rule by ID
+ *   xc stream clear                       — remove all rules
+ *   xc stream connect [--json] [--quiet]  — connect and output matching posts
+ */
+import { getClient } from "../lib/api.js";
+import { outputJson } from "../lib/cost.js";
+/** Register the `stream` command group with its subcommands. */
+export function registerStreamCommand(program) {
+    const stream = program
+        .command("stream")
+        .description("Manage filtered stream rules and connect");
+    // --- stream add <query> ---
+    stream
+        .command("add <query>")
+        .description("Add a filtered stream rule")
+        .option("--tag <name>", "Label for this rule")
+        .option("--account <name>", "Account to use")
+        .option("--json", "Output raw JSON")
+        .action(async (query, opts) => {
+        try {
+            const client = await getClient(opts.account);
+            // Build the add-rules request body
+            const rule = { value: query };
+            if (opts.tag)
+                rule.tag = opts.tag;
+            const result = await client.stream.updateRules({ add: [rule] });
+            if (opts.json) {
+                outputJson(result);
+                return;
+            }
+            const rules = result.data ?? [];
+            if (rules.length > 0) {
+                for (const r of rules) {
+                    console.log(`Added rule ${r.id}: ${r.value}${r.tag ? ` [${r.tag}]` : ""}`);
+                }
+            }
+            else {
+                console.log("No rules added.");
+                // Show errors if present
+                if (result.errors) {
+                    for (const e of result.errors) {
+                        console.error(`  Error: ${JSON.stringify(e)}`);
+                    }
+                }
+            }
+        }
+        catch (err) {
+            console.error(`Error: ${err instanceof Error ? err.message : err}`);
+            process.exit(1);
+        }
+    });
+    // --- stream rules ---
+    stream
+        .command("rules")
+        .description("List current filtered stream rules")
+        .option("--account <name>", "Account to use")
+        .option("--json", "Output raw JSON")
+        .action(async (opts) => {
+        try {
+            const client = await getClient(opts.account);
+            const result = await client.stream.getRules();
+            if (opts.json) {
+                outputJson(result);
+                return;
+            }
+            const rules = result.data ?? [];
+            if (rules.length === 0) {
+                console.log("No rules configured.");
+                return;
+            }
+            for (const r of rules) {
+                const tag = r.tag ? ` [${r.tag}]` : "";
+                console.log(`  ${r.id}  ${r.value}${tag}`);
+            }
+            console.log(`\n${rules.length} rule${rules.length !== 1 ? "s" : ""}`);
+        }
+        catch (err) {
+            console.error(`Error: ${err instanceof Error ? err.message : err}`);
+            process.exit(1);
+        }
+    });
+    // --- stream remove <rule-id> ---
+    stream
+        .command("remove <ruleId>")
+        .description("Remove a filtered stream rule by ID")
+        .option("--account <name>", "Account to use")
+        .option("--json", "Output raw JSON")
+        .action(async (ruleId, opts) => {
+        try {
+            const client = await getClient(opts.account);
+            const result = await client.stream.updateRules({
+                delete: { ids: [ruleId] },
+            });
+            if (opts.json) {
+                outputJson(result);
+                return;
+            }
+            const summary = result.meta?.summary;
+            const deleted = summary?.deleted ?? 0;
+            if (deleted > 0) {
+                console.log(`Removed rule ${ruleId}`);
+            }
+            else {
+                console.log(`Rule ${ruleId} not found or already removed.`);
+                if (result.errors) {
+                    for (const e of result.errors) {
+                        console.error(`  Error: ${JSON.stringify(e)}`);
+                    }
+                }
+            }
+        }
+        catch (err) {
+            console.error(`Error: ${err instanceof Error ? err.message : err}`);
+            process.exit(1);
+        }
+    });
+    // --- stream clear ---
+    stream
+        .command("clear")
+        .description("Remove all filtered stream rules")
+        .option("--account <name>", "Account to use")
+        .option("--json", "Output raw JSON")
+        .action(async (opts) => {
+        try {
+            const client = await getClient(opts.account);
+            // First get all current rule IDs
+            const current = await client.stream.getRules();
+            const rules = current.data ?? [];
+            if (rules.length === 0) {
+                console.log("No rules to remove.");
+                return;
+            }
+            const ids = rules
+                .map((r) => r.id)
+                .filter((id) => !!id);
+            const result = await client.stream.updateRules({
+                delete: { ids },
+            });
+            if (opts.json) {
+                outputJson(result);
+                return;
+            }
+            const summary = result.meta?.summary;
+            const deleted = summary?.deleted ?? ids.length;
+            console.log(`Cleared ${deleted} rule${deleted !== 1 ? "s" : ""}.`);
+        }
+        catch (err) {
+            console.error(`Error: ${err instanceof Error ? err.message : err}`);
+            process.exit(1);
+        }
+    });
+    // --- stream connect ---
+    stream
+        .command("connect")
+        .description("Connect to filtered stream and output posts as they arrive")
+        .option("--json", "Output raw JSON lines")
+        .option("--quiet", "Output only post IDs")
+        .option("--account <name>", "Account to use")
+        .action(async (opts) => {
+        try {
+            const client = await getClient(opts.account);
+            // Connect to the filtered stream with tweet fields for human-readable output
+            const streamOpts = {};
+            if (!opts.quiet) {
+                streamOpts.tweetFields = ["created_at", "author_id", "text"];
+                streamOpts.expansions = ["author_id"];
+                streamOpts.userFields = ["name", "username"];
+            }
+            console.error("Connecting to filtered stream...");
+            const eventStream = await client.stream.posts(streamOpts);
+            // Handle graceful shutdown on Ctrl+C
+            const cleanup = () => {
+                console.error("\nDisconnecting...");
+                eventStream.close();
+                process.exit(0);
+            };
+            process.on("SIGINT", cleanup);
+            process.on("SIGTERM", cleanup);
+            console.error("Connected. Waiting for posts... (Ctrl+C to stop)\n");
+            // Listen for data events using the async iterator
+            for await (const event of eventStream) {
+                if (opts.json) {
+                    // Raw JSON lines mode
+                    console.log(JSON.stringify(event));
+                }
+                else if (opts.quiet) {
+                    // Just post IDs
+                    const id = event.data?.id;
+                    if (id)
+                        console.log(id);
+                }
+                else {
+                    // Human-readable output
+                    formatStreamEvent(event);
+                }
+            }
+            console.error("Stream ended.");
+        }
+        catch (err) {
+            console.error(`Error: ${err instanceof Error ? err.message : err}`);
+            process.exit(1);
+        }
+    });
+}
+/** Print a single streamed tweet event in human-readable format. */
+function formatStreamEvent(event) {
+    const tweet = event.data;
+    if (!tweet)
+        return;
+    const lines = [];
+    // Try to find author from includes
+    const authorId = tweet.author_id;
+    const users = event.includes?.users ?? [];
+    const author = authorId
+        ? users.find((u) => u.id === authorId)
+        : undefined;
+    if (author) {
+        lines.push(`@${author.username} (${author.name})`);
+    }
+    // Tweet text
+    const text = tweet.text ?? "";
+    lines.push(`  ${text.replace(/\n/g, "\n  ")}`);
+    // Matched rules
+    const rules = event.matching_rules ?? [];
+    if (rules.length > 0) {
+        const ruleLabels = rules
+            .map((r) => r.tag ?? r.id ?? "unknown")
+            .join(", ");
+        lines.push(`  rules: ${ruleLabels}`);
+    }
+    // ID and timestamp
+    const meta = [];
+    if (tweet.created_at) {
+        meta.push(new Date(tweet.created_at).toLocaleString());
+    }
+    if (tweet.id) {
+        meta.push(`id:${tweet.id}`);
+    }
+    if (meta.length > 0) {
+        lines.push(`  ${meta.join(" · ")}`);
+    }
+    console.log(lines.join("\n"));
+    console.log(); // blank line between tweets
+}
+//# sourceMappingURL=stream.js.map

package/dist/commands/stream.js.map

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

package/dist/commands/timeline.d.ts

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

package/dist/commands/timeline.js

@@ -0,0 +1,61 @@
+import { getClient } from "../lib/api.js";
+import { outputJson } from "../lib/cost.js";
+import { buildUserMap, formatTweetList } from "../lib/format.js";
+import { resolveAuthenticatedUserId, resolveUserId } from "../lib/resolve.js";
+const TWEET_FIELDS = ["created_at", "public_metrics", "author_id"];
+const EXPANSIONS = ["author_id"];
+const USER_FIELDS = ["name", "username"];
+export function registerTimelineCommand(program) {
+    program
+        .command("timeline [username]")
+        .description("View home timeline, or a user's posts with @username argument")
+        .option("-n, --limit <n>", "Max results (1-100)", "20")
+        .option("--json", "Output raw JSON")
+        .option("--account <name>", "Account to use")
+        .action(async (username, opts) => {
+        try {
+            const client = await getClient(opts.account);
+            const fieldOpts = {
+                tweetFields: TWEET_FIELDS,
+                expansions: EXPANSIONS,
+                userFields: USER_FIELDS,
+                maxResults: parseInt(opts.limit, 10),
+            };
+            let result;
+            if (username) {
+                // User timeline: fetch their posts
+                const userId = await resolveUserId(username, opts.account);
+                result = await client.users.getPosts(userId, fieldOpts);
+            }
+            else {
+                // Home timeline: reverse-chronological feed
+                const myId = await resolveAuthenticatedUserId(opts.account);
+                result = await client.users.getTimeline(myId, fieldOpts);
+            }
+            if (opts.json) {
+                outputJson(result);
+                return;
+            }
+            const tweets = result.data ?? [];
+            if (tweets.length === 0) {
+                console.log("No posts found.");
+                return;
+            }
+            const usersById = buildUserMap(result.includes?.users);
+            // Header
+            if (username) {
+                const clean = username.replace(/^@/, "");
+                console.log(`Posts from @${clean}:\n`);
+            }
+            else {
+                console.log("Home timeline:\n");
+            }
+            console.log(formatTweetList(tweets, usersById));
+        }
+        catch (err) {
+            console.error(`Error: ${err instanceof Error ? err.message : err}`);
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=timeline.js.map

package/dist/commands/timeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.js","sourceRoot":"","sources":["../../src/commands/timeline.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,0BAA0B,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAE9E,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;AAEzC,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,OAAO;SACJ,OAAO,CAAC,qBAAqB,CAAC;SAC9B,WAAW,CACV,+DAA+D,CAChE;SACA,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,QAA4B,EAAE,IAAI,EAAE,EAAE;QACnD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC7C,MAAM,SAAS,GAAG;gBAChB,WAAW,EAAE,YAAY;gBACzB,UAAU,EAAE,UAAU;gBACtB,UAAU,EAAE,WAAW;gBACvB,UAAU,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;aACrC,CAAC;YAEF,IAAI,MAAM,CAAC;YAEX,IAAI,QAAQ,EAAE,CAAC;gBACb,mCAAmC;gBACnC,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;gBAC3D,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YAC1D,CAAC;iBAAM,CAAC;gBACN,4CAA4C;gBAC5C,MAAM,IAAI,GAAG,MAAM,0BAA0B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAC5D,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YAC3D,CAAC;YAED,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,UAAU,CAAC,MAAM,CAAC,CAAC;gBACnB,OAAO;YACT,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACjC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACxB,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;gBAC/B,OAAO;YACT,CAAC;YAED,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YAEvD,SAAS;YACT,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBACzC,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,KAAK,CAAC,CAAC;YACzC,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;YAClC,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;QAClD,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/trends.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Trends commands: view trending topics.
+ *
+ * Usage:
+ *   xc trends              — personalized trends
+ *   xc trends <woeid>      — trends by location (WOEID)
+ *   xc trends --global     — worldwide trends (WOEID 1)
+ */
+import { Command } from "commander";
+export declare function registerTrendsCommand(program: Command): void;

package/dist/commands/trends.js

@@ -0,0 +1,59 @@
+/**
+ * Trends commands: view trending topics.
+ *
+ * Usage:
+ *   xc trends              — personalized trends
+ *   xc trends <woeid>      — trends by location (WOEID)
+ *   xc trends --global     — worldwide trends (WOEID 1)
+ */
+import { getClient } from "../lib/api.js";
+import { outputJson } from "../lib/cost.js";
+export function registerTrendsCommand(program) {
+    program
+        .command("trends [woeid]")
+        .description("View trending topics (personalized, by WOEID, or --global)")
+        .option("--global", "Show worldwide trends (WOEID 1)")
+        .option("--json", "Output raw JSON")
+        .option("--account <name>", "Account to use")
+        .action(async (woeid, opts) => {
+        try {
+            const client = await getClient(opts.account);
+            let result;
+            const locationId = opts.global ? 1 : woeid ? parseInt(woeid, 10) : undefined;
+            if (locationId !== undefined) {
+                result = await client.trends.getByWoeid(locationId);
+            }
+            else {
+                result = await client.trends.getPersonalized();
+            }
+            if (opts.json) {
+                outputJson(result);
+                return;
+            }
+            const trends = (result.data ?? []);
+            if (trends.length === 0) {
+                console.log("No trends found.");
+                return;
+            }
+            const label = locationId !== undefined
+                ? locationId === 1
+                    ? "Worldwide"
+                    : `WOEID ${locationId}`
+                : "Personalized";
+            console.log(`${label} trends:\n`);
+            for (let i = 0; i < trends.length; i++) {
+                const trend = trends[i];
+                const name = trend.trendName ?? trend.name ?? "Unknown";
+                const countStr = trend.tweetCount
+                    ? ` (${trend.tweetCount.toLocaleString()} posts)`
+                    : "";
+                console.log(`  ${i + 1}. ${name}${countStr}`);
+            }
+        }
+        catch (err) {
+            console.error(`Error: ${err instanceof Error ? err.message : err}`);
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=trends.js.map

package/dist/commands/trends.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trends.js","sourceRoot":"","sources":["../../src/commands/trends.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAU5C,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,OAAO;SACJ,OAAO,CAAC,gBAAgB,CAAC;SACzB,WAAW,CAAC,4DAA4D,CAAC;SACzE,MAAM,CAAC,UAAU,EAAE,iCAAiC,CAAC;SACrD,MAAM,CAAC,QAAQ,EAAE,iBAAiB,CAAC;SACnC,MAAM,CAAC,kBAAkB,EAAE,gBAAgB,CAAC;SAC5C,MAAM,CAAC,KAAK,EAAE,KAAyB,EAAE,IAAI,EAAE,EAAE;QAChD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAE7C,IAAI,MAAM,CAAC;YACX,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAE7E,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;gBAC7B,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;YACtD,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;YACjD,CAAC;YAED,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,UAAU,CAAC,MAAM,CAAC,CAAC;gBACnB,OAAO;YACT,CAAC;YAED,MAAM,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAY,CAAC;YAC9C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACxB,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;gBAChC,OAAO;YACT,CAAC;YAED,MAAM,KAAK,GAAG,UAAU,KAAK,SAAS;gBACpC,CAAC,CAAC,UAAU,KAAK,CAAC;oBAChB,CAAC,CAAC,WAAW;oBACb,CAAC,CAAC,SAAS,UAAU,EAAE;gBACzB,CAAC,CAAC,cAAc,CAAC;YACnB,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,YAAY,CAAC,CAAC;YAElC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACvC,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;gBACxB,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,IAAI,IAAI,SAAS,CAAC;gBACxD,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU;oBAC/B,CAAC,CAAC,KAAK,KAAK,CAAC,UAAU,CAAC,cAAc,EAAE,SAAS;oBACjD,CAAC,CAAC,EAAE,CAAC;gBACP,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,QAAQ,EAAE,CAAC,CAAC;YAChD,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"}

package/dist/commands/usage.d.ts

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

package/dist/commands/usage.js

@@ -0,0 +1,52 @@
+import { getClient } from "../lib/api.js";
+import { outputJson } from "../lib/cost.js";
+export function registerUsageCommand(program) {
+    program
+        .command("usage")
+        .description("Show API usage stats")
+        .option("--json", "Output raw JSON")
+        .option("--account <name>", "Account to use")
+        .action(async (opts) => {
+        try {
+            const client = await getClient(opts.account);
+            const result = await client.usage.get();
+            if (opts.json) {
+                outputJson(result);
+                return;
+            }
+            const data = result.data;
+            if (!data) {
+                console.log("No usage data available.");
+                return;
+            }
+            // Show cap reset day if present
+            if (data.capResetDay) {
+                console.log(`Cap resets on day ${data.capResetDay} of each month\n`);
+            }
+            // Summarize recent daily usage
+            const days = (data.dailyProjectUsage ?? []);
+            if (days.length === 0) {
+                console.log("No daily usage data available.");
+                return;
+            }
+            console.log("Daily tweet usage:\n");
+            for (const day of days) {
+                const date = new Date(day.date).toLocaleDateString();
+                const total = day.usage.reduce((sum, u) => sum + u.tweets, 0);
+                console.log(`  ${date}: ${total.toLocaleString()} tweets`);
+                // Per-app breakdown if multiple apps
+                if (day.usage.length > 1) {
+                    for (const u of day.usage) {
+                        const appName = u.app?.appName ?? "unknown";
+                        console.log(`    ${appName}: ${u.tweets.toLocaleString()}`);
+                    }
+                }
+            }
+        }
+        catch (err) {
+            console.error(`Error: ${err instanceof Error ? err.message : err}`);
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=usage.js.map

package/dist/commands/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/commands/usage.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAU5C,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,sBAAsB,CAAC;SACnC,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,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC7C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;YAExC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,UAAU,CAAC,MAAM,CAAC,CAAC;gBACnB,OAAO;YACT,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,CAAC,IAA2C,CAAC;YAChE,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;gBACxC,OAAO;YACT,CAAC;YAED,gCAAgC;YAChC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;gBACrB,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,CAAC,WAAW,kBAAkB,CAAC,CAAC;YACvE,CAAC;YAED,+BAA+B;YAC/B,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,iBAAiB,IAAI,EAAE,CAAsB,CAAC;YACjE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtB,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;gBAC9C,OAAO;YACT,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;YACpC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,kBAAkB,EAAE,CAAC;gBACrD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;gBAC9D,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,KAAK,KAAK,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;gBAE3D,qCAAqC;gBACrC,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACzB,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;wBAC1B,MAAM,OAAO,GAAG,CAAC,CAAC,GAAG,EAAE,OAAO,IAAI,SAAS,CAAC;wBAC5C,OAAO,CAAC,GAAG,CAAC,OAAO,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;oBAC9D,CAAC;gBACH,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"}

package/dist/commands/user.d.ts

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

package/dist/commands/user.js

@@ -0,0 +1,43 @@
+import { getClient } from "../lib/api.js";
+import { outputJson } from "../lib/cost.js";
+const USER_FIELDS = ["created_at", "description", "public_metrics"];
+export function registerUserCommand(program) {
+    program
+        .command("user <username>")
+        .description("Look up a user by @username")
+        .option("--json", "Output raw JSON")
+        .option("--account <name>", "Account to use")
+        .action(async (username, opts) => {
+        try {
+            const clean = username.replace(/^@/, "");
+            const client = await getClient(opts.account);
+            const result = await client.users.getByUsername(clean, {
+                userFields: USER_FIELDS,
+            });
+            if (opts.json) {
+                outputJson(result);
+                return;
+            }
+            const data = result.data;
+            if (!data) {
+                console.error(`User @${clean} not found.`);
+                process.exit(1);
+            }
+            const m = data.publicMetrics;
+            console.log(`@${data.username} (${data.name})`);
+            if (data.description)
+                console.log(`  ${data.description}`);
+            if (m) {
+                console.log(`  ${(m.followersCount ?? 0).toLocaleString()} followers · ${(m.followingCount ?? 0).toLocaleString()} following · ${(m.tweetCount ?? 0).toLocaleString()} posts`);
+            }
+            if (data.createdAt) {
+                console.log(`  Joined ${new Date(data.createdAt).toLocaleDateString()}`);
+            }
+        }
+        catch (err) {
+            console.error(`Error: ${err instanceof Error ? err.message : err}`);
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=user.js.map

package/dist/commands/user.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.js","sourceRoot":"","sources":["../../src/commands/user.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,MAAM,WAAW,GAAG,CAAC,YAAY,EAAE,aAAa,EAAE,gBAAgB,CAAC,CAAC;AAEpE,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,OAAO;SACJ,OAAO,CAAC,iBAAiB,CAAC;SAC1B,WAAW,CAAC,6BAA6B,CAAC;SAC1C,MAAM,CAAC,QAAQ,EAAE,iBAAiB,CAAC;SACnC,MAAM,CAAC,kBAAkB,EAAE,gBAAgB,CAAC;SAC5C,MAAM,CAAC,KAAK,EAAE,QAAgB,EAAE,IAAI,EAAE,EAAE;QACvC,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACzC,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAE7C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,EAAE;gBACrD,UAAU,EAAE,WAAW;aACxB,CAAC,CAAC;YAEH,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,UAAU,CAAC,MAAM,CAAC,CAAC;gBACnB,OAAO;YACT,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;YACzB,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,OAAO,CAAC,KAAK,CAAC,SAAS,KAAK,aAAa,CAAC,CAAC;gBAC3C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YAED,MAAM,CAAC,GAAG,IAAI,CAAC,aAAmD,CAAC;YAEnE,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;YAChD,IAAI,IAAI,CAAC,WAAW;gBAAE,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;YAC3D,IAAI,CAAC,EAAE,CAAC;gBACN,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,CAAC,CAAC,cAAc,IAAI,CAAC,CAAC,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC,CAAC,cAAc,IAAI,CAAC,CAAC,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,cAAc,EAAE,QAAQ,CAClK,CAAC;YACJ,CAAC;YACD,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBACnB,OAAO,CAAC,GAAG,CACT,YAAY,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,kBAAkB,EAAE,EAAE,CAC5D,CAAC;YACJ,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"}

package/dist/commands/usersearch.d.ts

@@ -0,0 +1,8 @@
+/**
+ * User search command.
+ *
+ * Usage:
+ *   xc usersearch <query>  — search for users by keyword
+ */
+import { Command } from "commander";
+export declare function registerUserSearchCommand(program: Command): void;

package/dist/commands/usersearch.js

@@ -0,0 +1,48 @@
+/**
+ * User search command.
+ *
+ * Usage:
+ *   xc usersearch <query>  — search for users by keyword
+ */
+import { getClient } from "../lib/api.js";
+import { outputJson } from "../lib/cost.js";
+import { formatUserLine } from "../lib/format.js";
+export function registerUserSearchCommand(program) {
+    program
+        .command("usersearch <query>")
+        .description("Search for users by keyword")
+        .option("-n, --limit <n>", "Max results (1-100)", "20")
+        .option("--json", "Output raw JSON")
+        .option("--account <name>", "Account to use")
+        .action(async (query, opts) => {
+        try {
+            const client = await getClient(opts.account);
+            const result = await client.users.search(query, {
+                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 users found for "${query}".`);
+                return;
+            }
+            console.log(`Users matching "${query}":\n`);
+            for (const user of users) {
+                console.log(formatUserLine(user));
+                if (user.description) {
+                    console.log(`    ${user.description.replace(/\n/g, " ").slice(0, 100)}`);
+                }
+            }
+            console.log(`\n— ${users.length} shown`);
+        }
+        catch (err) {
+            console.error(`Error: ${err instanceof Error ? err.message : err}`);
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=usersearch.js.map

package/dist/commands/usersearch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usersearch.js","sourceRoot":"","sources":["../../src/commands/usersearch.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAmB,MAAM,kBAAkB,CAAC;AAEnE,MAAM,UAAU,yBAAyB,CAAC,OAAgB;IACxD,OAAO;SACJ,OAAO,CAAC,oBAAoB,CAAC;SAC7B,WAAW,CAAC,6BAA6B,CAAC;SAC1C,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,KAAa,EAAE,IAAI,EAAE,EAAE;QACpC,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,KAAK,EAAE;gBAC9C,UAAU,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,gBAAgB,EAAE,aAAa,CAAC;gBACjE,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,uBAAuB,KAAK,IAAI,CAAC,CAAC;gBAC9C,OAAO;YACT,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,mBAAmB,KAAK,MAAM,CAAC,CAAC;YAC5C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;gBAClC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;oBACrB,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;gBAC3E,CAAC;YACH,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;AACP,CAAC"}

package/dist/commands/whoami.d.ts

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

package/dist/commands/whoami.js

@@ -0,0 +1,54 @@
+import { getClient } from "../lib/api.js";
+import { outputJson } from "../lib/cost.js";
+const USER_FIELDS = [
+    "created_at",
+    "description",
+    "public_metrics",
+    "verified",
+    "location",
+    "url",
+    "profile_image_url",
+];
+export function registerWhoamiCommand(program) {
+    program
+        .command("whoami")
+        .description("Show the authenticated user")
+        .option("--account <name>", "Account to check")
+        .option("--json", "Output raw JSON")
+        .action(async (opts) => {
+        try {
+            const client = await getClient(opts.account);
+            const result = await client.users.getMe({ userFields: USER_FIELDS });
+            if (opts.json) {
+                outputJson(result);
+                return;
+            }
+            const data = result.data;
+            if (!data) {
+                console.error("Could not fetch user info.");
+                process.exit(1);
+            }
+            const m = data.publicMetrics;
+            console.log(`@${data.username} (${data.name})`);
+            if (data.description)
+                console.log(`  ${data.description}`);
+            if (data.location)
+                console.log(`  📍 ${data.location}`);
+            if (data.url)
+                console.log(`  🔗 ${data.url}`);
+            if (data.verified)
+                console.log(`  ✓ Verified`);
+            if (m) {
+                console.log(`  ${(m.followersCount ?? 0).toLocaleString()} followers · ${(m.followingCount ?? 0).toLocaleString()} following · ${(m.tweetCount ?? 0).toLocaleString()} posts`);
+            }
+            if (data.createdAt) {
+                console.log(`  Joined ${new Date(data.createdAt).toLocaleDateString()}`);
+            }
+        }
+        catch (err) {
+            console.error(`Error: ${err instanceof Error ? err.message : err}`);
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=whoami.js.map