luckiest-co 1.0.0 → 1.0.3

package/skills/luckiest-trends/scripts/lib/vendor/bird-search/bird-search.mjs

@@ -0,0 +1,147 @@
+#!/usr/bin/env node
+/**
+ * bird-search.mjs - Vendored Bird CLI search wrapper for /last30days.
+ * Subset of @steipete/bird v0.8.0 (MIT License, Peter Steinberger).
+ *
+ * Usage:
+ *   node bird-search.mjs <query> [--count N] [--json]
+ *   node bird-search.mjs --whoami
+ *   node bird-search.mjs --check
+ */
+
+import { resolveCredentials } from './lib/cookies.js';
+import { TwitterClientBase } from './lib/twitter-client-base.js';
+import { withSearch } from './lib/twitter-client-search.js';
+
+// Build a search-only client (no posting, bookmarks, etc.)
+const SearchClient = withSearch(TwitterClientBase);
+
+const args = process.argv.slice(2);
+
+function writeStdout(text) {
+  if (text) process.stdout.write(text);
+}
+
+function writeStderr(text) {
+  if (text) process.stderr.write(text);
+}
+
+async function main() {
+  // --check: verify that credentials can be resolved
+  if (args.includes('--check')) {
+    try {
+      const { cookies, warnings } = await resolveCredentials({});
+      if (cookies.authToken && cookies.ct0) {
+        writeStdout(JSON.stringify({ authenticated: true, source: cookies.source }));
+        return 0;
+      }
+      writeStdout(JSON.stringify({ authenticated: false, warnings }));
+      return 1;
+    } catch (err) {
+      writeStdout(JSON.stringify({ authenticated: false, error: err.message }));
+      return 1;
+    }
+  }
+
+  // --whoami: check auth and output source
+  if (args.includes('--whoami')) {
+    try {
+      const { cookies } = await resolveCredentials({});
+      if (cookies.authToken && cookies.ct0) {
+        writeStdout(cookies.source || 'authenticated');
+        return 0;
+      }
+      writeStderr('Not authenticated\n');
+      return 1;
+    } catch (err) {
+      writeStderr(`Auth check failed: ${err.message}\n`);
+      return 1;
+    }
+  }
+
+  // Parse search args
+  let query = null;
+  let count = 20;
+  let jsonOutput = false;
+
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--count' && args[i + 1]) {
+      count = parseInt(args[i + 1], 10);
+      i++;
+    } else if (args[i] === '-n' && args[i + 1]) {
+      count = parseInt(args[i + 1], 10);
+      i++;
+    } else if (args[i] === '--json') {
+      jsonOutput = true;
+    } else if (!args[i].startsWith('-')) {
+      query = args[i];
+    }
+  }
+
+  if (!query) {
+    writeStderr('Usage: node bird-search.mjs <query> [--count N] [--json]\n');
+    return 1;
+  }
+
+  try {
+    // Resolve credentials (env vars, then browser cookies)
+    const { cookies, warnings } = await resolveCredentials({});
+
+    if (!cookies.authToken || !cookies.ct0) {
+      const msg = warnings.length > 0 ? warnings.join('; ') : 'No Twitter credentials found';
+      if (jsonOutput) {
+        writeStdout(JSON.stringify({ error: msg, items: [] }));
+      } else {
+        writeStderr(`Error: ${msg}\n`);
+      }
+      return 1;
+    }
+
+    const client = new SearchClient({
+      cookies: {
+        authToken: cookies.authToken,
+        ct0: cookies.ct0,
+        cookieHeader: cookies.cookieHeader,
+      },
+      timeoutMs: 30000,
+    });
+
+    const result = await client.search(query, count);
+
+    if (!result.success) {
+      if (jsonOutput) {
+        writeStdout(JSON.stringify({ error: result.error, items: [] }));
+      } else {
+        writeStderr(`Search failed: ${result.error}\n`);
+      }
+      return 1;
+    }
+
+    const tweets = result.tweets || [];
+    if (jsonOutput) {
+      writeStdout(JSON.stringify(tweets));
+    } else {
+      for (const tweet of tweets) {
+        const author = tweet.author?.username || 'unknown';
+        writeStdout(`@${author}: ${tweet.text?.slice(0, 200)}\n\n`);
+      }
+    }
+
+    return 0;
+  } catch (err) {
+    if (jsonOutput) {
+      writeStdout(JSON.stringify({ error: err.message, items: [] }));
+    } else {
+      writeStderr(`Error: ${err.message}\n`);
+    }
+    return 1;
+  }
+}
+
+try {
+  const code = await main();
+  process.exitCode = Number.isInteger(code) ? code : 1;
+} catch (err) {
+  writeStderr(`Fatal error: ${err?.message || err}\n`);
+  process.exitCode = 1;
+}

package/skills/luckiest-trends/scripts/lib/vendor/bird-search/lib/cookies.js

@@ -0,0 +1,220 @@
+/**
+ * Browser cookie extraction for Twitter authentication.
+ * Delegates to @steipete/sweet-cookie for Safari/Chrome/Firefox reads.
+ */
+const TWITTER_COOKIE_NAMES = ['auth_token', 'ct0'];
+const TWITTER_URL = 'https://x.com/';
+const TWITTER_ORIGINS = ['https://x.com/', 'https://twitter.com/'];
+const DEFAULT_COOKIE_TIMEOUT_MS = 30_000;
+async function loadSweetCookie() {
+    return import('@steipete/sweet-cookie');
+}
+function normalizeValue(value) {
+    if (typeof value !== 'string') {
+        return null;
+    }
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
+function envFlagEnabled(name) {
+    const value = normalizeValue(process.env[name]);
+    if (!value) {
+        return false;
+    }
+    return ['1', 'true', 'yes', 'on'].includes(value.toLowerCase());
+}
+function cookieHeader(authToken, ct0) {
+    return `auth_token=${authToken}; ct0=${ct0}`;
+}
+function buildEmpty() {
+    return { authToken: null, ct0: null, cookieHeader: null, source: null };
+}
+function readEnvCookie(cookies, keys, field) {
+    if (cookies[field]) {
+        return;
+    }
+    for (const key of keys) {
+        const value = normalizeValue(process.env[key]);
+        if (!value) {
+            continue;
+        }
+        cookies[field] = value;
+        if (!cookies.source) {
+            cookies.source = `env ${key}`;
+        }
+        break;
+    }
+}
+function resolveSources(cookieSource) {
+    if (Array.isArray(cookieSource)) {
+        return cookieSource;
+    }
+    if (cookieSource) {
+        return [cookieSource];
+    }
+    return ['safari', 'chrome', 'firefox'];
+}
+function labelForSource(source, profile) {
+    if (source === 'safari') {
+        return 'Safari';
+    }
+    if (source === 'chrome') {
+        return profile ? `Chrome profile "${profile}"` : 'Chrome default profile';
+    }
+    return profile ? `Firefox profile "${profile}"` : 'Firefox default profile';
+}
+function pickCookieValue(cookies, name) {
+    const matches = cookies.filter((c) => c?.name === name && typeof c.value === 'string');
+    if (matches.length === 0) {
+        return null;
+    }
+    const preferred = matches.find((c) => (c.domain ?? '').endsWith('x.com'));
+    if (preferred?.value) {
+        return preferred.value;
+    }
+    const twitter = matches.find((c) => (c.domain ?? '').endsWith('twitter.com'));
+    if (twitter?.value) {
+        return twitter.value;
+    }
+    return matches[0]?.value ?? null;
+}
+async function readTwitterCookiesFromBrowser(options) {
+    const warnings = [];
+    const out = buildEmpty();
+    const { getCookies } = options;
+    const { cookies, warnings: providerWarnings } = await getCookies({
+        url: TWITTER_URL,
+        origins: TWITTER_ORIGINS,
+        names: [...TWITTER_COOKIE_NAMES],
+        browsers: [options.source],
+        mode: 'merge',
+        chromeProfile: options.chromeProfile,
+        firefoxProfile: options.firefoxProfile,
+        timeoutMs: options.cookieTimeoutMs,
+    });
+    warnings.push(...providerWarnings);
+    const authToken = pickCookieValue(cookies, 'auth_token');
+    const ct0 = pickCookieValue(cookies, 'ct0');
+    if (authToken) {
+        out.authToken = authToken;
+    }
+    if (ct0) {
+        out.ct0 = ct0;
+    }
+    if (out.authToken && out.ct0) {
+        out.cookieHeader = cookieHeader(out.authToken, out.ct0);
+        out.source = labelForSource(options.source, options.source === 'chrome' ? options.chromeProfile : options.firefoxProfile);
+        return { cookies: out, warnings };
+    }
+    if (options.source === 'safari') {
+        warnings.push('No Twitter cookies found in Safari. Make sure you are logged into x.com in Safari.');
+    }
+    else if (options.source === 'chrome') {
+        warnings.push('No Twitter cookies found in Chrome. Make sure you are logged into x.com in Chrome.');
+    }
+    else {
+        warnings.push('No Twitter cookies found in Firefox. Make sure you are logged into x.com in Firefox and the profile exists.');
+    }
+    return { cookies: out, warnings };
+}
+async function extractCookiesFromBrowser(options) {
+    const { getCookies } = await loadSweetCookie();
+    return readTwitterCookiesFromBrowser({
+        getCookies,
+        ...options,
+    });
+}
+export async function extractCookiesFromSafari() {
+    return extractCookiesFromBrowser({ source: 'safari' });
+}
+export async function extractCookiesFromChrome(profile) {
+    return extractCookiesFromBrowser({ source: 'chrome', chromeProfile: profile });
+}
+export async function extractCookiesFromFirefox(profile) {
+    return extractCookiesFromBrowser({ source: 'firefox', firefoxProfile: profile });
+}
+/**
+ * Resolve Twitter credentials from multiple sources.
+ * Priority: CLI args > environment variables > browsers (ordered).
+ */
+export async function resolveCredentials(options) {
+    const warnings = [];
+    const cookies = buildEmpty();
+    const disableBrowserCookies = envFlagEnabled('BIRD_DISABLE_BROWSER_COOKIES') ||
+        envFlagEnabled('LAST30DAYS_DISABLE_BROWSER_COOKIES');
+    const cookieTimeoutMs = typeof options.cookieTimeoutMs === 'number' &&
+        Number.isFinite(options.cookieTimeoutMs) &&
+        options.cookieTimeoutMs > 0
+        ? options.cookieTimeoutMs
+        : process.platform === 'darwin'
+            ? DEFAULT_COOKIE_TIMEOUT_MS
+            : undefined;
+    if (options.authToken) {
+        cookies.authToken = options.authToken;
+        cookies.source = 'CLI argument';
+    }
+    if (options.ct0) {
+        cookies.ct0 = options.ct0;
+        if (!cookies.source) {
+            cookies.source = 'CLI argument';
+        }
+    }
+    readEnvCookie(cookies, ['AUTH_TOKEN', 'TWITTER_AUTH_TOKEN'], 'authToken');
+    readEnvCookie(cookies, ['CT0', 'TWITTER_CT0'], 'ct0');
+    if (cookies.authToken && cookies.ct0) {
+        cookies.cookieHeader = cookieHeader(cookies.authToken, cookies.ct0);
+        return { cookies, warnings };
+    }
+    if (disableBrowserCookies) {
+        if (!cookies.authToken) {
+            warnings.push('Missing auth_token - provide via --auth-token, AUTH_TOKEN env var, or disable BIRD_DISABLE_BROWSER_COOKIES to allow browser cookie lookup');
+        }
+        if (!cookies.ct0) {
+            warnings.push('Missing ct0 - provide via --ct0, CT0 env var, or disable BIRD_DISABLE_BROWSER_COOKIES to allow browser cookie lookup');
+        }
+        return { cookies, warnings };
+    }
+    const sourcesToTry = resolveSources(options.cookieSource);
+    let getCookies;
+    try {
+        ({ getCookies } = await loadSweetCookie());
+    }
+    catch (error) {
+        if (error?.code !== 'ERR_MODULE_NOT_FOUND' ||
+            !String(error.message ?? '').includes('@steipete/sweet-cookie')) {
+            throw error;
+        }
+        warnings.push('Browser cookie lookup unavailable because vendored dependency @steipete/sweet-cookie is not installed.');
+        if (!cookies.authToken) {
+            warnings.push('Missing auth_token - provide via --auth-token, AUTH_TOKEN env var, or login to x.com in Safari/Chrome/Firefox');
+        }
+        if (!cookies.ct0) {
+            warnings.push('Missing ct0 - provide via --ct0, CT0 env var, or login to x.com in Safari/Chrome/Firefox');
+        }
+        return { cookies, warnings };
+    }
+    for (const source of sourcesToTry) {
+        const res = await readTwitterCookiesFromBrowser({
+            getCookies,
+            source,
+            chromeProfile: options.chromeProfile,
+            firefoxProfile: options.firefoxProfile,
+            cookieTimeoutMs,
+        });
+        warnings.push(...res.warnings);
+        if (res.cookies.authToken && res.cookies.ct0) {
+            return { cookies: res.cookies, warnings };
+        }
+    }
+    if (!cookies.authToken) {
+        warnings.push('Missing auth_token - provide via --auth-token, AUTH_TOKEN env var, or login to x.com in Safari/Chrome/Firefox');
+    }
+    if (!cookies.ct0) {
+        warnings.push('Missing ct0 - provide via --ct0, CT0 env var, or login to x.com in Safari/Chrome/Firefox');
+    }
+    if (cookies.authToken && cookies.ct0) {
+        cookies.cookieHeader = cookieHeader(cookies.authToken, cookies.ct0);
+    }
+    return { cookies, warnings };
+}
+//# sourceMappingURL=cookies.js.map

package/skills/luckiest-trends/scripts/lib/vendor/bird-search/lib/features.json

@@ -0,0 +1,17 @@
+{
+  "global": {
+    "responsive_web_grok_annotations_enabled": false,
+    "post_ctas_fetch_enabled": true,
+    "responsive_web_graphql_exclude_directive_enabled": true
+  },
+  "sets": {
+    "lists": {
+      "blue_business_profile_image_shape_enabled": true,
+      "tweetypie_unmention_optimization_enabled": true,
+      "responsive_web_text_conversations_enabled": false,
+      "interactive_text_enabled": true,
+      "vibe_api_enabled": true,
+      "responsive_web_twitter_blue_verified_badge_is_enabled": true
+    }
+  }
+}

package/skills/luckiest-trends/scripts/lib/vendor/bird-search/lib/paginate-cursor.js

@@ -0,0 +1,37 @@
+export async function paginateCursor(opts) {
+    const { maxPages, pageDelayMs = 1000 } = opts;
+    const seen = new Set();
+    const items = [];
+    let cursor = opts.cursor;
+    let pagesFetched = 0;
+    while (true) {
+        if (pagesFetched > 0 && pageDelayMs > 0) {
+            await opts.sleep(pageDelayMs);
+        }
+        const page = await opts.fetchPage(cursor);
+        if (!page.success) {
+            if (items.length > 0) {
+                return { success: false, error: page.error, items, nextCursor: cursor };
+            }
+            return page;
+        }
+        pagesFetched += 1;
+        for (const item of page.items) {
+            const key = opts.getKey(item);
+            if (seen.has(key)) {
+                continue;
+            }
+            seen.add(key);
+            items.push(item);
+        }
+        const pageCursor = page.cursor;
+        if (!pageCursor || pageCursor === cursor) {
+            return { success: true, items, nextCursor: undefined };
+        }
+        if (maxPages !== undefined && pagesFetched >= maxPages) {
+            return { success: true, items, nextCursor: pageCursor };
+        }
+        cursor = pageCursor;
+    }
+}
+//# sourceMappingURL=paginate-cursor.js.map

package/skills/luckiest-trends/scripts/lib/vendor/bird-search/lib/query-ids.json

@@ -0,0 +1,20 @@
+{
+  "CreateTweet": "nmdAQXJDxw6-0KKF2on7eA",
+  "CreateRetweet": "LFho5rIi4xcKO90p9jwG7A",
+  "CreateFriendship": "8h9JVdV8dlSyqyRDJEPCsA",
+  "DestroyFriendship": "ppXWuagMNXgvzx6WoXBW0Q",
+  "FavoriteTweet": "lI07N6Otwv1PhnEgXILM7A",
+  "DeleteBookmark": "Wlmlj2-xzyS1GN3a6cj-mQ",
+  "TweetDetail": "_NvJCnIjOW__EP5-RF197A",
+  "SearchTimeline": "6AAys3t42mosm_yTI_QENg",
+  "Bookmarks": "RV1g3b8n_SGOHwkqKYSCFw",
+  "BookmarkFolderTimeline": "KJIQpsvxrTfRIlbaRIySHQ",
+  "Following": "mWYeougg_ocJS2Vr1Vt28w",
+  "Followers": "SFYY3WsgwjlXSLlfnEUE4A",
+  "Likes": "ETJflBunfqNa1uE1mBPCaw",
+  "ExploreSidebar": "lpSN4M6qpimkF4nRFPE3nQ",
+  "ExplorePage": "kheAINB_4pzRDqkzG3K-ng",
+  "GenericTimelineById": "uGSr7alSjR9v6QJAIaqSKQ",
+  "TrendHistory": "Sj4T-jSB9pr0Mxtsc1UKZQ",
+  "AboutAccountQuery": "zs_jFPFT78rBpXv9Z3U2YQ"
+}

package/skills/luckiest-trends/scripts/lib/vendor/bird-search/lib/runtime-features.js

@@ -0,0 +1,151 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { mkdir, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import path from 'node:path';
+// biome-ignore lint/correctness/useImportExtensions: JSON module import doesn't use .js extension.
+import defaultOverrides from './features.json' with { type: 'json' };
+const DEFAULT_CACHE_FILENAME = 'features.json';
+let cachedOverrides = null;
+function normalizeFeatureMap(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        return {};
+    }
+    const result = {};
+    for (const [key, entry] of Object.entries(value)) {
+        if (typeof entry === 'boolean') {
+            result[key] = entry;
+        }
+    }
+    return result;
+}
+function normalizeOverrides(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        return { global: {}, sets: {} };
+    }
+    const record = value;
+    const global = normalizeFeatureMap(record.global);
+    const sets = {};
+    const rawSets = record.sets && typeof record.sets === 'object' && !Array.isArray(record.sets)
+        ? record.sets
+        : {};
+    for (const [setName, setValue] of Object.entries(rawSets)) {
+        const normalized = normalizeFeatureMap(setValue);
+        if (Object.keys(normalized).length > 0) {
+            sets[setName] = normalized;
+        }
+    }
+    return { global, sets };
+}
+function mergeOverrides(base, next) {
+    const sets = { ...base.sets };
+    for (const [setName, overrides] of Object.entries(next.sets)) {
+        const existing = sets[setName];
+        sets[setName] = existing ? { ...existing, ...overrides } : { ...overrides };
+    }
+    return {
+        global: { ...base.global, ...next.global },
+        sets,
+    };
+}
+function toFeatureOverrides(overrides) {
+    const result = {};
+    if (Object.keys(overrides.global).length > 0) {
+        result.global = overrides.global;
+    }
+    const setEntries = Object.entries(overrides.sets).filter(([, value]) => Object.keys(value).length > 0);
+    if (setEntries.length > 0) {
+        result.sets = Object.fromEntries(setEntries);
+    }
+    return result;
+}
+function resolveFeaturesCachePath() {
+    const override = process.env.BIRD_FEATURES_CACHE ?? process.env.BIRD_FEATURES_PATH;
+    if (override && override.trim().length > 0) {
+        return path.resolve(override.trim());
+    }
+    return path.join(homedir(), '.config', 'bird', DEFAULT_CACHE_FILENAME);
+}
+function readOverridesFromFile(cachePath) {
+    if (!existsSync(cachePath)) {
+        return null;
+    }
+    try {
+        const raw = readFileSync(cachePath, 'utf8');
+        return normalizeOverrides(JSON.parse(raw));
+    }
+    catch {
+        return null;
+    }
+}
+function readOverridesFromEnv() {
+    const raw = process.env.BIRD_FEATURES_JSON;
+    if (!raw || raw.trim().length === 0) {
+        return null;
+    }
+    try {
+        return normalizeOverrides(JSON.parse(raw));
+    }
+    catch {
+        return null;
+    }
+}
+function writeOverridesToDisk(cachePath, overrides) {
+    const payload = toFeatureOverrides(overrides);
+    return mkdir(path.dirname(cachePath), { recursive: true }).then(() => writeFile(cachePath, `${JSON.stringify(payload, null, 2)}\n`, 'utf8'));
+}
+export function loadFeatureOverrides() {
+    if (cachedOverrides) {
+        return cachedOverrides;
+    }
+    const base = normalizeOverrides(defaultOverrides);
+    const fromFile = readOverridesFromFile(resolveFeaturesCachePath());
+    const fromEnv = readOverridesFromEnv();
+    let merged = base;
+    if (fromFile) {
+        merged = mergeOverrides(merged, fromFile);
+    }
+    if (fromEnv) {
+        merged = mergeOverrides(merged, fromEnv);
+    }
+    cachedOverrides = merged;
+    return merged;
+}
+export function getFeatureOverridesSnapshot() {
+    const overrides = toFeatureOverrides(loadFeatureOverrides());
+    return {
+        cachePath: resolveFeaturesCachePath(),
+        overrides,
+    };
+}
+export function applyFeatureOverrides(setName, base) {
+    const overrides = loadFeatureOverrides();
+    const globalOverrides = overrides.global;
+    const setOverrides = overrides.sets[setName];
+    if (Object.keys(globalOverrides).length === 0 && (!setOverrides || Object.keys(setOverrides).length === 0)) {
+        return base;
+    }
+    if (setOverrides) {
+        return {
+            ...base,
+            ...globalOverrides,
+            ...setOverrides,
+        };
+    }
+    return {
+        ...base,
+        ...globalOverrides,
+    };
+}
+export async function refreshFeatureOverridesCache() {
+    const cachePath = resolveFeaturesCachePath();
+    const base = normalizeOverrides(defaultOverrides);
+    const fromFile = readOverridesFromFile(cachePath);
+    const merged = mergeOverrides(base, fromFile ?? { global: {}, sets: {} });
+    await writeOverridesToDisk(cachePath, merged);
+    cachedOverrides = null;
+    return { cachePath, overrides: toFeatureOverrides(merged) };
+}
+export function clearFeatureOverridesCache() {
+    cachedOverrides = null;
+}
+//# sourceMappingURL=runtime-features.js.map