@antcoder/birdxtwittercli 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (214) hide show
  1. package/CHANGELOG.md +176 -0
  2. package/LICENSE +21 -0
  3. package/README.md +388 -0
  4. package/dist/cli/pagination.d.ts +35 -0
  5. package/dist/cli/pagination.d.ts.map +1 -0
  6. package/dist/cli/pagination.js +43 -0
  7. package/dist/cli/pagination.js.map +1 -0
  8. package/dist/cli/program.d.ts +5 -0
  9. package/dist/cli/program.d.ts.map +1 -0
  10. package/dist/cli/program.js +113 -0
  11. package/dist/cli/program.js.map +1 -0
  12. package/dist/cli/shared.d.ts +77 -0
  13. package/dist/cli/shared.d.ts.map +1 -0
  14. package/dist/cli/shared.js +327 -0
  15. package/dist/cli/shared.js.map +1 -0
  16. package/dist/cli.d.ts +12 -0
  17. package/dist/cli.d.ts.map +1 -0
  18. package/dist/cli.js +29 -0
  19. package/dist/cli.js.map +1 -0
  20. package/dist/commands/bookmarks.d.ts +4 -0
  21. package/dist/commands/bookmarks.d.ts.map +1 -0
  22. package/dist/commands/bookmarks.js +189 -0
  23. package/dist/commands/bookmarks.js.map +1 -0
  24. package/dist/commands/check.d.ts +4 -0
  25. package/dist/commands/check.d.ts.map +1 -0
  26. package/dist/commands/check.js +43 -0
  27. package/dist/commands/check.js.map +1 -0
  28. package/dist/commands/follow.d.ts +4 -0
  29. package/dist/commands/follow.d.ts.map +1 -0
  30. package/dist/commands/follow.js +91 -0
  31. package/dist/commands/follow.js.map +1 -0
  32. package/dist/commands/help.d.ts +4 -0
  33. package/dist/commands/help.d.ts.map +1 -0
  34. package/dist/commands/help.js +19 -0
  35. package/dist/commands/help.js.map +1 -0
  36. package/dist/commands/home.d.ts +4 -0
  37. package/dist/commands/home.d.ts.map +1 -0
  38. package/dist/commands/home.js +43 -0
  39. package/dist/commands/home.js.map +1 -0
  40. package/dist/commands/lists.d.ts +4 -0
  41. package/dist/commands/lists.d.ts.map +1 -0
  42. package/dist/commands/lists.js +213 -0
  43. package/dist/commands/lists.js.map +1 -0
  44. package/dist/commands/news.d.ts +4 -0
  45. package/dist/commands/news.d.ts.map +1 -0
  46. package/dist/commands/news.js +131 -0
  47. package/dist/commands/news.js.map +1 -0
  48. package/dist/commands/post.d.ts +4 -0
  49. package/dist/commands/post.d.ts.map +1 -0
  50. package/dist/commands/post.js +101 -0
  51. package/dist/commands/post.js.map +1 -0
  52. package/dist/commands/query-ids.d.ts +4 -0
  53. package/dist/commands/query-ids.d.ts.map +1 -0
  54. package/dist/commands/query-ids.js +80 -0
  55. package/dist/commands/query-ids.js.map +1 -0
  56. package/dist/commands/read.d.ts +4 -0
  57. package/dist/commands/read.d.ts.map +1 -0
  58. package/dist/commands/read.js +152 -0
  59. package/dist/commands/read.js.map +1 -0
  60. package/dist/commands/search.d.ts +4 -0
  61. package/dist/commands/search.d.ts.map +1 -0
  62. package/dist/commands/search.js +115 -0
  63. package/dist/commands/search.js.map +1 -0
  64. package/dist/commands/unbookmark.d.ts +4 -0
  65. package/dist/commands/unbookmark.d.ts.map +1 -0
  66. package/dist/commands/unbookmark.js +36 -0
  67. package/dist/commands/unbookmark.js.map +1 -0
  68. package/dist/commands/user-tweets.d.ts +4 -0
  69. package/dist/commands/user-tweets.d.ts.map +1 -0
  70. package/dist/commands/user-tweets.js +109 -0
  71. package/dist/commands/user-tweets.js.map +1 -0
  72. package/dist/commands/users.d.ts +4 -0
  73. package/dist/commands/users.d.ts.map +1 -0
  74. package/dist/commands/users.js +295 -0
  75. package/dist/commands/users.js.map +1 -0
  76. package/dist/index.d.ts +2 -0
  77. package/dist/index.d.ts.map +1 -0
  78. package/dist/index.js +2 -0
  79. package/dist/index.js.map +1 -0
  80. package/dist/lib/cli-args.d.ts +7 -0
  81. package/dist/lib/cli-args.d.ts.map +1 -0
  82. package/dist/lib/cli-args.js +25 -0
  83. package/dist/lib/cli-args.js.map +1 -0
  84. package/dist/lib/cookies.d.ts +31 -0
  85. package/dist/lib/cookies.d.ts.map +1 -0
  86. package/dist/lib/cookies.js +173 -0
  87. package/dist/lib/cookies.js.map +1 -0
  88. package/dist/lib/extract-bookmark-folder-id.d.ts +2 -0
  89. package/dist/lib/extract-bookmark-folder-id.d.ts.map +1 -0
  90. package/dist/lib/extract-bookmark-folder-id.js +20 -0
  91. package/dist/lib/extract-bookmark-folder-id.js.map +1 -0
  92. package/dist/lib/extract-list-id.d.ts +2 -0
  93. package/dist/lib/extract-list-id.d.ts.map +1 -0
  94. package/dist/lib/extract-list-id.js +19 -0
  95. package/dist/lib/extract-list-id.js.map +1 -0
  96. package/dist/lib/extract-tweet-id.d.ts +2 -0
  97. package/dist/lib/extract-tweet-id.d.ts.map +1 -0
  98. package/dist/lib/extract-tweet-id.js +14 -0
  99. package/dist/lib/extract-tweet-id.js.map +1 -0
  100. package/dist/lib/features.json +17 -0
  101. package/dist/lib/index.d.ts +10 -0
  102. package/dist/lib/index.d.ts.map +1 -0
  103. package/dist/lib/index.js +4 -0
  104. package/dist/lib/index.js.map +1 -0
  105. package/dist/lib/normalize-handle.d.ts +6 -0
  106. package/dist/lib/normalize-handle.d.ts.map +1 -0
  107. package/dist/lib/normalize-handle.js +31 -0
  108. package/dist/lib/normalize-handle.js.map +1 -0
  109. package/dist/lib/output.d.ts +29 -0
  110. package/dist/lib/output.d.ts.map +1 -0
  111. package/dist/lib/output.js +88 -0
  112. package/dist/lib/output.js.map +1 -0
  113. package/dist/lib/paginate-cursor.d.ts +27 -0
  114. package/dist/lib/paginate-cursor.d.ts.map +1 -0
  115. package/dist/lib/paginate-cursor.js +37 -0
  116. package/dist/lib/paginate-cursor.js.map +1 -0
  117. package/dist/lib/query-ids.json +20 -0
  118. package/dist/lib/runtime-features.d.ts +19 -0
  119. package/dist/lib/runtime-features.d.ts.map +1 -0
  120. package/dist/lib/runtime-features.js +151 -0
  121. package/dist/lib/runtime-features.js.map +1 -0
  122. package/dist/lib/runtime-query-ids.d.ts +33 -0
  123. package/dist/lib/runtime-query-ids.d.ts.map +1 -0
  124. package/dist/lib/runtime-query-ids.js +264 -0
  125. package/dist/lib/runtime-query-ids.js.map +1 -0
  126. package/dist/lib/thread-filters.d.ts +8 -0
  127. package/dist/lib/thread-filters.d.ts.map +1 -0
  128. package/dist/lib/thread-filters.js +124 -0
  129. package/dist/lib/thread-filters.js.map +1 -0
  130. package/dist/lib/twitter-client-base.d.ts +38 -0
  131. package/dist/lib/twitter-client-base.d.ts.map +1 -0
  132. package/dist/lib/twitter-client-base.js +129 -0
  133. package/dist/lib/twitter-client-base.js.map +1 -0
  134. package/dist/lib/twitter-client-bookmarks.d.ts +7 -0
  135. package/dist/lib/twitter-client-bookmarks.d.ts.map +1 -0
  136. package/dist/lib/twitter-client-bookmarks.js +61 -0
  137. package/dist/lib/twitter-client-bookmarks.js.map +1 -0
  138. package/dist/lib/twitter-client-constants.d.ts +44 -0
  139. package/dist/lib/twitter-client-constants.d.ts.map +1 -0
  140. package/dist/lib/twitter-client-constants.js +51 -0
  141. package/dist/lib/twitter-client-constants.js.map +1 -0
  142. package/dist/lib/twitter-client-engagement.d.ts +16 -0
  143. package/dist/lib/twitter-client-engagement.d.ts.map +1 -0
  144. package/dist/lib/twitter-client-engagement.js +81 -0
  145. package/dist/lib/twitter-client-engagement.js.map +1 -0
  146. package/dist/lib/twitter-client-features.d.ts +14 -0
  147. package/dist/lib/twitter-client-features.d.ts.map +1 -0
  148. package/dist/lib/twitter-client-features.js +347 -0
  149. package/dist/lib/twitter-client-features.js.map +1 -0
  150. package/dist/lib/twitter-client-follow.d.ts +8 -0
  151. package/dist/lib/twitter-client-follow.d.ts.map +1 -0
  152. package/dist/lib/twitter-client-follow.js +178 -0
  153. package/dist/lib/twitter-client-follow.js.map +1 -0
  154. package/dist/lib/twitter-client-home.d.ts +13 -0
  155. package/dist/lib/twitter-client-home.d.ts.map +1 -0
  156. package/dist/lib/twitter-client-home.js +138 -0
  157. package/dist/lib/twitter-client-home.js.map +1 -0
  158. package/dist/lib/twitter-client-lists.d.ts +12 -0
  159. package/dist/lib/twitter-client-lists.d.ts.map +1 -0
  160. package/dist/lib/twitter-client-lists.js +390 -0
  161. package/dist/lib/twitter-client-lists.js.map +1 -0
  162. package/dist/lib/twitter-client-media.d.ts +11 -0
  163. package/dist/lib/twitter-client-media.d.ts.map +1 -0
  164. package/dist/lib/twitter-client-media.js +136 -0
  165. package/dist/lib/twitter-client-media.js.map +1 -0
  166. package/dist/lib/twitter-client-news.d.ts +47 -0
  167. package/dist/lib/twitter-client-news.d.ts.map +1 -0
  168. package/dist/lib/twitter-client-news.js +283 -0
  169. package/dist/lib/twitter-client-news.js.map +1 -0
  170. package/dist/lib/twitter-client-posting.d.ts +8 -0
  171. package/dist/lib/twitter-client-posting.d.ts.map +1 -0
  172. package/dist/lib/twitter-client-posting.js +218 -0
  173. package/dist/lib/twitter-client-posting.js.map +1 -0
  174. package/dist/lib/twitter-client-search.d.ts +19 -0
  175. package/dist/lib/twitter-client-search.d.ts.map +1 -0
  176. package/dist/lib/twitter-client-search.js +157 -0
  177. package/dist/lib/twitter-client-search.js.map +1 -0
  178. package/dist/lib/twitter-client-timelines.d.ts +23 -0
  179. package/dist/lib/twitter-client-timelines.d.ts.map +1 -0
  180. package/dist/lib/twitter-client-timelines.js +471 -0
  181. package/dist/lib/twitter-client-timelines.js.map +1 -0
  182. package/dist/lib/twitter-client-tweet-detail.d.ts +25 -0
  183. package/dist/lib/twitter-client-tweet-detail.d.ts.map +1 -0
  184. package/dist/lib/twitter-client-tweet-detail.js +295 -0
  185. package/dist/lib/twitter-client-tweet-detail.js.map +1 -0
  186. package/dist/lib/twitter-client-types.d.ts +407 -0
  187. package/dist/lib/twitter-client-types.d.ts.map +1 -0
  188. package/dist/lib/twitter-client-types.js +2 -0
  189. package/dist/lib/twitter-client-types.js.map +1 -0
  190. package/dist/lib/twitter-client-user-lookup.d.ts +16 -0
  191. package/dist/lib/twitter-client-user-lookup.d.ts.map +1 -0
  192. package/dist/lib/twitter-client-user-lookup.js +224 -0
  193. package/dist/lib/twitter-client-user-lookup.js.map +1 -0
  194. package/dist/lib/twitter-client-user-tweets.d.ts +22 -0
  195. package/dist/lib/twitter-client-user-tweets.d.ts.map +1 -0
  196. package/dist/lib/twitter-client-user-tweets.js +154 -0
  197. package/dist/lib/twitter-client-user-tweets.js.map +1 -0
  198. package/dist/lib/twitter-client-users.d.ts +9 -0
  199. package/dist/lib/twitter-client-users.d.ts.map +1 -0
  200. package/dist/lib/twitter-client-users.js +358 -0
  201. package/dist/lib/twitter-client-users.js.map +1 -0
  202. package/dist/lib/twitter-client-utils.d.ts +173 -0
  203. package/dist/lib/twitter-client-utils.d.ts.map +1 -0
  204. package/dist/lib/twitter-client-utils.js +511 -0
  205. package/dist/lib/twitter-client-utils.js.map +1 -0
  206. package/dist/lib/twitter-client.d.ts +23 -0
  207. package/dist/lib/twitter-client.d.ts.map +1 -0
  208. package/dist/lib/twitter-client.js +21 -0
  209. package/dist/lib/twitter-client.js.map +1 -0
  210. package/dist/lib/version.d.ts +6 -0
  211. package/dist/lib/version.d.ts.map +1 -0
  212. package/dist/lib/version.js +174 -0
  213. package/dist/lib/version.js.map +1 -0
  214. package/package.json +61 -0
@@ -0,0 +1,390 @@
1
+ // ABOUTME: Mixin for Twitter Lists GraphQL operations.
2
+ // ABOUTME: Provides methods to fetch user's owned lists, memberships, and list timelines.
3
+ import { TWITTER_API_BASE } from './twitter-client-constants.js';
4
+ import { buildListsFeatures } from './twitter-client-features.js';
5
+ import { extractCursorFromInstructions, parseTweetsFromInstructions, parseUsersFromInstructions } from './twitter-client-utils.js';
6
+ function parseList(listResult) {
7
+ if (!listResult.id_str || !listResult.name) {
8
+ return null;
9
+ }
10
+ const owner = listResult.user_results?.result;
11
+ return {
12
+ id: listResult.id_str,
13
+ name: listResult.name,
14
+ description: listResult.description,
15
+ memberCount: listResult.member_count,
16
+ subscriberCount: listResult.subscriber_count,
17
+ isPrivate: listResult.mode?.toLowerCase() === 'private',
18
+ createdAt: listResult.created_at,
19
+ owner: owner
20
+ ? {
21
+ id: owner.rest_id ?? '',
22
+ username: owner.legacy?.screen_name ?? '',
23
+ name: owner.legacy?.name ?? '',
24
+ }
25
+ : undefined,
26
+ };
27
+ }
28
+ function parseListsFromInstructions(instructions) {
29
+ const lists = [];
30
+ if (!instructions) {
31
+ return lists;
32
+ }
33
+ for (const instruction of instructions) {
34
+ if (!instruction.entries) {
35
+ continue;
36
+ }
37
+ for (const entry of instruction.entries) {
38
+ const listResult = entry.content?.itemContent?.list;
39
+ if (listResult) {
40
+ const parsed = parseList(listResult);
41
+ if (parsed) {
42
+ lists.push(parsed);
43
+ }
44
+ }
45
+ }
46
+ }
47
+ return lists;
48
+ }
49
+ export function withLists(Base) {
50
+ class TwitterClientLists extends Base {
51
+ // biome-ignore lint/complexity/noUselessConstructor lint/suspicious/noExplicitAny: TS mixin constructor requirement.
52
+ constructor(...args) {
53
+ super(...args);
54
+ }
55
+ async getListOwnershipsQueryIds() {
56
+ const primary = await this.getQueryId('ListOwnerships');
57
+ return Array.from(new Set([primary, 'wQcOSjSQ8NtgxIwvYl1lMg']));
58
+ }
59
+ async getListMembershipsQueryIds() {
60
+ const primary = await this.getQueryId('ListMemberships');
61
+ return Array.from(new Set([primary, 'BlEXXdARdSeL_0KyKHHvvg']));
62
+ }
63
+ async getListTimelineQueryIds() {
64
+ const primary = await this.getQueryId('ListLatestTweetsTimeline');
65
+ return Array.from(new Set([primary, '2TemLyqrMpTeAmysdbnVqw']));
66
+ }
67
+ async getListMembersQueryIds() {
68
+ const primary = await this.getQueryId('ListMembers');
69
+ return Array.from(new Set([primary, 'W-XE1M2yQGiNqSVr5xigKA']));
70
+ }
71
+ /**
72
+ * Get lists owned by the authenticated user
73
+ */
74
+ async getOwnedLists(count = 100) {
75
+ const userResult = await this.getCurrentUser();
76
+ if (!userResult.success || !userResult.user) {
77
+ return { success: false, error: userResult.error ?? 'Could not determine current user' };
78
+ }
79
+ const variables = {
80
+ userId: userResult.user.id,
81
+ count,
82
+ isListMembershipShown: true,
83
+ isListMemberTargetUserId: userResult.user.id,
84
+ };
85
+ const features = buildListsFeatures();
86
+ const params = new URLSearchParams({
87
+ variables: JSON.stringify(variables),
88
+ features: JSON.stringify(features),
89
+ });
90
+ const tryOnce = async () => {
91
+ let lastError;
92
+ let had404 = false;
93
+ const queryIds = await this.getListOwnershipsQueryIds();
94
+ for (const queryId of queryIds) {
95
+ const url = `${TWITTER_API_BASE}/${queryId}/ListOwnerships?${params.toString()}`;
96
+ try {
97
+ const response = await this.fetchWithTimeout(url, {
98
+ method: 'GET',
99
+ headers: this.getHeaders(),
100
+ });
101
+ if (response.status === 404) {
102
+ had404 = true;
103
+ lastError = `HTTP ${response.status}`;
104
+ continue;
105
+ }
106
+ if (!response.ok) {
107
+ const text = await response.text();
108
+ return { success: false, error: `HTTP ${response.status}: ${text.slice(0, 200)}`, had404 };
109
+ }
110
+ const data = (await response.json());
111
+ if (data.errors && data.errors.length > 0) {
112
+ return { success: false, error: data.errors.map((e) => e.message).join(', '), had404 };
113
+ }
114
+ const instructions = data.data?.user?.result?.timeline?.timeline?.instructions;
115
+ const lists = parseListsFromInstructions(instructions);
116
+ return { success: true, lists, had404 };
117
+ }
118
+ catch (error) {
119
+ lastError = error instanceof Error ? error.message : String(error);
120
+ }
121
+ }
122
+ return { success: false, error: lastError ?? 'Unknown error fetching owned lists', had404 };
123
+ };
124
+ const firstAttempt = await tryOnce();
125
+ if (firstAttempt.success) {
126
+ return { success: true, lists: firstAttempt.lists };
127
+ }
128
+ if (firstAttempt.had404) {
129
+ await this.refreshQueryIds();
130
+ const secondAttempt = await tryOnce();
131
+ if (secondAttempt.success) {
132
+ return { success: true, lists: secondAttempt.lists };
133
+ }
134
+ return { success: false, error: secondAttempt.error };
135
+ }
136
+ return { success: false, error: firstAttempt.error };
137
+ }
138
+ /**
139
+ * Get lists the authenticated user is a member of
140
+ */
141
+ async getListMemberships(count = 100) {
142
+ const userResult = await this.getCurrentUser();
143
+ if (!userResult.success || !userResult.user) {
144
+ return { success: false, error: userResult.error ?? 'Could not determine current user' };
145
+ }
146
+ const variables = {
147
+ userId: userResult.user.id,
148
+ count,
149
+ isListMembershipShown: true,
150
+ isListMemberTargetUserId: userResult.user.id,
151
+ };
152
+ const features = buildListsFeatures();
153
+ const params = new URLSearchParams({
154
+ variables: JSON.stringify(variables),
155
+ features: JSON.stringify(features),
156
+ });
157
+ const tryOnce = async () => {
158
+ let lastError;
159
+ let had404 = false;
160
+ const queryIds = await this.getListMembershipsQueryIds();
161
+ for (const queryId of queryIds) {
162
+ const url = `${TWITTER_API_BASE}/${queryId}/ListMemberships?${params.toString()}`;
163
+ try {
164
+ const response = await this.fetchWithTimeout(url, {
165
+ method: 'GET',
166
+ headers: this.getHeaders(),
167
+ });
168
+ if (response.status === 404) {
169
+ had404 = true;
170
+ lastError = `HTTP ${response.status}`;
171
+ continue;
172
+ }
173
+ if (!response.ok) {
174
+ const text = await response.text();
175
+ return { success: false, error: `HTTP ${response.status}: ${text.slice(0, 200)}`, had404 };
176
+ }
177
+ const data = (await response.json());
178
+ if (data.errors && data.errors.length > 0) {
179
+ return { success: false, error: data.errors.map((e) => e.message).join(', '), had404 };
180
+ }
181
+ const instructions = data.data?.user?.result?.timeline?.timeline?.instructions;
182
+ const lists = parseListsFromInstructions(instructions);
183
+ return { success: true, lists, had404 };
184
+ }
185
+ catch (error) {
186
+ lastError = error instanceof Error ? error.message : String(error);
187
+ }
188
+ }
189
+ return { success: false, error: lastError ?? 'Unknown error fetching list memberships', had404 };
190
+ };
191
+ const firstAttempt = await tryOnce();
192
+ if (firstAttempt.success) {
193
+ return { success: true, lists: firstAttempt.lists };
194
+ }
195
+ if (firstAttempt.had404) {
196
+ await this.refreshQueryIds();
197
+ const secondAttempt = await tryOnce();
198
+ if (secondAttempt.success) {
199
+ return { success: true, lists: secondAttempt.lists };
200
+ }
201
+ return { success: false, error: secondAttempt.error };
202
+ }
203
+ return { success: false, error: firstAttempt.error };
204
+ }
205
+ /**
206
+ * Get tweets from a list timeline
207
+ */
208
+ async getListTimeline(listId, count = 20, options = {}) {
209
+ return this.getListTimelinePaged(listId, count, options);
210
+ }
211
+ /**
212
+ * Get all tweets from a list timeline (paginated)
213
+ */
214
+ async getAllListTimeline(listId, options) {
215
+ return this.getListTimelinePaged(listId, Number.POSITIVE_INFINITY, options);
216
+ }
217
+ /**
218
+ * Internal paginated list timeline fetcher
219
+ */
220
+ async getListTimelinePaged(listId, limit, options = {}) {
221
+ const features = buildListsFeatures();
222
+ const pageSize = 20;
223
+ const seen = new Set();
224
+ const tweets = [];
225
+ let cursor = options.cursor;
226
+ let nextCursor;
227
+ let pagesFetched = 0;
228
+ const { includeRaw = false, maxPages } = options;
229
+ const fetchPage = async (pageCount, pageCursor) => {
230
+ let lastError;
231
+ let had404 = false;
232
+ const queryIds = await this.getListTimelineQueryIds();
233
+ const variables = {
234
+ listId,
235
+ count: pageCount,
236
+ ...(pageCursor ? { cursor: pageCursor } : {}),
237
+ };
238
+ const params = new URLSearchParams({
239
+ variables: JSON.stringify(variables),
240
+ features: JSON.stringify(features),
241
+ });
242
+ for (const queryId of queryIds) {
243
+ const url = `${TWITTER_API_BASE}/${queryId}/ListLatestTweetsTimeline?${params.toString()}`;
244
+ try {
245
+ const response = await this.fetchWithTimeout(url, {
246
+ method: 'GET',
247
+ headers: this.getHeaders(),
248
+ });
249
+ if (response.status === 404) {
250
+ had404 = true;
251
+ lastError = `HTTP ${response.status}`;
252
+ continue;
253
+ }
254
+ if (!response.ok) {
255
+ const text = await response.text();
256
+ return { success: false, error: `HTTP ${response.status}: ${text.slice(0, 200)}`, had404 };
257
+ }
258
+ const data = (await response.json());
259
+ if (data.errors && data.errors.length > 0) {
260
+ return { success: false, error: data.errors.map((e) => e.message).join(', '), had404 };
261
+ }
262
+ const instructions = data.data?.list?.tweets_timeline?.timeline?.instructions;
263
+ const pageTweets = parseTweetsFromInstructions(instructions, { quoteDepth: this.quoteDepth, includeRaw });
264
+ const nextCursor = extractCursorFromInstructions(instructions);
265
+ return { success: true, tweets: pageTweets, cursor: nextCursor, had404 };
266
+ }
267
+ catch (error) {
268
+ lastError = error instanceof Error ? error.message : String(error);
269
+ }
270
+ }
271
+ return { success: false, error: lastError ?? 'Unknown error fetching list timeline', had404 };
272
+ };
273
+ const fetchWithRefresh = async (pageCount, pageCursor) => {
274
+ const firstAttempt = await fetchPage(pageCount, pageCursor);
275
+ if (firstAttempt.success) {
276
+ return firstAttempt;
277
+ }
278
+ if (firstAttempt.had404) {
279
+ await this.refreshQueryIds();
280
+ const secondAttempt = await fetchPage(pageCount, pageCursor);
281
+ if (secondAttempt.success) {
282
+ return secondAttempt;
283
+ }
284
+ return { success: false, error: secondAttempt.error };
285
+ }
286
+ return { success: false, error: firstAttempt.error };
287
+ };
288
+ const unlimited = limit === Number.POSITIVE_INFINITY;
289
+ while (unlimited || tweets.length < limit) {
290
+ const pageCount = unlimited ? pageSize : Math.min(pageSize, limit - tweets.length);
291
+ const page = await fetchWithRefresh(pageCount, cursor);
292
+ if (!page.success) {
293
+ return { success: false, error: page.error };
294
+ }
295
+ pagesFetched += 1;
296
+ let added = 0;
297
+ for (const tweet of page.tweets) {
298
+ if (seen.has(tweet.id)) {
299
+ continue;
300
+ }
301
+ seen.add(tweet.id);
302
+ tweets.push(tweet);
303
+ added += 1;
304
+ if (!unlimited && tweets.length >= limit) {
305
+ break;
306
+ }
307
+ }
308
+ const pageCursor = page.cursor;
309
+ if (!pageCursor || pageCursor === cursor || page.tweets.length === 0 || added === 0) {
310
+ nextCursor = undefined;
311
+ break;
312
+ }
313
+ if (maxPages && pagesFetched >= maxPages) {
314
+ nextCursor = pageCursor;
315
+ break;
316
+ }
317
+ cursor = pageCursor;
318
+ nextCursor = pageCursor;
319
+ }
320
+ return { success: true, tweets, nextCursor };
321
+ }
322
+ /**
323
+ * Get members of a list
324
+ */
325
+ async getListMembers(listId, count = 20, cursor) {
326
+ const variables = {
327
+ listId,
328
+ count,
329
+ };
330
+ if (cursor) {
331
+ variables.cursor = cursor;
332
+ }
333
+ const features = buildListsFeatures();
334
+ const params = new URLSearchParams({
335
+ variables: JSON.stringify(variables),
336
+ features: JSON.stringify(features),
337
+ });
338
+ const tryOnce = async () => {
339
+ let lastError;
340
+ let had404 = false;
341
+ const queryIds = await this.getListMembersQueryIds();
342
+ for (const queryId of queryIds) {
343
+ const url = `${TWITTER_API_BASE}/${queryId}/ListMembers?${params.toString()}`;
344
+ try {
345
+ const response = await this.fetchWithTimeout(url, {
346
+ method: 'GET',
347
+ headers: this.getHeaders(),
348
+ });
349
+ if (response.status === 404) {
350
+ had404 = true;
351
+ lastError = `HTTP ${response.status}`;
352
+ continue;
353
+ }
354
+ if (!response.ok) {
355
+ const text = await response.text();
356
+ return { success: false, error: `HTTP ${response.status}: ${text.slice(0, 200)}`, had404 };
357
+ }
358
+ const data = (await response.json());
359
+ if (data.errors && data.errors.length > 0) {
360
+ return { success: false, error: data.errors.map((e) => e.message).join(', '), had404 };
361
+ }
362
+ const instructions = data.data?.list?.members_timeline?.timeline?.instructions;
363
+ const users = parseUsersFromInstructions(instructions);
364
+ const nextCursor = extractCursorFromInstructions(instructions);
365
+ return { success: true, users, nextCursor, had404 };
366
+ }
367
+ catch (error) {
368
+ lastError = error instanceof Error ? error.message : String(error);
369
+ }
370
+ }
371
+ return { success: false, error: lastError ?? 'Unknown error fetching list members', had404 };
372
+ };
373
+ const firstAttempt = await tryOnce();
374
+ if (firstAttempt.success) {
375
+ return { success: true, users: firstAttempt.users, nextCursor: firstAttempt.nextCursor };
376
+ }
377
+ if (firstAttempt.had404) {
378
+ await this.refreshQueryIds();
379
+ const secondAttempt = await tryOnce();
380
+ if (secondAttempt.success) {
381
+ return { success: true, users: secondAttempt.users, nextCursor: secondAttempt.nextCursor };
382
+ }
383
+ return { success: false, error: secondAttempt.error };
384
+ }
385
+ return { success: false, error: firstAttempt.error };
386
+ }
387
+ }
388
+ return TwitterClientLists;
389
+ }
390
+ //# sourceMappingURL=twitter-client-lists.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"twitter-client-lists.js","sourceRoot":"","sources":["../../src/lib/twitter-client-lists.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,11 @@
1
+ import type { AbstractConstructor, Mixin, TwitterClientBase } from './twitter-client-base.js';
2
+ import type { UploadMediaResult } from './twitter-client-types.js';
3
+ export interface TwitterClientMediaMethods {
4
+ uploadMedia(input: {
5
+ data: Uint8Array;
6
+ mimeType: string;
7
+ alt?: string;
8
+ }): Promise<UploadMediaResult>;
9
+ }
10
+ export declare function withMedia<TBase extends AbstractConstructor<TwitterClientBase>>(Base: TBase): Mixin<TBase, TwitterClientMediaMethods>;
11
+ //# sourceMappingURL=twitter-client-media.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"twitter-client-media.d.ts","sourceRoot":"","sources":["../../src/lib/twitter-client-media.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE9F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,MAAM,WAAW,yBAAyB;IACxC,WAAW,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACtG;AAED,wBAAgB,SAAS,CAAC,KAAK,SAAS,mBAAmB,CAAC,iBAAiB,CAAC,EAC5E,IAAI,EAAE,KAAK,GACV,KAAK,CAAC,KAAK,EAAE,yBAAyB,CAAC,CAoKzC"}
@@ -0,0 +1,136 @@
1
+ import { TWITTER_MEDIA_METADATA_URL, TWITTER_UPLOAD_URL } from './twitter-client-constants.js';
2
+ export function withMedia(Base) {
3
+ class TwitterClientMedia extends Base {
4
+ // biome-ignore lint/complexity/noUselessConstructor lint/suspicious/noExplicitAny: TS mixin constructor requirement.
5
+ constructor(...args) {
6
+ super(...args);
7
+ }
8
+ mediaCategoryForMime(mimeType) {
9
+ if (mimeType.startsWith('image/')) {
10
+ if (mimeType === 'image/gif') {
11
+ return 'tweet_gif';
12
+ }
13
+ return 'tweet_image';
14
+ }
15
+ if (mimeType.startsWith('video/')) {
16
+ return 'tweet_video';
17
+ }
18
+ return null;
19
+ }
20
+ async uploadMedia(input) {
21
+ const category = this.mediaCategoryForMime(input.mimeType);
22
+ if (!category) {
23
+ return { success: false, error: `Unsupported media type: ${input.mimeType}` };
24
+ }
25
+ try {
26
+ const initParams = new URLSearchParams({
27
+ command: 'INIT',
28
+ total_bytes: String(input.data.byteLength),
29
+ media_type: input.mimeType,
30
+ media_category: category,
31
+ });
32
+ const initResp = await this.fetchWithTimeout(TWITTER_UPLOAD_URL, {
33
+ method: 'POST',
34
+ headers: this.getUploadHeaders(),
35
+ body: initParams,
36
+ });
37
+ if (!initResp.ok) {
38
+ const text = await initResp.text();
39
+ return { success: false, error: `HTTP ${initResp.status}: ${text.slice(0, 200)}` };
40
+ }
41
+ const initBody = (await initResp.json());
42
+ const mediaId = typeof initBody.media_id_string === 'string'
43
+ ? initBody.media_id_string
44
+ : initBody.media_id !== undefined
45
+ ? String(initBody.media_id)
46
+ : undefined;
47
+ if (!mediaId) {
48
+ return { success: false, error: 'Media upload INIT did not return media_id' };
49
+ }
50
+ const chunkSize = 5 * 1024 * 1024;
51
+ let segmentIndex = 0;
52
+ for (let offset = 0; offset < input.data.byteLength; offset += chunkSize) {
53
+ const chunk = input.data.slice(offset, Math.min(input.data.byteLength, offset + chunkSize));
54
+ const form = new FormData();
55
+ form.set('command', 'APPEND');
56
+ form.set('media_id', mediaId);
57
+ form.set('segment_index', String(segmentIndex));
58
+ form.set('media', new Blob([chunk], { type: input.mimeType }), 'media');
59
+ const appendResp = await this.fetchWithTimeout(TWITTER_UPLOAD_URL, {
60
+ method: 'POST',
61
+ headers: this.getUploadHeaders(),
62
+ body: form,
63
+ });
64
+ if (!appendResp.ok) {
65
+ const text = await appendResp.text();
66
+ return { success: false, error: `HTTP ${appendResp.status}: ${text.slice(0, 200)}` };
67
+ }
68
+ segmentIndex += 1;
69
+ }
70
+ const finalizeParams = new URLSearchParams({ command: 'FINALIZE', media_id: mediaId });
71
+ const finalizeResp = await this.fetchWithTimeout(TWITTER_UPLOAD_URL, {
72
+ method: 'POST',
73
+ headers: this.getUploadHeaders(),
74
+ body: finalizeParams,
75
+ });
76
+ if (!finalizeResp.ok) {
77
+ const text = await finalizeResp.text();
78
+ return { success: false, error: `HTTP ${finalizeResp.status}: ${text.slice(0, 200)}` };
79
+ }
80
+ const finalizeBody = (await finalizeResp.json());
81
+ const info = finalizeBody.processing_info;
82
+ if (info?.state && info.state !== 'succeeded') {
83
+ let attempts = 0;
84
+ while (attempts < 20) {
85
+ if (info.state === 'failed') {
86
+ const msg = info.error?.message || info.error?.name || 'Media processing failed';
87
+ return { success: false, error: msg };
88
+ }
89
+ const delaySecs = Number.isFinite(info.check_after_secs) ? Math.max(1, info.check_after_secs) : 2;
90
+ await this.sleep(delaySecs * 1000);
91
+ const statusUrl = `${TWITTER_UPLOAD_URL}?${new URLSearchParams({
92
+ command: 'STATUS',
93
+ media_id: mediaId,
94
+ }).toString()}`;
95
+ const statusResp = await this.fetchWithTimeout(statusUrl, {
96
+ method: 'GET',
97
+ headers: this.getUploadHeaders(),
98
+ });
99
+ if (!statusResp.ok) {
100
+ const text = await statusResp.text();
101
+ return { success: false, error: `HTTP ${statusResp.status}: ${text.slice(0, 200)}` };
102
+ }
103
+ const statusBody = (await statusResp.json());
104
+ if (!statusBody.processing_info) {
105
+ break;
106
+ }
107
+ info.state = statusBody.processing_info.state;
108
+ info.check_after_secs = statusBody.processing_info.check_after_secs;
109
+ info.error = statusBody.processing_info.error;
110
+ if (info.state === 'succeeded') {
111
+ break;
112
+ }
113
+ attempts += 1;
114
+ }
115
+ }
116
+ if (input.alt && input.mimeType.startsWith('image/')) {
117
+ const metaResp = await this.fetchWithTimeout(TWITTER_MEDIA_METADATA_URL, {
118
+ method: 'POST',
119
+ headers: this.getJsonHeaders(),
120
+ body: JSON.stringify({ media_id: mediaId, alt_text: { text: input.alt } }),
121
+ });
122
+ if (!metaResp.ok) {
123
+ const text = await metaResp.text();
124
+ return { success: false, error: `HTTP ${metaResp.status}: ${text.slice(0, 200)}` };
125
+ }
126
+ }
127
+ return { success: true, mediaId };
128
+ }
129
+ catch (error) {
130
+ return { success: false, error: error instanceof Error ? error.message : String(error) };
131
+ }
132
+ }
133
+ }
134
+ return TwitterClientMedia;
135
+ }
136
+ //# sourceMappingURL=twitter-client-media.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"twitter-client-media.js","sourceRoot":"","sources":["../../src/lib/twitter-client-media.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAO/F,MAAM,UAAU,SAAS,CACvB,IAAW;IAEX,MAAe,kBAAmB,SAAQ,IAAI;QAC5C,qHAAqH;QACrH,YAAY,GAAG,IAAW;YACxB,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;QACjB,CAAC;QAEO,oBAAoB,CAAC,QAAgB;YAC3C,IAAI,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAClC,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;oBAC7B,OAAO,WAAW,CAAC;gBACrB,CAAC;gBACD,OAAO,aAAa,CAAC;YACvB,CAAC;YACD,IAAI,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAClC,OAAO,aAAa,CAAC;YACvB,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,KAAK,CAAC,WAAW,CAAC,KAA2D;YAC3E,MAAM,QAAQ,GAAG,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAC3D,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,2BAA2B,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC;YAChF,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,IAAI,eAAe,CAAC;oBACrC,OAAO,EAAE,MAAM;oBACf,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC;oBAC1C,UAAU,EAAE,KAAK,CAAC,QAAQ;oBAC1B,cAAc,EAAE,QAAQ;iBACzB,CAAC,CAAC;gBAEH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,kBAAkB,EAAE;oBAC/D,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE,IAAI,CAAC,gBAAgB,EAAE;oBAChC,IAAI,EAAE,UAAU;iBACjB,CAAC,CAAC;gBAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;oBACnC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,QAAQ,CAAC,MAAM,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC;gBACrF,CAAC;gBAED,MAAM,QAAQ,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA6D,CAAC;gBACrG,MAAM,OAAO,GACX,OAAO,QAAQ,CAAC,eAAe,KAAK,QAAQ;oBAC1C,CAAC,CAAC,QAAQ,CAAC,eAAe;oBAC1B,CAAC,CAAC,QAAQ,CAAC,QAAQ,KAAK,SAAS;wBAC/B,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;wBAC3B,CAAC,CAAC,SAAS,CAAC;gBAClB,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,2CAA2C,EAAE,CAAC;gBAChF,CAAC;gBAED,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;gBAClC,IAAI,YAAY,GAAG,CAAC,CAAC;gBACrB,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,IAAI,SAAS,EAAE,CAAC;oBACzE,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;oBAC5F,MAAM,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;oBAC5B,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;oBAC9B,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;oBAC9B,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC;oBAChD,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,IAAI,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;oBAExE,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,kBAAkB,EAAE;wBACjE,MAAM,EAAE,MAAM;wBACd,OAAO,EAAE,IAAI,CAAC,gBAAgB,EAAE;wBAChC,IAAI,EAAE,IAAI;qBACX,CAAC,CAAC;oBAEH,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC;wBACnB,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,IAAI,EAAE,CAAC;wBACrC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,UAAU,CAAC,MAAM,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC;oBACvF,CAAC;oBACD,YAAY,IAAI,CAAC,CAAC;gBACpB,CAAC;gBAED,MAAM,cAAc,GAAG,IAAI,eAAe,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;gBACvF,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,kBAAkB,EAAE;oBACnE,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE,IAAI,CAAC,gBAAgB,EAAE;oBAChC,IAAI,EAAE,cAAc;iBACrB,CAAC,CAAC;gBAEH,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,CAAC;oBACrB,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,CAAC;oBACvC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,YAAY,CAAC,MAAM,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC;gBACzF,CAAC;gBAED,MAAM,YAAY,GAAG,CAAC,MAAM,YAAY,CAAC,IAAI,EAAE,CAM9C,CAAC;gBAEF,MAAM,IAAI,GAAG,YAAY,CAAC,eAAe,CAAC;gBAC1C,IAAI,IAAI,EAAE,KAAK,IAAI,IAAI,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;oBAC9C,IAAI,QAAQ,GAAG,CAAC,CAAC;oBACjB,OAAO,QAAQ,GAAG,EAAE,EAAE,CAAC;wBACrB,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;4BAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,OAAO,IAAI,IAAI,CAAC,KAAK,EAAE,IAAI,IAAI,yBAAyB,CAAC;4BACjF,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;wBACxC,CAAC;wBACD,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,gBAA0B,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;wBAC5G,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;wBAEnC,MAAM,SAAS,GAAG,GAAG,kBAAkB,IAAI,IAAI,eAAe,CAAC;4BAC7D,OAAO,EAAE,QAAQ;4BACjB,QAAQ,EAAE,OAAO;yBAClB,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC;wBAChB,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,SAAS,EAAE;4BACxD,MAAM,EAAE,KAAK;4BACb,OAAO,EAAE,IAAI,CAAC,gBAAgB,EAAE;yBACjC,CAAC,CAAC;wBAEH,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC;4BACnB,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,IAAI,EAAE,CAAC;4BACrC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,UAAU,CAAC,MAAM,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC;wBACvF,CAAC;wBAED,MAAM,UAAU,GAAG,CAAC,MAAM,UAAU,CAAC,IAAI,EAAE,CAM1C,CAAC;wBACF,IAAI,CAAC,UAAU,CAAC,eAAe,EAAE,CAAC;4BAChC,MAAM;wBACR,CAAC;wBACD,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,eAAe,CAAC,KAAK,CAAC;wBAC9C,IAAI,CAAC,gBAAgB,GAAG,UAAU,CAAC,eAAe,CAAC,gBAAgB,CAAC;wBACpE,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,eAAe,CAAC,KAAK,CAAC;wBAC9C,IAAI,IAAI,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;4BAC/B,MAAM;wBACR,CAAC;wBACD,QAAQ,IAAI,CAAC,CAAC;oBAChB,CAAC;gBACH,CAAC;gBAED,IAAI,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;oBACrD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,0BAA0B,EAAE;wBACvE,MAAM,EAAE,MAAM;wBACd,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE;wBAC9B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC;qBAC3E,CAAC,CAAC;oBACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;wBACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;wBACnC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,QAAQ,CAAC,MAAM,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC;oBACrF,CAAC;gBACH,CAAC;gBAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;YACpC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3F,CAAC;QACH,CAAC;KACF;IAED,OAAO,kBAAkB,CAAC;AAC5B,CAAC"}
@@ -0,0 +1,47 @@
1
+ import type { AbstractConstructor, Mixin, TwitterClientBase } from './twitter-client-base.js';
2
+ import type { TweetData } from './twitter-client-types.js';
3
+ declare const TIMELINE_IDS: {
4
+ readonly forYou: "VGltZWxpbmU6DAC2CwABAAAAB2Zvcl95b3UAAA==";
5
+ readonly trending: "VGltZWxpbmU6DAC2CwABAAAACHRyZW5kaW5nAAA=";
6
+ readonly news: "VGltZWxpbmU6DAC2CwABAAAABG5ld3MAAA==";
7
+ readonly sports: "VGltZWxpbmU6DAC2CwABAAAABnNwb3J0cwAA";
8
+ readonly entertainment: "VGltZWxpbmU6DAC2CwABAAAADWVudGVydGFpbm1lbnQAAA==";
9
+ };
10
+ export type ExploreTab = keyof typeof TIMELINE_IDS;
11
+ /** Options for news fetch methods */
12
+ export interface NewsFetchOptions {
13
+ /** Include raw GraphQL response in `_raw` field */
14
+ includeRaw?: boolean;
15
+ /** Also fetch related tweets for each news item */
16
+ withTweets?: boolean;
17
+ /** Number of tweets to fetch per news item (default: 5) */
18
+ tweetsPerItem?: number;
19
+ /** Filter to show only AI-curated news items */
20
+ aiOnly?: boolean;
21
+ /** Fetch from specific tabs only (default: all tabs) */
22
+ tabs?: ExploreTab[];
23
+ }
24
+ export interface NewsItem {
25
+ id: string;
26
+ headline: string;
27
+ category?: string;
28
+ timeAgo?: string;
29
+ postCount?: number;
30
+ description?: string;
31
+ url?: string;
32
+ tweets?: TweetData[];
33
+ _raw?: any;
34
+ }
35
+ export type NewsResult = {
36
+ success: true;
37
+ items: NewsItem[];
38
+ } | {
39
+ success: false;
40
+ error: string;
41
+ };
42
+ export interface TwitterClientNewsMethods {
43
+ getNews(count?: number, options?: NewsFetchOptions): Promise<NewsResult>;
44
+ }
45
+ export declare function withNews<TBase extends AbstractConstructor<TwitterClientBase>>(Base: TBase): Mixin<TBase, TwitterClientNewsMethods>;
46
+ export {};
47
+ //# sourceMappingURL=twitter-client-news.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"twitter-client-news.d.ts","sourceRoot":"","sources":["../../src/lib/twitter-client-news.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAG9F,OAAO,KAAK,EAAgB,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAMzE,QAAA,MAAM,YAAY;;;;;;CAMR,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,YAAY,CAAC;AAEnD,qCAAqC;AACrC,MAAM,WAAW,gBAAgB;IAC/B,mDAAmD;IACnD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,mDAAmD;IACnD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,2DAA2D;IAC3D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gDAAgD;IAChD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wDAAwD;IACxD,IAAI,CAAC,EAAE,UAAU,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IAErB,IAAI,CAAC,EAAE,GAAG,CAAC;CACZ;AAED,MAAM,MAAM,UAAU,GAClB;IACE,OAAO,EAAE,IAAI,CAAC;IACd,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB,GACD;IACE,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEN,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAC1E;AAED,wBAAgB,QAAQ,CAAC,KAAK,SAAS,mBAAmB,CAAC,iBAAiB,CAAC,EAC3E,IAAI,EAAE,KAAK,GACV,KAAK,CAAC,KAAK,EAAE,wBAAwB,CAAC,CA+WxC"}