@dotta/xc 0.1.0

package/dist/lib/cost.js.map

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

package/dist/lib/format.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Shared formatting utilities for tweet/user display.
+ * Field names use SDK camelCase conventions (authorId, publicMetrics, etc.).
+ */
+import type { Schemas } from "@xdevplatform/xdk";
+type Tweet = Schemas.Tweet;
+type User = Schemas.User;
+/** Build a lookup map from an API includes.users array. */
+export declare function buildUserMap(users?: User[]): Map<string, User>;
+/** Format a single tweet for human-readable terminal output. */
+export declare function formatTweet(tweet: Tweet, usersById?: Map<string, User>): string;
+/** Format a list of tweets with blank lines between them. */
+export declare function formatTweetList(tweets: Tweet[], usersById?: Map<string, User>): string;
+/** Shape of a user result for compact display. */
+export interface UserResult {
+    id?: string;
+    username?: string;
+    name?: string;
+    description?: string;
+    publicMetrics?: Record<string, number>;
+}
+/** Format a compact user line for user lists. */
+export declare function formatUserLine(user: UserResult): string;
+export {};

package/dist/lib/format.js

@@ -0,0 +1,72 @@
+/**
+ * Shared formatting utilities for tweet/user display.
+ * Field names use SDK camelCase conventions (authorId, publicMetrics, etc.).
+ */
+/** Build a lookup map from an API includes.users array. */
+export function buildUserMap(users) {
+    const map = new Map();
+    if (users) {
+        for (const user of users) {
+            if (user.id)
+                map.set(user.id, user);
+        }
+    }
+    return map;
+}
+/** Format a single tweet for human-readable terminal output. */
+export function formatTweet(tweet, usersById) {
+    const lines = [];
+    // Author line
+    const author = tweet.authorId
+        ? usersById?.get(tweet.authorId)
+        : undefined;
+    if (author) {
+        lines.push(`@${author.username} (${author.name})`);
+    }
+    // Tweet text (indent continuation lines)
+    const text = tweet.text ?? "";
+    lines.push(`  ${text.replace(/\n/g, "\n  ")}`);
+    // Engagement metrics (publicMetrics is Record<string, any>)
+    const m = tweet.publicMetrics;
+    if (m) {
+        const parts = [];
+        if (m.likeCount)
+            parts.push(`${m.likeCount} likes`);
+        if (m.retweetCount)
+            parts.push(`${m.retweetCount} RTs`);
+        if (m.replyCount)
+            parts.push(`${m.replyCount} replies`);
+        if (m.quoteCount)
+            parts.push(`${m.quoteCount} quotes`);
+        if (parts.length > 0) {
+            lines.push(`  ${parts.join(" · ")}`);
+        }
+    }
+    // Timestamp and post ID
+    const meta = [];
+    if (tweet.createdAt) {
+        meta.push(new Date(tweet.createdAt).toLocaleString());
+    }
+    if (tweet.id) {
+        meta.push(`id:${tweet.id}`);
+    }
+    if (meta.length > 0) {
+        lines.push(`  ${meta.join(" · ")}`);
+    }
+    return lines.join("\n");
+}
+/** Format a list of tweets with blank lines between them. */
+export function formatTweetList(tweets, usersById) {
+    return tweets.map((t) => formatTweet(t, usersById)).join("\n\n");
+}
+/** Format a compact user line for user lists. */
+export function formatUserLine(user) {
+    const parts = [`@${user.username}`];
+    if (user.name)
+        parts[0] += ` (${user.name})`;
+    if (user.publicMetrics?.followersCount !== undefined) {
+        parts.push(`${user.publicMetrics.followersCount.toLocaleString()} followers`);
+    }
+    return `  ${parts.join(" · ")}`;
+}
+//# sourceMappingURL=format.js.map

package/dist/lib/format.js.map

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

package/dist/lib/oauth.d.ts

@@ -0,0 +1,32 @@
+/**
+ * OAuth 2.0 PKCE flow using the XDK SDK.
+ * Handles authorization, token exchange, and token refresh.
+ */
+import { type OAuth2Token } from "@xdevplatform/xdk";
+export type { OAuth2Token };
+export interface OAuthFlowResult {
+    accessToken: string;
+    refreshToken?: string;
+    expiresAt: number;
+    scopes: string;
+}
+/**
+ * Run the OAuth 2.0 PKCE flow:
+ * 1. Start a local HTTP server to receive the callback
+ * 2. Open the browser to X's authorize URL
+ * 3. Exchange the authorization code for tokens via the SDK
+ */
+export declare function runOAuthFlow(params: {
+    clientId: string;
+    clientSecret?: string;
+    port?: number;
+    onOpenUrl: (url: string) => void | Promise<void>;
+}): Promise<OAuthFlowResult>;
+/**
+ * Refresh an expired access token using the SDK OAuth2 handler.
+ */
+export declare function refreshAccessToken(params: {
+    clientId: string;
+    clientSecret?: string;
+    refreshToken: string;
+}): Promise<OAuthFlowResult>;

package/dist/lib/oauth.js

@@ -0,0 +1,132 @@
+/**
+ * OAuth 2.0 PKCE flow using the XDK SDK.
+ * Handles authorization, token exchange, and token refresh.
+ */
+import crypto from "node:crypto";
+import http from "node:http";
+import { URL } from "node:url";
+import { OAuth2, generateCodeVerifier, } from "@xdevplatform/xdk";
+const SCOPES = [
+    "tweet.read",
+    "tweet.write",
+    "tweet.moderate.write",
+    "users.read",
+    "follows.read",
+    "follows.write",
+    "like.read",
+    "like.write",
+    "list.read",
+    "list.write",
+    "bookmark.read",
+    "bookmark.write",
+    "block.read",
+    "block.write",
+    "mute.read",
+    "mute.write",
+    "dm.read",
+    "dm.write",
+    "media.write",
+    "offline.access",
+];
+/**
+ * Run the OAuth 2.0 PKCE flow:
+ * 1. Start a local HTTP server to receive the callback
+ * 2. Open the browser to X's authorize URL
+ * 3. Exchange the authorization code for tokens via the SDK
+ */
+export async function runOAuthFlow(params) {
+    const { clientId, clientSecret, port = 3391 } = params;
+    const redirectUri = `http://127.0.0.1:${port}/callback`;
+    // Configure SDK OAuth2 handler
+    const oauth2 = new OAuth2({
+        clientId,
+        ...(clientSecret ? { clientSecret } : {}),
+        redirectUri,
+        scope: SCOPES,
+    });
+    // Generate PKCE verifier and let SDK compute the challenge
+    const codeVerifier = generateCodeVerifier();
+    await oauth2.setPkceParameters(codeVerifier);
+    // Generate random state for CSRF protection
+    const state = crypto.randomBytes(16).toString("hex");
+    const authUrl = await oauth2.getAuthorizationUrl(state);
+    // Wait for the OAuth callback on our local server
+    const code = await new Promise((resolve, reject) => {
+        const server = http.createServer((req, res) => {
+            const url = new URL(req.url ?? "/", `http://127.0.0.1:${port}`);
+            if (url.pathname !== "/callback") {
+                res.writeHead(404);
+                res.end("Not found");
+                return;
+            }
+            const receivedState = url.searchParams.get("state");
+            const receivedCode = url.searchParams.get("code");
+            const error = url.searchParams.get("error");
+            if (error) {
+                res.writeHead(200, { "Content-Type": "text/html" });
+                res.end("<html><body><h1>Authorization failed</h1><p>You can close this window.</p></body></html>");
+                server.close();
+                reject(new Error(`OAuth error: ${error}`));
+                return;
+            }
+            if (receivedState !== state) {
+                res.writeHead(400, { "Content-Type": "text/html" });
+                res.end("<html><body><h1>State mismatch</h1></body></html>");
+                server.close();
+                reject(new Error("OAuth state mismatch"));
+                return;
+            }
+            if (!receivedCode) {
+                res.writeHead(400, { "Content-Type": "text/html" });
+                res.end("<html><body><h1>No code received</h1></body></html>");
+                server.close();
+                reject(new Error("No authorization code received"));
+                return;
+            }
+            res.writeHead(200, { "Content-Type": "text/html" });
+            res.end(`<html><body style="font-family: system-ui; display: flex; justify-content: center; align-items: center; height: 100vh; margin: 0; background: #15202b; color: #e7e9ea;">
+          <div style="text-align: center;">
+            <h1>✓ Authorized</h1>
+            <p>You can close this window and return to your terminal.</p>
+          </div>
+        </body></html>`);
+            server.close();
+            resolve(receivedCode);
+        });
+        server.listen(port, "127.0.0.1", () => {
+            params.onOpenUrl(authUrl);
+        });
+        // Timeout after 5 minutes
+        setTimeout(() => {
+            server.close();
+            reject(new Error("OAuth flow timed out (5 minutes)"));
+        }, 300_000);
+    });
+    // Exchange the authorization code for tokens via SDK
+    const tokens = await oauth2.exchangeCode(code, codeVerifier);
+    return {
+        accessToken: tokens.access_token,
+        refreshToken: tokens.refresh_token,
+        expiresAt: Date.now() + tokens.expires_in * 1000,
+        scopes: tokens.scope ?? "",
+    };
+}
+/**
+ * Refresh an expired access token using the SDK OAuth2 handler.
+ */
+export async function refreshAccessToken(params) {
+    const { clientId, clientSecret, refreshToken } = params;
+    const oauth2 = new OAuth2({
+        clientId,
+        ...(clientSecret ? { clientSecret } : {}),
+        redirectUri: "http://127.0.0.1:3391/callback",
+    });
+    const tokens = await oauth2.refreshToken(refreshToken);
+    return {
+        accessToken: tokens.access_token,
+        refreshToken: tokens.refresh_token ?? refreshToken,
+        expiresAt: Date.now() + tokens.expires_in * 1000,
+        scopes: tokens.scope ?? "",
+    };
+}
+//# sourceMappingURL=oauth.js.map

package/dist/lib/oauth.js.map

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

package/dist/lib/resolve.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Helpers for resolving user IDs using the SDK client.
+ * Caches authenticated user ID in config for future calls.
+ */
+/**
+ * Get the authenticated user's ID, using cached value or fetching via SDK.
+ */
+export declare function resolveAuthenticatedUserId(accountName?: string): Promise<string>;
+/**
+ * Resolve a @username to a user ID via the SDK.
+ */
+export declare function resolveUserId(username: string, accountName?: string): Promise<string>;

package/dist/lib/resolve.js

@@ -0,0 +1,48 @@
+/**
+ * Helpers for resolving user IDs using the SDK client.
+ * Caches authenticated user ID in config for future calls.
+ */
+import { getClient } from "./api.js";
+import { getAccount, loadConfig, saveConfig } from "./config.js";
+/**
+ * Get the authenticated user's ID, using cached value or fetching via SDK.
+ */
+export async function resolveAuthenticatedUserId(accountName) {
+    const account = getAccount(accountName);
+    if (account?.userId) {
+        return account.userId;
+    }
+    // Fetch via SDK and cache the result
+    const client = await getClient(accountName);
+    const result = await client.users.getMe({ userFields: ["id"] });
+    const userId = result.data?.id;
+    if (!userId) {
+        throw new Error("Could not resolve authenticated user ID");
+    }
+    // Cache for future use
+    if (account) {
+        const config = loadConfig();
+        const name = accountName ?? config.defaultAccount;
+        const stored = config.accounts[name];
+        if (stored) {
+            stored.userId = userId;
+            stored.username = result.data?.username;
+            saveConfig(config);
+        }
+    }
+    return userId;
+}
+/**
+ * Resolve a @username to a user ID via the SDK.
+ */
+export async function resolveUserId(username, accountName) {
+    const clean = username.replace(/^@/, "");
+    const client = await getClient(accountName);
+    const result = await client.users.getByUsername(clean);
+    const userId = result.data?.id;
+    if (!userId) {
+        throw new Error(`User @${clean} not found`);
+    }
+    return userId;
+}
+//# sourceMappingURL=resolve.js.map

package/dist/lib/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/lib/resolve.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEjE;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,WAAoB;IAEpB,MAAM,OAAO,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IACxC,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;QACpB,OAAO,OAAO,CAAC,MAAM,CAAC;IACxB,CAAC;IAED,qCAAqC;IACrC,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,WAAW,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChE,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;IAC/B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IAED,uBAAuB;IACvB,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,WAAW,IAAI,MAAM,CAAC,cAAc,CAAC;QAClD,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;YACvB,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC;YACxC,UAAU,CAAC,MAAM,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,QAAgB,EAChB,WAAoB;IAEpB,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,WAAW,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;IAC/B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,SAAS,KAAK,YAAY,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@dotta/xc",
+  "version": "0.1.0",
+  "description": "CLI client for the X API v2",
+  "type": "module",
+  "license": "MIT",
+  "bin": {
+    "xc": "./dist/cli.js"
+  },
+  "files": [
+    "dist/"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/cli.ts",
+    "lint": "tsc --noEmit",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "x",
+    "twitter",
+    "cli",
+    "api"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cryppadotta/xc.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "dependencies": {
+    "@xdevplatform/xdk": "^0.4.0",
+    "commander": "^13.0.0",
+    "open": "^10.0.0"
+  }
+}