x-reader 0.1.0

package/dist/utils/auth.js

@@ -0,0 +1,128 @@
+/**
+ * Authentication utilities — resolve cookies from Chrome, env, or config file.
+ */
+import { readFile } from 'fs/promises';
+import { existsSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+const CONFIG_DIR = join(homedir(), '.config', 'x-reader');
+const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
+/**
+ * Try to get cookies from Chrome's cookie store on macOS.
+ * This uses `security` CLI to access the keychain and `sqlite3` to read the cookie DB.
+ */
+async function getCookiesFromChrome() {
+    if (process.platform !== 'darwin')
+        return null;
+    try {
+        // Chrome cookie DB path on macOS
+        const cookieDb = join(homedir(), 'Library/Application Support/Google/Chrome/Default/Cookies');
+        if (!existsSync(cookieDb))
+            return null;
+        // Note: Chrome encrypts cookies on macOS. We'd need the encryption key from Keychain.
+        // For now, this is a placeholder — users should use env vars or config file.
+        // TODO: Implement Chrome cookie decryption if needed.
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Read cookies from config file (~/.config/x-reader/config.json).
+ */
+async function getCookiesFromConfig() {
+    try {
+        if (!existsSync(CONFIG_FILE))
+            return null;
+        const raw = await readFile(CONFIG_FILE, 'utf8');
+        const config = JSON.parse(raw);
+        if (config.auth_token && config.ct0) {
+            return {
+                authToken: config.auth_token,
+                ct0: config.ct0,
+                source: 'config file',
+            };
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Read cookies from Bird CLI's config (for seamless migration).
+ */
+async function getCookiesFromBirdConfig() {
+    try {
+        const birdConfig = join(homedir(), '.config', 'bird', 'config.json');
+        if (!existsSync(birdConfig))
+            return null;
+        const raw = await readFile(birdConfig, 'utf8');
+        const config = JSON.parse(raw);
+        if (config.auth_token && config.ct0) {
+            return {
+                authToken: config.auth_token,
+                ct0: config.ct0,
+                source: 'bird config',
+            };
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Read cookies from environment variables.
+ */
+function getCookiesFromEnv() {
+    const authToken = process.env.AUTH_TOKEN || process.env.TWITTER_AUTH_TOKEN;
+    const ct0 = process.env.CT0 || process.env.TWITTER_CT0;
+    if (authToken && ct0) {
+        return { authToken, ct0, source: 'environment variables' };
+    }
+    return null;
+}
+/**
+ * Resolve cookies from all sources. Priority:
+ * 1. CLI flags (--auth-token, --ct0)
+ * 2. Environment variables (AUTH_TOKEN, CT0)
+ * 3. x-reader config file
+ * 4. Bird CLI config file (migration)
+ * 5. Chrome cookies (macOS only)
+ */
+export async function resolveCookies(flags = {}) {
+    const warnings = [];
+    // 1. CLI flags
+    if (flags.authToken && flags.ct0) {
+        return {
+            cookies: { authToken: flags.authToken, ct0: flags.ct0, source: 'CLI flags' },
+            warnings,
+        };
+    }
+    // 2. Environment
+    const envCookies = getCookiesFromEnv();
+    if (envCookies)
+        return { cookies: envCookies, warnings };
+    // 3. x-reader config
+    const configCookies = await getCookiesFromConfig();
+    if (configCookies)
+        return { cookies: configCookies, warnings };
+    // 4. Bird config (migration)
+    const birdCookies = await getCookiesFromBirdConfig();
+    if (birdCookies) {
+        warnings.push('Using Bird CLI config. Run `x-reader setup` to create x-reader config.');
+        return { cookies: birdCookies, warnings };
+    }
+    // 5. Chrome (placeholder)
+    const chromeCookies = await getCookiesFromChrome();
+    if (chromeCookies)
+        return { cookies: chromeCookies, warnings };
+    // Nothing found
+    return {
+        cookies: { authToken: '', ct0: '', source: '' },
+        warnings: ['No credentials found. Set AUTH_TOKEN and CT0 env vars, or run `x-reader setup`.'],
+    };
+}
+//# sourceMappingURL=auth.js.map

package/dist/utils/auth.js.map

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

package/dist/utils/format.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Output formatting — JSON and human-readable text.
+ */
+import type { Tweet } from '../api/types.js';
+/** Format a tweet for human-readable output */
+export declare function formatTweet(tweet: Tweet, separator?: boolean): string;
+/** Format tweets array for output */
+export declare function formatTweets(tweets: Tweet[], options?: {
+    json?: boolean;
+    emptyMessage?: string;
+}): string;
+/** Extract tweet ID from URL or return as-is */
+export declare function extractTweetId(input: string): string;
+/** Normalize username — strip @ if present */
+export declare function normalizeUsername(input: string): string;

package/dist/utils/format.js

@@ -0,0 +1,62 @@
+/**
+ * Output formatting — JSON and human-readable text.
+ */
+/** Format a tweet for human-readable output */
+export function formatTweet(tweet, separator = true) {
+    const lines = [];
+    const header = `@${tweet.author.username} (${tweet.author.name})`;
+    const date = tweet.createdAt ? `  ${tweet.createdAt}` : '';
+    lines.push(`${header}${date}`);
+    lines.push(tweet.text);
+    const stats = [];
+    if (tweet.likeCount !== undefined)
+        stats.push(`❤️ ${tweet.likeCount}`);
+    if (tweet.retweetCount !== undefined)
+        stats.push(`🔁 ${tweet.retweetCount}`);
+    if (tweet.replyCount !== undefined)
+        stats.push(`💬 ${tweet.replyCount}`);
+    if (stats.length > 0)
+        lines.push(stats.join('  '));
+    lines.push(`🔗 https://x.com/i/status/${tweet.id}`);
+    if (tweet.quotedTweet) {
+        lines.push(`  ↪ Quoting @${tweet.quotedTweet.author.username}: ${tweet.quotedTweet.text.slice(0, 100)}…`);
+    }
+    if (tweet.media?.length) {
+        for (const m of tweet.media) {
+            if (m.videoUrl) {
+                lines.push(`  🎬 ${m.videoUrl}`);
+            }
+            else {
+                lines.push(`  🖼️ ${m.url}`);
+            }
+        }
+    }
+    if (separator)
+        lines.push('─'.repeat(50));
+    return lines.join('\n');
+}
+/** Format tweets array for output */
+export function formatTweets(tweets, options = {}) {
+    if (options.json) {
+        return JSON.stringify(tweets, null, 2);
+    }
+    if (tweets.length === 0) {
+        return options.emptyMessage ?? 'No tweets found.';
+    }
+    return tweets.map((t) => formatTweet(t)).join('\n');
+}
+/** Extract tweet ID from URL or return as-is */
+export function extractTweetId(input) {
+    const urlMatch = input.match(/(?:twitter\.com|x\.com)\/\w+\/status\/(\d+)/);
+    if (urlMatch)
+        return urlMatch[1];
+    if (/^\d+$/.test(input.trim()))
+        return input.trim();
+    throw new Error(`Invalid tweet ID or URL: ${input}`);
+}
+/** Normalize username — strip @ if present */
+export function normalizeUsername(input) {
+    const trimmed = input.trim();
+    return trimmed.startsWith('@') ? trimmed.slice(1) : trimmed;
+}
+//# sourceMappingURL=format.js.map

package/dist/utils/format.js.map

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

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "x-reader",
+  "version": "0.1.0",
+  "description": "Read-only Twitter/X CLI. Search tweets, read timelines, bookmarks, and replies from the terminal.",
+  "type": "module",
+  "bin": {
+    "x-reader": "./dist/cli/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/cli/index.js",
+    "test": "node --test tests/*.test.js",
+    "lint": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "twitter",
+    "x",
+    "cli",
+    "tweet",
+    "reader",
+    "twitter-api",
+    "twitter-cli",
+    "x-api",
+    "tweet-reader",
+    "twitter-scraper",
+    "bookmarks",
+    "timeline",
+    "search-tweets",
+    "read-only",
+    "terminal",
+    "command-line",
+    "social-media"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/DjinnFoundry/x-reader.git"
+  },
+  "homepage": "https://github.com/DjinnFoundry/x-reader#readme",
+  "bugs": {
+    "url": "https://github.com/DjinnFoundry/x-reader/issues"
+  },
+  "author": "DjinnFoundry",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "commander": "^12.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  }
+}