feat: add --json-full flag to include raw API response in _raw field

yuta/bird

Add a new --json-full flag to tweet-fetching commands that outputs JSON
with an additional _raw field containing the full GraphQL response.

This provides power users access to additional data not exposed in the
curated TweetData interface (media, entities, hashtags, cards, etc.)
while maintaining backward compatibility with --json.

Supported commands:
- read, replies, thread (TweetDetail API)
- search, mentions (SearchTimeline API)
- bookmarks (Bookmarks API)
- likes (Likes API)

Not supported: following, followers (uses mixed GraphQL/REST fallback
with different response structures)

Implementation:
- Add _raw?: GraphqlTweetResult optional field to TweetData type
- Add includeRaw option to mapTweetResult() and parseTweetsFromInstructions()
- Add TweetFetchOptions, SearchFetchOptions, TimelineFetchOptions interfaces
- Update client methods to accept options parameter
- Add --json-full flag to CLI commands
- Update help text to document the new flag
- Add comprehensive test coverage (16 tests)

Co-authored-by: Christian Catalan <[email protected]>

This commit is contained in:

cc-vps

2026-01-03 06:54:36 +01:00

committed by

Peter Steinberger

co-authored by

Christian Catalan

parent 42abae9c15

commit 3815ebfa03

13 changed files with 658 additions and 48 deletions

									
										src/lib/twitter-client-types.ts
									
		+3
		
												View File
												
				@@ -184,6 +184,9 @@ export interface TweetData {

				  inReplyToStatusId?: string;

				  // Optional quoted tweet; depth controlled by quoteDepth (default: 1).

				  quotedTweet?: TweetData;

				  // Raw GraphQL response (included when --json-full is used).

				  // Structure may change as Twitter's API evolves.

				  _raw?: GraphqlTweetResult;

				}

				export interface GetTweetResult {