@antcoder/birdxtwittercli 0.8.0

package/dist/lib/twitter-client-search.js

@@ -0,0 +1,157 @@
+import { TWITTER_API_BASE } from './twitter-client-constants.js';
+import { buildSearchFeatures } from './twitter-client-features.js';
+import { extractCursorFromInstructions, parseTweetsFromInstructions } from './twitter-client-utils.js';
+const RAW_QUERY_MISSING_REGEX = /must be defined/i;
+function isQueryIdMismatch(payload) {
+    try {
+        const parsed = JSON.parse(payload);
+        return (parsed.errors?.some((error) => {
+            if (error?.extensions?.code === 'GRAPHQL_VALIDATION_FAILED') {
+                return true;
+            }
+            if (error?.path?.includes('rawQuery') && RAW_QUERY_MISSING_REGEX.test(error.message ?? '')) {
+                return true;
+            }
+            return false;
+        }) ?? false);
+    }
+    catch {
+        return false;
+    }
+}
+export function withSearch(Base) {
+    class TwitterClientSearch extends Base {
+        // biome-ignore lint/complexity/noUselessConstructor lint/suspicious/noExplicitAny: TS mixin constructor requirement.
+        constructor(...args) {
+            super(...args);
+        }
+        /**
+         * Search for tweets matching a query
+         */
+        async search(query, count = 20, options = {}) {
+            return this.searchPaged(query, count, options);
+        }
+        /**
+         * Get all search results (paged)
+         */
+        async getAllSearchResults(query, options) {
+            return this.searchPaged(query, Number.POSITIVE_INFINITY, options);
+        }
+        async searchPaged(query, limit, options = {}) {
+            const features = buildSearchFeatures();
+            const pageSize = 20;
+            const seen = new Set();
+            const tweets = [];
+            let cursor = options.cursor;
+            let nextCursor;
+            let pagesFetched = 0;
+            const { includeRaw = false, maxPages } = options;
+            const fetchPage = async (pageCount, pageCursor) => {
+                let lastError;
+                let had404 = false;
+                const queryIds = await this.getSearchTimelineQueryIds();
+                for (const queryId of queryIds) {
+                    const variables = {
+                        rawQuery: query,
+                        count: pageCount,
+                        querySource: 'typed_query',
+                        product: 'Latest',
+                        ...(pageCursor ? { cursor: pageCursor } : {}),
+                    };
+                    const params = new URLSearchParams({
+                        variables: JSON.stringify(variables),
+                    });
+                    const url = `${TWITTER_API_BASE}/${queryId}/SearchTimeline?${params.toString()}`;
+                    try {
+                        const response = await this.fetchWithTimeout(url, {
+                            method: 'POST',
+                            headers: this.getHeaders(),
+                            body: JSON.stringify({ features, queryId }),
+                        });
+                        if (response.status === 404) {
+                            had404 = true;
+                            lastError = `HTTP ${response.status}`;
+                            continue;
+                        }
+                        if (!response.ok) {
+                            const text = await response.text();
+                            const shouldRefreshQueryIds = (response.status === 400 || response.status === 422) && isQueryIdMismatch(text);
+                            return {
+                                success: false,
+                                error: `HTTP ${response.status}: ${text.slice(0, 200)}`,
+                                had404: had404 || shouldRefreshQueryIds,
+                            };
+                        }
+                        const data = (await response.json());
+                        if (data.errors && data.errors.length > 0) {
+                            const shouldRefreshQueryIds = data.errors.some((error) => error?.extensions?.code === 'GRAPHQL_VALIDATION_FAILED');
+                            return {
+                                success: false,
+                                error: data.errors.map((e) => e.message).join(', '),
+                                had404: had404 || shouldRefreshQueryIds,
+                            };
+                        }
+                        const instructions = data.data?.search_by_raw_query?.search_timeline?.timeline?.instructions;
+                        const pageTweets = parseTweetsFromInstructions(instructions, { quoteDepth: this.quoteDepth, includeRaw });
+                        const nextCursor = extractCursorFromInstructions(instructions);
+                        return { success: true, tweets: pageTweets, cursor: nextCursor, had404 };
+                    }
+                    catch (error) {
+                        lastError = error instanceof Error ? error.message : String(error);
+                    }
+                }
+                return { success: false, error: lastError ?? 'Unknown error fetching search results', had404 };
+            };
+            const fetchWithRefresh = async (pageCount, pageCursor) => {
+                const firstAttempt = await fetchPage(pageCount, pageCursor);
+                if (firstAttempt.success) {
+                    return firstAttempt;
+                }
+                if (firstAttempt.had404) {
+                    await this.refreshQueryIds();
+                    const secondAttempt = await fetchPage(pageCount, pageCursor);
+                    if (secondAttempt.success) {
+                        return secondAttempt;
+                    }
+                    return { success: false, error: secondAttempt.error };
+                }
+                return { success: false, error: firstAttempt.error };
+            };
+            const unlimited = limit === Number.POSITIVE_INFINITY;
+            while (unlimited || tweets.length < limit) {
+                const pageCount = unlimited ? pageSize : Math.min(pageSize, limit - tweets.length);
+                const page = await fetchWithRefresh(pageCount, cursor);
+                if (!page.success) {
+                    return { success: false, error: page.error };
+                }
+                pagesFetched += 1;
+                let added = 0;
+                for (const tweet of page.tweets) {
+                    if (seen.has(tweet.id)) {
+                        continue;
+                    }
+                    seen.add(tweet.id);
+                    tweets.push(tweet);
+                    added += 1;
+                    if (!unlimited && tweets.length >= limit) {
+                        break;
+                    }
+                }
+                const pageCursor = page.cursor;
+                if (!pageCursor || pageCursor === cursor || page.tweets.length === 0 || added === 0) {
+                    nextCursor = undefined;
+                    break;
+                }
+                if (maxPages && pagesFetched >= maxPages) {
+                    nextCursor = pageCursor;
+                    break;
+                }
+                cursor = pageCursor;
+                nextCursor = pageCursor;
+            }
+            return { success: true, tweets, nextCursor };
+        }
+    }
+    return TwitterClientSearch;
+}
+//# sourceMappingURL=twitter-client-search.js.map

package/dist/lib/twitter-client-search.js.map

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

package/dist/lib/twitter-client-timelines.d.ts

@@ -0,0 +1,23 @@
+import type { AbstractConstructor, Mixin, TwitterClientBase } from './twitter-client-base.js';
+import type { SearchResult } from './twitter-client-types.js';
+/** Options for timeline fetch methods */
+export interface TimelineFetchOptions {
+    /** Include raw GraphQL response in `_raw` field */
+    includeRaw?: boolean;
+}
+/** Options for paged timeline fetch methods */
+export interface TimelinePaginationOptions extends TimelineFetchOptions {
+    maxPages?: number;
+    /** Starting cursor for pagination (resume from previous fetch) */
+    cursor?: string;
+}
+export interface TwitterClientTimelineMethods {
+    getBookmarks(count?: number, options?: TimelineFetchOptions): Promise<SearchResult>;
+    getAllBookmarks(options?: TimelinePaginationOptions): Promise<SearchResult>;
+    getLikes(count?: number, options?: TimelineFetchOptions): Promise<SearchResult>;
+    getAllLikes(options?: TimelinePaginationOptions): Promise<SearchResult>;
+    getBookmarkFolderTimeline(folderId: string, count?: number, options?: TimelineFetchOptions): Promise<SearchResult>;
+    getAllBookmarkFolderTimeline(folderId: string, options?: TimelinePaginationOptions): Promise<SearchResult>;
+}
+export declare function withTimelines<TBase extends AbstractConstructor<TwitterClientBase>>(Base: TBase): Mixin<TBase, TwitterClientTimelineMethods>;
+//# sourceMappingURL=twitter-client-timelines.d.ts.map

package/dist/lib/twitter-client-timelines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"twitter-client-timelines.d.ts","sourceRoot":"","sources":["../../src/lib/twitter-client-timelines.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAG9F,OAAO,KAAK,EAAsB,YAAY,EAAa,MAAM,2BAA2B,CAAC;AAG7F,yCAAyC;AACzC,MAAM,WAAW,oBAAoB;IACnC,mDAAmD;IACnD,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,+CAA+C;AAC/C,MAAM,WAAW,yBAA0B,SAAQ,oBAAoB;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,4BAA4B;IAC3C,YAAY,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACpF,eAAe,CAAC,OAAO,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC5E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAChF,WAAW,CAAC,OAAO,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACxE,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACnH,4BAA4B,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAC5G;AAED,wBAAgB,aAAa,CAAC,KAAK,SAAS,mBAAmB,CAAC,iBAAiB,CAAC,EAChF,IAAI,EAAE,KAAK,GACV,KAAK,CAAC,KAAK,EAAE,4BAA4B,CAAC,CA4lB5C"}

package/dist/lib/twitter-client-timelines.js

@@ -0,0 +1,471 @@
+import { TWITTER_API_BASE } from './twitter-client-constants.js';
+import { buildBookmarksFeatures, buildLikesFeatures } from './twitter-client-features.js';
+import { extractCursorFromInstructions, parseTweetsFromInstructions } from './twitter-client-utils.js';
+export function withTimelines(Base) {
+    class TwitterClientTimelines extends Base {
+        // biome-ignore lint/complexity/noUselessConstructor lint/suspicious/noExplicitAny: TS mixin constructor requirement.
+        constructor(...args) {
+            super(...args);
+        }
+        logBookmarksDebug(message, data) {
+            if (process.env.BIRD_DEBUG_BOOKMARKS !== '1') {
+                return;
+            }
+            if (data) {
+                console.error(`[bird][debug][bookmarks] ${message}`, JSON.stringify(data));
+            }
+            else {
+                console.error(`[bird][debug][bookmarks] ${message}`);
+            }
+        }
+        async getBookmarksQueryIds() {
+            const primary = await this.getQueryId('Bookmarks');
+            return Array.from(new Set([primary, 'RV1g3b8n_SGOHwkqKYSCFw', 'tmd4ifV8RHltzn8ymGg1aw']));
+        }
+        async getBookmarkFolderQueryIds() {
+            const primary = await this.getQueryId('BookmarkFolderTimeline');
+            return Array.from(new Set([primary, 'KJIQpsvxrTfRIlbaRIySHQ']));
+        }
+        async getLikesQueryIds() {
+            const primary = await this.getQueryId('Likes');
+            return Array.from(new Set([primary, 'JR2gceKucIKcVNB_9JkhsA']));
+        }
+        /**
+         * Get the authenticated user's bookmarks
+         */
+        async getBookmarks(count = 20, options = {}) {
+            return this.getBookmarksPaged(count, options);
+        }
+        async getAllBookmarks(options) {
+            return this.getBookmarksPaged(Number.POSITIVE_INFINITY, options);
+        }
+        /**
+         * Get the authenticated user's liked tweets
+         */
+        async getLikes(count = 20, options = {}) {
+            return this.getLikesPaged(count, options);
+        }
+        async getAllLikes(options) {
+            return this.getLikesPaged(Number.POSITIVE_INFINITY, options);
+        }
+        async getLikesPaged(limit, options = {}) {
+            const userResult = await this.getCurrentUser();
+            if (!userResult.success || !userResult.user) {
+                return { success: false, error: userResult.error ?? 'Could not determine current user' };
+            }
+            const userId = userResult.user.id;
+            const features = buildLikesFeatures();
+            const pageSize = 20;
+            const seen = new Set();
+            const tweets = [];
+            let cursor = options.cursor;
+            let nextCursor;
+            let pagesFetched = 0;
+            const { includeRaw = false, maxPages } = options;
+            const fetchPage = async (pageCount, pageCursor) => {
+                let lastError;
+                let had404 = false;
+                const queryIds = await this.getLikesQueryIds();
+                for (const queryId of queryIds) {
+                    const variables = {
+                        userId,
+                        count: pageCount,
+                        includePromotedContent: false,
+                        withClientEventToken: false,
+                        withBirdwatchNotes: false,
+                        withVoice: true,
+                        ...(pageCursor ? { cursor: pageCursor } : {}),
+                    };
+                    const params = new URLSearchParams({
+                        variables: JSON.stringify(variables),
+                        features: JSON.stringify(features),
+                    });
+                    const url = `${TWITTER_API_BASE}/${queryId}/Likes?${params.toString()}`;
+                    try {
+                        const response = await this.fetchWithTimeout(url, {
+                            method: 'GET',
+                            headers: this.getHeaders(),
+                        });
+                        if (response.status === 404) {
+                            had404 = true;
+                            lastError = `HTTP ${response.status}`;
+                            continue;
+                        }
+                        if (!response.ok) {
+                            const text = await response.text();
+                            return { success: false, error: `HTTP ${response.status}: ${text.slice(0, 200)}`, had404 };
+                        }
+                        const data = (await response.json());
+                        const instructions = data.data?.user?.result?.timeline?.timeline?.instructions;
+                        if (data.errors && data.errors.length > 0) {
+                            const message = data.errors.map((e) => e.message).join(', ');
+                            if (!instructions) {
+                                if (message.includes('Query: Unspecified')) {
+                                    lastError = message;
+                                    continue;
+                                }
+                                return { success: false, error: message, had404 };
+                            }
+                        }
+                        const pageTweets = parseTweetsFromInstructions(instructions, { quoteDepth: this.quoteDepth, includeRaw });
+                        const extractedCursor = extractCursorFromInstructions(instructions);
+                        return { success: true, tweets: pageTweets, cursor: extractedCursor, had404 };
+                    }
+                    catch (error) {
+                        lastError = error instanceof Error ? error.message : String(error);
+                    }
+                }
+                return { success: false, error: lastError ?? 'Unknown error fetching likes', had404 };
+            };
+            const fetchWithRefresh = async (pageCount, pageCursor) => {
+                const firstAttempt = await fetchPage(pageCount, pageCursor);
+                if (firstAttempt.success) {
+                    return firstAttempt;
+                }
+                const shouldRefresh = firstAttempt.had404 ||
+                    (typeof firstAttempt.error === 'string' && firstAttempt.error.includes('Query: Unspecified'));
+                if (shouldRefresh) {
+                    await this.refreshQueryIds();
+                    const secondAttempt = await fetchPage(pageCount, pageCursor);
+                    if (secondAttempt.success) {
+                        return secondAttempt;
+                    }
+                    return { success: false, error: secondAttempt.error };
+                }
+                return { success: false, error: firstAttempt.error };
+            };
+            const unlimited = limit === Number.POSITIVE_INFINITY;
+            while (unlimited || tweets.length < limit) {
+                const pageCount = unlimited ? pageSize : Math.min(pageSize, limit - tweets.length);
+                const page = await fetchWithRefresh(pageCount, cursor);
+                if (!page.success) {
+                    return { success: false, error: page.error };
+                }
+                pagesFetched += 1;
+                let added = 0;
+                for (const tweet of page.tweets) {
+                    if (seen.has(tweet.id)) {
+                        continue;
+                    }
+                    seen.add(tweet.id);
+                    tweets.push(tweet);
+                    added += 1;
+                    if (!unlimited && tweets.length >= limit) {
+                        break;
+                    }
+                }
+                const pageCursor = page.cursor;
+                if (!pageCursor || pageCursor === cursor || page.tweets.length === 0 || added === 0) {
+                    nextCursor = undefined;
+                    break;
+                }
+                if (maxPages && pagesFetched >= maxPages) {
+                    nextCursor = pageCursor;
+                    break;
+                }
+                cursor = pageCursor;
+                nextCursor = pageCursor;
+            }
+            return { success: true, tweets, nextCursor };
+        }
+        /**
+         * Get the authenticated user's bookmark folder timeline
+         */
+        async getBookmarkFolderTimeline(folderId, count = 20, options = {}) {
+            return this.getBookmarkFolderTimelinePaged(folderId, count, options);
+        }
+        async getAllBookmarkFolderTimeline(folderId, options) {
+            return this.getBookmarkFolderTimelinePaged(folderId, Number.POSITIVE_INFINITY, options);
+        }
+        async getBookmarksPaged(limit, options = {}) {
+            const features = buildBookmarksFeatures();
+            const pageSize = 20;
+            const seen = new Set();
+            const tweets = [];
+            let cursor = options.cursor;
+            let nextCursor;
+            let pagesFetched = 0;
+            const { includeRaw = false, maxPages } = options;
+            const fetchPage = async (pageCount, pageCursor) => {
+                let lastError;
+                let had404 = false;
+                const queryIds = await this.getBookmarksQueryIds();
+                const variables = {
+                    count: pageCount,
+                    includePromotedContent: false,
+                    withDownvotePerspective: false,
+                    withReactionsMetadata: false,
+                    withReactionsPerspective: false,
+                    ...(pageCursor ? { cursor: pageCursor } : {}),
+                };
+                const params = new URLSearchParams({
+                    variables: JSON.stringify(variables),
+                    features: JSON.stringify(features),
+                });
+                for (const queryId of queryIds) {
+                    const url = `${TWITTER_API_BASE}/${queryId}/Bookmarks?${params.toString()}`;
+                    try {
+                        this.logBookmarksDebug('request bookmarks page', {
+                            queryId,
+                            pageCount,
+                            hasCursor: Boolean(pageCursor),
+                        });
+                        const response = await this.fetchWithRetry(url, {
+                            method: 'GET',
+                            headers: this.getHeaders(),
+                        });
+                        if (response.status === 404) {
+                            had404 = true;
+                            lastError = `HTTP ${response.status}`;
+                            this.logBookmarksDebug('bookmarks 404', { queryId });
+                            continue;
+                        }
+                        if (!response.ok) {
+                            const text = await response.text();
+                            this.logBookmarksDebug('bookmarks non-200', {
+                                queryId,
+                                status: response.status,
+                                body: text.slice(0, 200),
+                            });
+                            return { success: false, error: `HTTP ${response.status}: ${text.slice(0, 200)}`, had404 };
+                        }
+                        const data = (await response.json());
+                        const instructions = data.data?.bookmark_timeline_v2?.timeline?.instructions;
+                        const pageTweets = parseTweetsFromInstructions(instructions, { quoteDepth: this.quoteDepth, includeRaw });
+                        const nextCursor = extractCursorFromInstructions(instructions);
+                        if (data.errors && data.errors.length > 0) {
+                            this.logBookmarksDebug('bookmarks graphql errors (non-fatal)', { queryId, errors: data.errors });
+                            if (!instructions) {
+                                lastError = data.errors.map((e) => e.message).join(', ');
+                                continue;
+                            }
+                        }
+                        this.logBookmarksDebug('bookmarks page parsed', {
+                            queryId,
+                            tweets: pageTweets.length,
+                            hasNextCursor: Boolean(nextCursor),
+                        });
+                        return { success: true, tweets: pageTweets, cursor: nextCursor, had404 };
+                    }
+                    catch (error) {
+                        lastError = error instanceof Error ? error.message : String(error);
+                        this.logBookmarksDebug('bookmarks request error', { queryId, error: lastError });
+                    }
+                }
+                return { success: false, error: lastError ?? 'Unknown error fetching bookmarks', had404 };
+            };
+            const fetchWithRefresh = async (pageCount, pageCursor) => {
+                const firstAttempt = await fetchPage(pageCount, pageCursor);
+                if (firstAttempt.success) {
+                    return firstAttempt;
+                }
+                if (firstAttempt.had404) {
+                    await this.refreshQueryIds();
+                    const secondAttempt = await fetchPage(pageCount, pageCursor);
+                    if (secondAttempt.success) {
+                        return secondAttempt;
+                    }
+                    return { success: false, error: secondAttempt.error };
+                }
+                return { success: false, error: firstAttempt.error };
+            };
+            const unlimited = limit === Number.POSITIVE_INFINITY;
+            while (unlimited || tweets.length < limit) {
+                const pageCount = unlimited ? pageSize : Math.min(pageSize, limit - tweets.length);
+                const page = await fetchWithRefresh(pageCount, cursor);
+                if (!page.success) {
+                    return { success: false, error: page.error };
+                }
+                pagesFetched += 1;
+                let added = 0;
+                for (const tweet of page.tweets) {
+                    if (seen.has(tweet.id)) {
+                        continue;
+                    }
+                    seen.add(tweet.id);
+                    tweets.push(tweet);
+                    added += 1;
+                    if (!unlimited && tweets.length >= limit) {
+                        break;
+                    }
+                }
+                const pageCursor = page.cursor;
+                if (!pageCursor || pageCursor === cursor || page.tweets.length === 0 || added === 0) {
+                    nextCursor = undefined;
+                    break;
+                }
+                if (maxPages && pagesFetched >= maxPages) {
+                    nextCursor = pageCursor;
+                    break;
+                }
+                cursor = pageCursor;
+                nextCursor = pageCursor;
+            }
+            return { success: true, tweets, nextCursor };
+        }
+        async getBookmarkFolderTimelinePaged(folderId, limit, options = {}) {
+            const features = buildBookmarksFeatures();
+            const pageSize = 20;
+            const seen = new Set();
+            const tweets = [];
+            let cursor = options.cursor;
+            let nextCursor;
+            let pagesFetched = 0;
+            const { includeRaw = false, maxPages } = options;
+            const buildVariables = (pageCount, pageCursor, includeCount) => ({
+                bookmark_collection_id: folderId,
+                includePromotedContent: true,
+                ...(includeCount ? { count: pageCount } : {}),
+                ...(pageCursor ? { cursor: pageCursor } : {}),
+            });
+            const fetchPage = async (pageCount, pageCursor) => {
+                let lastError;
+                let had404 = false;
+                const queryIds = await this.getBookmarkFolderQueryIds();
+                const tryOnce = async (variables) => {
+                    const params = new URLSearchParams({
+                        variables: JSON.stringify(variables),
+                        features: JSON.stringify(features),
+                    });
+                    for (const queryId of queryIds) {
+                        const url = `${TWITTER_API_BASE}/${queryId}/BookmarkFolderTimeline?${params.toString()}`;
+                        try {
+                            this.logBookmarksDebug('request bookmark folder page', {
+                                queryId,
+                                pageCount,
+                                hasCursor: Boolean(pageCursor),
+                                includeCount: Object.hasOwn(variables, 'count'),
+                            });
+                            const response = await this.fetchWithRetry(url, {
+                                method: 'GET',
+                                headers: this.getHeaders(),
+                            });
+                            if (response.status === 404) {
+                                had404 = true;
+                                lastError = `HTTP ${response.status}`;
+                                this.logBookmarksDebug('bookmark folder 404', { queryId });
+                                continue;
+                            }
+                            if (!response.ok) {
+                                const text = await response.text();
+                                this.logBookmarksDebug('bookmark folder non-200', {
+                                    queryId,
+                                    status: response.status,
+                                    body: text.slice(0, 200),
+                                });
+                                return { success: false, error: `HTTP ${response.status}: ${text.slice(0, 200)}`, had404 };
+                            }
+                            const data = (await response.json());
+                            const instructions = data.data?.bookmark_collection_timeline?.timeline?.instructions;
+                            const pageTweets = parseTweetsFromInstructions(instructions, { quoteDepth: this.quoteDepth, includeRaw });
+                            const nextCursor = extractCursorFromInstructions(instructions);
+                            if (data.errors && data.errors.length > 0) {
+                                this.logBookmarksDebug('bookmark folder graphql errors (non-fatal)', { queryId, errors: data.errors });
+                                if (!instructions) {
+                                    lastError = data.errors.map((e) => e.message).join(', ');
+                                    continue;
+                                }
+                            }
+                            this.logBookmarksDebug('bookmark folder page parsed', {
+                                queryId,
+                                tweets: pageTweets.length,
+                                hasNextCursor: Boolean(nextCursor),
+                            });
+                            return { success: true, tweets: pageTweets, cursor: nextCursor, had404 };
+                        }
+                        catch (error) {
+                            lastError = error instanceof Error ? error.message : String(error);
+                            this.logBookmarksDebug('bookmark folder request error', { queryId, error: lastError });
+                        }
+                    }
+                    return { success: false, error: lastError ?? 'Unknown error fetching bookmark folder', had404 };
+                };
+                let attempt = await tryOnce(buildVariables(pageCount, pageCursor, true));
+                if (!attempt.success && attempt.error?.includes('Variable "$count"')) {
+                    attempt = await tryOnce(buildVariables(pageCount, pageCursor, false));
+                }
+                if (!attempt.success && attempt.error?.includes('Variable "$cursor"') && pageCursor) {
+                    return {
+                        success: false,
+                        error: 'Bookmark folder pagination rejected the cursor parameter',
+                        had404: attempt.had404,
+                    };
+                }
+                return attempt;
+            };
+            const fetchWithRefresh = async (pageCount, pageCursor) => {
+                const firstAttempt = await fetchPage(pageCount, pageCursor);
+                if (firstAttempt.success) {
+                    return firstAttempt;
+                }
+                if (firstAttempt.had404) {
+                    await this.refreshQueryIds();
+                    const secondAttempt = await fetchPage(pageCount, pageCursor);
+                    if (secondAttempt.success) {
+                        return secondAttempt;
+                    }
+                    return { success: false, error: secondAttempt.error };
+                }
+                return { success: false, error: firstAttempt.error };
+            };
+            const unlimited = limit === Number.POSITIVE_INFINITY;
+            while (unlimited || tweets.length < limit) {
+                const pageCount = unlimited ? pageSize : Math.min(pageSize, limit - tweets.length);
+                const page = await fetchWithRefresh(pageCount, cursor);
+                if (!page.success) {
+                    return { success: false, error: page.error };
+                }
+                pagesFetched += 1;
+                let added = 0;
+                for (const tweet of page.tweets) {
+                    if (seen.has(tweet.id)) {
+                        continue;
+                    }
+                    seen.add(tweet.id);
+                    tweets.push(tweet);
+                    added += 1;
+                    if (!unlimited && tweets.length >= limit) {
+                        break;
+                    }
+                }
+                const pageCursor = page.cursor;
+                if (!pageCursor || pageCursor === cursor || page.tweets.length === 0 || added === 0) {
+                    nextCursor = undefined;
+                    break;
+                }
+                if (maxPages && pagesFetched >= maxPages) {
+                    nextCursor = pageCursor;
+                    break;
+                }
+                cursor = pageCursor;
+                nextCursor = pageCursor;
+            }
+            return { success: true, tweets, nextCursor };
+        }
+        async fetchWithRetry(url, init) {
+            const maxRetries = 2;
+            const baseDelayMs = 500;
+            const retryable = new Set([429, 500, 502, 503, 504]);
+            for (let attempt = 0; attempt <= maxRetries; attempt += 1) {
+                const response = await this.fetchWithTimeout(url, init);
+                if (!retryable.has(response.status) || attempt === maxRetries) {
+                    return response;
+                }
+                this.logBookmarksDebug('retrying bookmarks request', {
+                    status: response.status,
+                    attempt,
+                });
+                // Retry-After supports delta-seconds only; HTTP-date falls back to backoff.
+                const retryAfter = response.headers?.get?.('retry-after');
+                const retryAfterMs = retryAfter ? Number.parseInt(retryAfter, 10) * 1000 : Number.NaN;
+                const backoffMs = Number.isFinite(retryAfterMs)
+                    ? retryAfterMs
+                    : baseDelayMs * 2 ** attempt + Math.floor(Math.random() * baseDelayMs);
+                await new Promise((resolve) => setTimeout(resolve, backoffMs));
+            }
+            return this.fetchWithTimeout(url, init);
+        }
+    }
+    return TwitterClientTimelines;
+}
+//# sourceMappingURL=twitter-client-timelines.js.map