x-reader 0.1.0

package/dist/api/query-ids.js

@@ -0,0 +1,201 @@
+/**
+ * Auto-discovery of Twitter/X GraphQL query IDs.
+ *
+ * X periodically rotates the query IDs embedded in their JS bundles.
+ * This module scrapes x.com pages to find the current bundle URLs,
+ * then parses those bundles to extract queryId ↔ operationName mappings.
+ *
+ * Falls back to hardcoded defaults if discovery fails.
+ */
+import { readFile, writeFile, mkdir } from 'fs/promises';
+import { homedir } from 'os';
+import { join, dirname, resolve } from 'path';
+import { DEFAULT_QUERY_IDS, DISCOVERY_PAGES, BUNDLE_URL_REGEX, QUERY_ID_PATTERNS, QUERY_ID_TTL_MS, DISCOVERY_OPERATIONS, } from './constants.js';
+const VALID_QUERY_ID = /^[a-zA-Z0-9_-]+$/;
+const FETCH_HEADERS = {
+    'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/129.0.0.0 Safari/537.36',
+    Accept: 'text/html,application/json;q=0.9,*/*;q=0.8',
+    'Accept-Language': 'en-US,en;q=0.9',
+};
+// ─── Cache file path ─────────────────────────────────────────────
+function getCachePath() {
+    const envPath = process.env.XREADER_QUERY_IDS_CACHE;
+    if (envPath?.trim())
+        return resolve(envPath.trim());
+    return join(homedir(), '.config', 'x-reader', 'query-ids-cache.json');
+}
+// ─── Load / Save cache ──────────────────────────────────────────
+function parseCache(raw) {
+    if (!raw || typeof raw !== 'object')
+        return null;
+    const obj = raw;
+    const fetchedAt = typeof obj.fetchedAt === 'string' ? obj.fetchedAt : null;
+    const ttlMs = typeof obj.ttlMs === 'number' && Number.isFinite(obj.ttlMs) ? obj.ttlMs : null;
+    const ids = obj.ids && typeof obj.ids === 'object' ? obj.ids : null;
+    const disc = obj.discovery && typeof obj.discovery === 'object'
+        ? obj.discovery
+        : null;
+    if (!fetchedAt || !ttlMs || !ids || !disc)
+        return null;
+    const pages = Array.isArray(disc.pages) ? disc.pages.filter((p) => typeof p === 'string') : null;
+    const bundles = Array.isArray(disc.bundles) ? disc.bundles.filter((b) => typeof b === 'string') : null;
+    if (!pages || !bundles)
+        return null;
+    const cleanIds = {};
+    for (const [k, v] of Object.entries(ids)) {
+        if (typeof v === 'string' && v.trim())
+            cleanIds[k] = v.trim();
+    }
+    return { fetchedAt, ttlMs, ids: cleanIds, discovery: { pages, bundles } };
+}
+async function loadCache(path) {
+    try {
+        const raw = await readFile(path, 'utf8');
+        return parseCache(JSON.parse(raw));
+    }
+    catch {
+        return null;
+    }
+}
+async function saveCache(path, cache) {
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, JSON.stringify(cache, null, 2) + '\n', 'utf8');
+}
+// ─── Bundle discovery ───────────────────────────────────────────
+async function fetchText(url) {
+    const resp = await fetch(url, { headers: FETCH_HEADERS });
+    if (!resp.ok) {
+        const body = await resp.text().catch(() => '');
+        throw new Error(`HTTP ${resp.status} for ${url}: ${body.slice(0, 120)}`);
+    }
+    return resp.text();
+}
+async function discoverBundleUrls() {
+    const found = new Set();
+    for (const page of DISCOVERY_PAGES) {
+        try {
+            const html = await fetchText(page);
+            for (const match of html.matchAll(BUNDLE_URL_REGEX)) {
+                found.add(match[0]);
+            }
+        }
+        catch {
+            // Some pages may fail — that's OK
+        }
+    }
+    const urls = [...found];
+    if (urls.length === 0) {
+        throw new Error('No client bundles discovered; x.com layout may have changed.');
+    }
+    return urls;
+}
+function extractFromBundle(js, bundleName, wantedOps, results) {
+    for (const pattern of QUERY_ID_PATTERNS) {
+        pattern.regex.lastIndex = 0;
+        let match;
+        while ((match = pattern.regex.exec(js)) !== null) {
+            const op = match[pattern.operationGroup];
+            const qid = match[pattern.queryIdGroup];
+            if (!op || !qid || !wantedOps.has(op) || !VALID_QUERY_ID.test(qid))
+                continue;
+            if (results.has(op))
+                continue;
+            results.set(op, { queryId: qid, bundle: bundleName });
+            if (results.size === wantedOps.size)
+                return;
+        }
+    }
+}
+async function scanBundles(urls, wantedOps) {
+    const results = new Map();
+    const BATCH = 6;
+    for (let i = 0; i < urls.length; i += BATCH) {
+        const batch = urls.slice(i, i + BATCH);
+        await Promise.all(batch.map(async (url) => {
+            if (results.size === wantedOps.size)
+                return;
+            const name = url.split('/').at(-1) ?? url;
+            try {
+                const js = await fetchText(url);
+                extractFromBundle(js, name, wantedOps, results);
+            }
+            catch {
+                // Individual bundle failures are OK
+            }
+        }));
+        if (results.size === wantedOps.size)
+            break;
+    }
+    return results;
+}
+// ─── Public API ─────────────────────────────────────────────────
+let memoryCache = null;
+export async function getSnapshotInfo() {
+    const cachePath = getCachePath();
+    if (!memoryCache) {
+        memoryCache = await loadCache(cachePath);
+    }
+    if (!memoryCache)
+        return null;
+    const age = Date.now() - new Date(memoryCache.fetchedAt).getTime();
+    return {
+        snapshot: memoryCache,
+        cachePath,
+        ageMs: Number.isFinite(age) ? Math.max(0, age) : Infinity,
+        isFresh: age <= (memoryCache.ttlMs || QUERY_ID_TTL_MS),
+    };
+}
+/**
+ * Get a single query ID by operation name.
+ * Returns cached value, or falls back to hardcoded default.
+ */
+export async function getQueryId(operation) {
+    const info = await getSnapshotInfo();
+    if (info?.snapshot.ids[operation]) {
+        return info.snapshot.ids[operation];
+    }
+    return DEFAULT_QUERY_IDS[operation] ?? '';
+}
+/**
+ * Refresh query IDs by scraping x.com JS bundles.
+ * Saves results to disk cache.
+ */
+export async function refreshQueryIds(options = {}) {
+    const cachePath = getCachePath();
+    // Check if cache is still fresh
+    if (!options.force) {
+        const existing = await getSnapshotInfo();
+        if (existing?.isFresh)
+            return existing;
+    }
+    const wantedOps = new Set(DISCOVERY_OPERATIONS);
+    const bundleUrls = await discoverBundleUrls();
+    const found = await scanBundles(bundleUrls, wantedOps);
+    if (found.size === 0) {
+        // Discovery failed — return existing cache if any
+        return getSnapshotInfo();
+    }
+    const ids = {};
+    for (const op of DISCOVERY_OPERATIONS) {
+        const entry = found.get(op);
+        if (entry?.queryId)
+            ids[op] = entry.queryId;
+    }
+    const cache = {
+        fetchedAt: new Date().toISOString(),
+        ttlMs: QUERY_ID_TTL_MS,
+        ids,
+        discovery: {
+            pages: [...DISCOVERY_PAGES],
+            bundles: bundleUrls.map((u) => u.split('/').at(-1) ?? u),
+        },
+    };
+    await saveCache(cachePath, cache);
+    memoryCache = cache;
+    return getSnapshotInfo();
+}
+/** Clear in-memory cache (for testing) */
+export function clearMemory() {
+    memoryCache = null;
+}
+//# sourceMappingURL=query-ids.js.map

package/dist/api/query-ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-ids.js","sourceRoot":"","sources":["../../src/api/query-ids.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC9C,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAGxB,MAAM,cAAc,GAAG,kBAAkB,CAAC;AAE1C,MAAM,aAAa,GAA2B;IAC5C,YAAY,EACV,iHAAiH;IACnH,MAAM,EAAE,4CAA4C;IACpD,iBAAiB,EAAE,gBAAgB;CACpC,CAAC;AAEF,oEAAoE;AAEpE,SAAS,YAAY;IACnB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;IACpD,IAAI,OAAO,EAAE,IAAI,EAAE;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACpD,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,sBAAsB,CAAC,CAAC;AACxE,CAAC;AAED,mEAAmE;AAEnE,SAAS,UAAU,CAAC,GAAY;IAC9B,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACjD,MAAM,GAAG,GAAG,GAA8B,CAAC;IAE3C,MAAM,SAAS,GAAG,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3E,MAAM,KAAK,GAAG,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7F,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,IAAI,OAAO,GAAG,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAE,GAAG,CAAC,GAA+B,CAAC,CAAC,CAAC,IAAI,CAAC;IACjG,MAAM,IAAI,GAAG,GAAG,CAAC,SAAS,IAAI,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ;QAC7D,CAAC,CAAE,GAAG,CAAC,SAAqC;QAC5C,CAAC,CAAC,IAAI,CAAC;IAET,IAAI,CAAC,SAAS,IAAI,CAAC,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAEvD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9G,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACpH,IAAI,CAAC,KAAK,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAEpC,MAAM,QAAQ,GAA2B,EAAE,CAAC;IAC5C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACzC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE;YAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAChE,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC;AAC5E,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,IAAY;IACnC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACzC,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,IAAY,EAAE,KAAmB;IACxD,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;AACvE,CAAC;AAED,mEAAmE;AAEnE,KAAK,UAAU,SAAS,CAAC,GAAW;IAClC,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC;IAC1D,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACb,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,CAAC,MAAM,QAAQ,GAAG,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;AACrB,CAAC;AAED,KAAK,UAAU,kBAAkB;IAC/B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC;QACnC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;YACnC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;gBACpD,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,kCAAkC;QACpC,CAAC;IACH,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IACxB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,iBAAiB,CACxB,EAAU,EACV,UAAkB,EAClB,SAAsB,EACtB,OAAyD;IAEzD,KAAK,MAAM,OAAO,IAAI,iBAAiB,EAAE,CAAC;QACxC,OAAO,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC;QAC5B,IAAI,KAA6B,CAAC;QAClC,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACjD,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;YACzC,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;YACxC,IAAI,CAAC,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC;gBAAE,SAAS;YAC7E,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAE,SAAS;YAC9B,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;YACtD,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI;gBAAE,OAAO;QAC9C,CAAC;IACH,CAAC;AACH,CAAC;AAED,KAAK,UAAU,WAAW,CACxB,IAAc,EACd,SAAsB;IAEtB,MAAM,OAAO,GAAG,IAAI,GAAG,EAA+C,CAAC;IACvE,MAAM,KAAK,GAAG,CAAC,CAAC;IAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC;QAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC;QACvC,MAAM,OAAO,CAAC,GAAG,CACf,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YACtB,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI;gBAAE,OAAO;YAC5C,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;YAC1C,IAAI,CAAC;gBACH,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;gBAChC,iBAAiB,CAAC,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;YAClD,CAAC;YAAC,MAAM,CAAC;gBACP,oCAAoC;YACtC,CAAC;QACH,CAAC,CAAC,CACH,CAAC;QACF,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI;YAAE,MAAM;IAC7C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,mEAAmE;AAEnE,IAAI,WAAW,GAAwB,IAAI,CAAC;AAS5C,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IACjC,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,WAAW,GAAG,MAAM,SAAS,CAAC,SAAS,CAAC,CAAC;IAC3C,CAAC;IACD,IAAI,CAAC,WAAW;QAAE,OAAO,IAAI,CAAC;IAE9B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;IACnE,OAAO;QACL,QAAQ,EAAE,WAAW;QACrB,SAAS;QACT,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ;QACzD,OAAO,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,IAAI,eAAe,CAAC;KACvD,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,SAAiB;IAChD,MAAM,IAAI,GAAG,MAAM,eAAe,EAAE,CAAC;IACrC,IAAI,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,iBAAiB,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;AAC5C,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,UAA+B,EAAE;IAEjC,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IAEjC,gCAAgC;IAChC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACnB,MAAM,QAAQ,GAAG,MAAM,eAAe,EAAE,CAAC;QACzC,IAAI,QAAQ,EAAE,OAAO;YAAE,OAAO,QAAQ,CAAC;IACzC,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,oBAAoB,CAAC,CAAC;IAChD,MAAM,UAAU,GAAG,MAAM,kBAAkB,EAAE,CAAC;IAC9C,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IAEvD,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACrB,kDAAkD;QAClD,OAAO,eAAe,EAAE,CAAC;IAC3B,CAAC;IAED,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,EAAE,IAAI,oBAAoB,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC5B,IAAI,KAAK,EAAE,OAAO;YAAE,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC;IAC9C,CAAC;IAED,MAAM,KAAK,GAAiB;QAC1B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,KAAK,EAAE,eAAe;QACtB,GAAG;QACH,SAAS,EAAE;YACT,KAAK,EAAE,CAAC,GAAG,eAAe,CAAC;YAC3B,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;SACzD;KACF,CAAC;IAEF,MAAM,SAAS,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAClC,WAAW,GAAG,KAAK,CAAC;IACpB,OAAO,eAAe,EAAE,CAAC;AAC3B,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,WAAW;IACzB,WAAW,GAAG,IAAI,CAAC;AACrB,CAAC"}

package/dist/api/types.d.ts

@@ -0,0 +1,91 @@
+/** Core types for x-reader */
+export interface Tweet {
+    id: string;
+    text: string;
+    createdAt?: string;
+    replyCount?: number;
+    retweetCount?: number;
+    likeCount?: number;
+    conversationId?: string;
+    inReplyToStatusId?: string;
+    author: {
+        username: string;
+        name: string;
+    };
+    authorId?: string;
+    quotedTweet?: Tweet;
+    media?: TweetMedia[];
+    article?: {
+        title: string;
+        previewText?: string;
+    };
+    _raw?: unknown;
+}
+export interface TweetMedia {
+    type: string;
+    url: string;
+    width?: number;
+    height?: number;
+    previewUrl?: string;
+    videoUrl?: string;
+    durationMs?: number;
+}
+export interface User {
+    id: string;
+    username: string;
+    name: string;
+    description?: string;
+    followersCount?: number;
+    followingCount?: number;
+    isBlueVerified?: boolean;
+    profileImageUrl?: string;
+    createdAt?: string;
+}
+export interface Cookies {
+    authToken: string;
+    ct0: string;
+    cookieHeader?: string;
+    source?: string;
+}
+export interface ClientOptions {
+    cookies: Cookies;
+    timeoutMs?: number;
+    quoteDepth?: number;
+}
+export interface ApiResult<T> {
+    success: boolean;
+    error?: string;
+    tweets?: Tweet[];
+    tweet?: Tweet;
+    users?: User[];
+    user?: User;
+    nextCursor?: string;
+    items?: T[];
+}
+export interface TweetResult {
+    success: boolean;
+    error?: string;
+    tweet?: Tweet;
+}
+export interface TweetsResult {
+    success: boolean;
+    error?: string;
+    tweets?: Tweet[];
+    nextCursor?: string;
+}
+export interface UserResult {
+    success: boolean;
+    error?: string;
+    userId?: string;
+    username?: string;
+    name?: string;
+}
+export interface QueryIdCache {
+    fetchedAt: string;
+    ttlMs: number;
+    ids: Record<string, string>;
+    discovery: {
+        pages: string[];
+        bundles: string[];
+    };
+}

package/dist/api/types.js

@@ -0,0 +1,3 @@
+/** Core types for x-reader */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/api/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/api/types.ts"],"names":[],"mappings":"AAAA,8BAA8B"}

package/dist/cli/index.d.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+/**
+ * x-reader CLI — Read-only Twitter/X client
+ *
+ * Commands:
+ *   search <query>              Search tweets
+ *   user-tweets <handle>        Get tweets from a user
+ *   read <tweet-id-or-url>      Read a single tweet
+ *   replies <tweet-id-or-url>   Get replies to a tweet
+ *   bookmarks                   Get your bookmarks
+ *   user-lookup <handle>        Look up user info
+ *   query-ids                   Show/refresh cached query IDs
+ *   setup                       Configure authentication
+ */
+export {};

package/dist/cli/index.js

@@ -0,0 +1,258 @@
+#!/usr/bin/env node
+/**
+ * x-reader CLI — Read-only Twitter/X client
+ *
+ * Commands:
+ *   search <query>              Search tweets
+ *   user-tweets <handle>        Get tweets from a user
+ *   read <tweet-id-or-url>      Read a single tweet
+ *   replies <tweet-id-or-url>   Get replies to a tweet
+ *   bookmarks                   Get your bookmarks
+ *   user-lookup <handle>        Look up user info
+ *   query-ids                   Show/refresh cached query IDs
+ *   setup                       Configure authentication
+ */
+import { Command } from 'commander';
+import { XReaderClient } from '../api/client.js';
+import { resolveCookies } from '../utils/auth.js';
+import { formatTweets, formatTweet, extractTweetId, normalizeUsername } from '../utils/format.js';
+import { getSnapshotInfo, refreshQueryIds } from '../api/query-ids.js';
+import { writeFile, mkdir } from 'fs/promises';
+import { homedir } from 'os';
+import { join } from 'path';
+import { createInterface } from 'readline';
+const VERSION = '0.1.0';
+const program = new Command();
+program
+    .name('x-reader')
+    .description('Read-only Twitter/X CLI — personal tool for reading tweets')
+    .version(VERSION)
+    .option('--auth-token <token>', 'Twitter auth_token cookie')
+    .option('--ct0 <token>', 'Twitter ct0 cookie')
+    .option('--timeout <ms>', 'Request timeout in milliseconds');
+// ─── Helper to create client ──────────────────────────────────
+async function createClient(opts) {
+    const { cookies, warnings } = await resolveCookies({
+        authToken: opts.authToken,
+        ct0: opts.ct0,
+    });
+    for (const w of warnings) {
+        console.error(`⚠️  ${w}`);
+    }
+    if (!cookies.authToken || !cookies.ct0) {
+        console.error('❌ Missing credentials. Run `x-reader setup` or set AUTH_TOKEN and CT0 env vars.');
+        process.exit(1);
+    }
+    return new XReaderClient({
+        cookies,
+        timeoutMs: opts.timeout ? parseInt(opts.timeout, 10) : undefined,
+    });
+}
+// ─── search ─────────────────────────────────────────────────────
+program
+    .command('search <query>')
+    .description('Search for tweets')
+    .option('-n, --count <number>', 'Number of tweets', '10')
+    .option('--format <type>', 'Output format: json or text', 'text')
+    .action(async (query, cmdOpts) => {
+    const opts = program.opts();
+    const client = await createClient(opts);
+    const count = parseInt(cmdOpts.count, 10);
+    const result = await client.searchAll(query, count);
+    if (!result.success) {
+        console.error(`❌ Search failed: ${result.error}`);
+        process.exit(1);
+    }
+    const isJson = cmdOpts.format === 'json';
+    console.log(formatTweets(result.tweets ?? [], { json: isJson }));
+});
+// ─── user-tweets ────────────────────────────────────────────────
+program
+    .command('user-tweets <handle>')
+    .description('Get tweets from a user')
+    .option('-n, --count <number>', 'Number of tweets', '20')
+    .option('--format <type>', 'Output format: json or text', 'text')
+    .action(async (handle, cmdOpts) => {
+    const opts = program.opts();
+    const client = await createClient(opts);
+    const username = normalizeUsername(handle);
+    const count = parseInt(cmdOpts.count, 10);
+    // Look up user ID first
+    console.error(`ℹ️  Looking up @${username}...`);
+    const user = await client.getUserByUsername(username);
+    if (!user.success || !user.userId) {
+        console.error(`❌ ${user.error || `User @${username} not found`}`);
+        process.exit(1);
+    }
+    console.error(`ℹ️  Fetching tweets from ${user.name} (@${user.username})...`);
+    const result = await client.getUserTweetsAll(user.userId, count);
+    if (!result.success) {
+        console.error(`❌ Failed: ${result.error}`);
+        process.exit(1);
+    }
+    const isJson = cmdOpts.format === 'json';
+    console.log(formatTweets(result.tweets ?? [], { json: isJson, emptyMessage: `No tweets found for @${username}.` }));
+});
+// ─── read ───────────────────────────────────────────────────────
+program
+    .command('read <tweet-id-or-url>')
+    .description('Read a single tweet')
+    .option('--format <type>', 'Output format: json or text', 'text')
+    .action(async (input, cmdOpts) => {
+    const opts = program.opts();
+    const client = await createClient(opts);
+    let tweetId;
+    try {
+        tweetId = extractTweetId(input);
+    }
+    catch (e) {
+        console.error(`❌ ${e instanceof Error ? e.message : e}`);
+        process.exit(1);
+    }
+    const result = await client.getTweet(tweetId);
+    if (!result.success || !result.tweet) {
+        console.error(`❌ ${result.error || 'Tweet not found'}`);
+        process.exit(1);
+    }
+    if (cmdOpts.format === 'json') {
+        console.log(JSON.stringify(result.tweet, null, 2));
+    }
+    else {
+        console.log(formatTweet(result.tweet, false));
+    }
+});
+// ─── replies ────────────────────────────────────────────────────
+program
+    .command('replies <tweet-id-or-url>')
+    .description('Get replies to a tweet')
+    .option('--format <type>', 'Output format: json or text', 'text')
+    .action(async (input, cmdOpts) => {
+    const opts = program.opts();
+    const client = await createClient(opts);
+    let tweetId;
+    try {
+        tweetId = extractTweetId(input);
+    }
+    catch (e) {
+        console.error(`❌ ${e instanceof Error ? e.message : e}`);
+        process.exit(1);
+    }
+    const result = await client.getReplies(tweetId);
+    if (!result.success) {
+        console.error(`❌ ${result.error || 'Failed to fetch replies'}`);
+        process.exit(1);
+    }
+    const isJson = cmdOpts.format === 'json';
+    console.log(formatTweets(result.tweets ?? [], { json: isJson, emptyMessage: 'No replies found.' }));
+});
+// ─── bookmarks ──────────────────────────────────────────────────
+program
+    .command('bookmarks')
+    .description('Get your bookmarked tweets')
+    .option('-n, --count <number>', 'Number of bookmarks', '20')
+    .option('--all', 'Fetch all bookmarks')
+    .option('--format <type>', 'Output format: json or text', 'text')
+    .action(async (cmdOpts) => {
+    const opts = program.opts();
+    const client = await createClient(opts);
+    const count = cmdOpts.all ? Infinity : parseInt(cmdOpts.count, 10);
+    const result = await client.getBookmarksAll(count);
+    if (!result.success) {
+        console.error(`❌ ${result.error || 'Failed to fetch bookmarks'}`);
+        process.exit(1);
+    }
+    const isJson = cmdOpts.format === 'json';
+    console.log(formatTweets(result.tweets ?? [], { json: isJson, emptyMessage: 'No bookmarks found.' }));
+});
+// ─── user-lookup ────────────────────────────────────────────────
+program
+    .command('user-lookup <handle>')
+    .description('Look up user information')
+    .option('--format <type>', 'Output format: json or text', 'text')
+    .action(async (handle, cmdOpts) => {
+    const opts = program.opts();
+    const client = await createClient(opts);
+    const username = normalizeUsername(handle);
+    const result = await client.getUserByUsername(username);
+    if (!result.success) {
+        console.error(`❌ ${result.error || `User @${username} not found`}`);
+        process.exit(1);
+    }
+    if (cmdOpts.format === 'json') {
+        console.log(JSON.stringify(result, null, 2));
+    }
+    else {
+        console.log(`👤 @${result.username} (${result.name})`);
+        console.log(`🆔 User ID: ${result.userId}`);
+    }
+});
+// ─── query-ids ──────────────────────────────────────────────────
+program
+    .command('query-ids')
+    .description('Show or refresh cached query IDs')
+    .option('--refresh', 'Force refresh from x.com')
+    .option('--format <type>', 'Output format: json or text', 'text')
+    .action(async (cmdOpts) => {
+    if (cmdOpts.refresh) {
+        console.error('ℹ️  Refreshing query IDs from x.com JS bundles...');
+        await refreshQueryIds({ force: true });
+        console.error('✅ Done.');
+    }
+    const info = await getSnapshotInfo();
+    if (!info) {
+        console.error('⚠️  No cached query IDs. Run: x-reader query-ids --refresh');
+        return;
+    }
+    if (cmdOpts.format === 'json') {
+        console.log(JSON.stringify({
+            cachePath: info.cachePath,
+            fetchedAt: info.snapshot.fetchedAt,
+            isFresh: info.isFresh,
+            ageMs: info.ageMs,
+            ids: info.snapshot.ids,
+        }, null, 2));
+    }
+    else {
+        console.log(`✅ Query IDs cached`);
+        console.log(`📁 Path: ${info.cachePath}`);
+        console.log(`📅 Fetched: ${info.snapshot.fetchedAt}`);
+        console.log(`🟢 Fresh: ${info.isFresh ? 'yes' : 'no'}`);
+        console.log(`📊 Operations: ${Object.keys(info.snapshot.ids).length}`);
+        console.log('');
+        for (const [op, qid] of Object.entries(info.snapshot.ids)) {
+            console.log(`  ${op}: ${qid}`);
+        }
+    }
+});
+// ─── setup ──────────────────────────────────────────────────────
+program
+    .command('setup')
+    .description('Configure x-reader authentication')
+    .action(async () => {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    const ask = (q) => new Promise((resolve) => rl.question(q, resolve));
+    console.log('🔧 x-reader setup');
+    console.log('');
+    console.log('You need two cookies from x.com:');
+    console.log('1. Open x.com in your browser and log in');
+    console.log('2. Open DevTools → Application → Cookies → x.com');
+    console.log('3. Copy the values of auth_token and ct0');
+    console.log('');
+    const authToken = await ask('auth_token: ');
+    const ct0 = await ask('ct0: ');
+    rl.close();
+    if (!authToken.trim() || !ct0.trim()) {
+        console.error('❌ Both values are required.');
+        process.exit(1);
+    }
+    const configDir = join(homedir(), '.config', 'x-reader');
+    const configFile = join(configDir, 'config.json');
+    await mkdir(configDir, { recursive: true });
+    await writeFile(configFile, JSON.stringify({ auth_token: authToken.trim(), ct0: ct0.trim() }, null, 2) + '\n', 'utf8');
+    console.log(`✅ Config saved to ${configFile}`);
+    console.log('');
+    console.log('Test it: x-reader search "hello"');
+});
+// ─── Parse and run ──────────────────────────────────────────────
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+/** x-reader — Read-only Twitter/X API client */
+export { XReaderClient } from './api/client.js';
+export type { Tweet, TweetMedia, User, Cookies, ClientOptions, TweetResult, TweetsResult, UserResult, } from './api/types.js';
+export { resolveCookies } from './utils/auth.js';
+export { formatTweets, formatTweet, extractTweetId } from './utils/format.js';
+export { getQueryId, refreshQueryIds, getSnapshotInfo } from './api/query-ids.js';

package/dist/index.js

@@ -0,0 +1,6 @@
+/** x-reader — Read-only Twitter/X API client */
+export { XReaderClient } from './api/client.js';
+export { resolveCookies } from './utils/auth.js';
+export { formatTweets, formatTweet, extractTweetId } from './utils/format.js';
+export { getQueryId, refreshQueryIds, getSnapshotInfo } from './api/query-ids.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAEhD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAWhD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/utils/auth.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Authentication utilities — resolve cookies from Chrome, env, or config file.
+ */
+import type { Cookies } from '../api/types.js';
+interface ResolvedCookies {
+    cookies: Cookies;
+    warnings: string[];
+}
+/**
+ * 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 declare function resolveCookies(flags?: {
+    authToken?: string;
+    ct0?: string;
+}): Promise<ResolvedCookies>;
+export {};