@xcrop/sdk 0.0.0-stage → 1.0.1

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 (108) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +361 -2
  3. package/dist/cjs/client.d.ts +65 -0
  4. package/dist/cjs/client.d.ts.map +1 -0
  5. package/dist/cjs/client.js +84 -0
  6. package/dist/cjs/client.js.map +1 -0
  7. package/dist/cjs/errors.d.ts +38 -0
  8. package/dist/cjs/errors.d.ts.map +1 -0
  9. package/dist/cjs/errors.js +70 -0
  10. package/dist/cjs/errors.js.map +1 -0
  11. package/dist/cjs/http.d.ts +28 -0
  12. package/dist/cjs/http.d.ts.map +1 -0
  13. package/dist/cjs/http.js +250 -0
  14. package/dist/cjs/http.js.map +1 -0
  15. package/dist/cjs/index.d.ts +13 -0
  16. package/dist/cjs/index.d.ts.map +1 -0
  17. package/dist/cjs/index.js +36 -0
  18. package/dist/cjs/index.js.map +1 -0
  19. package/dist/cjs/package.json +3 -0
  20. package/dist/cjs/resources/account.d.ts +24 -0
  21. package/dist/cjs/resources/account.d.ts.map +1 -0
  22. package/dist/cjs/resources/account.js +54 -0
  23. package/dist/cjs/resources/account.js.map +1 -0
  24. package/dist/cjs/resources/communities.d.ts +26 -0
  25. package/dist/cjs/resources/communities.d.ts.map +1 -0
  26. package/dist/cjs/resources/communities.js +47 -0
  27. package/dist/cjs/resources/communities.js.map +1 -0
  28. package/dist/cjs/resources/lists.d.ts +24 -0
  29. package/dist/cjs/resources/lists.d.ts.map +1 -0
  30. package/dist/cjs/resources/lists.js +61 -0
  31. package/dist/cjs/resources/lists.js.map +1 -0
  32. package/dist/cjs/resources/search.d.ts +60 -0
  33. package/dist/cjs/resources/search.d.ts.map +1 -0
  34. package/dist/cjs/resources/search.js +198 -0
  35. package/dist/cjs/resources/search.js.map +1 -0
  36. package/dist/cjs/resources/stream.d.ts +45 -0
  37. package/dist/cjs/resources/stream.d.ts.map +1 -0
  38. package/dist/cjs/resources/stream.js +129 -0
  39. package/dist/cjs/resources/stream.js.map +1 -0
  40. package/dist/cjs/resources/trending.d.ts +11 -0
  41. package/dist/cjs/resources/trending.d.ts.map +1 -0
  42. package/dist/cjs/resources/trending.js +21 -0
  43. package/dist/cjs/resources/trending.js.map +1 -0
  44. package/dist/cjs/resources/tweets.d.ts +84 -0
  45. package/dist/cjs/resources/tweets.d.ts.map +1 -0
  46. package/dist/cjs/resources/tweets.js +179 -0
  47. package/dist/cjs/resources/tweets.js.map +1 -0
  48. package/dist/cjs/resources/users.d.ts +81 -0
  49. package/dist/cjs/resources/users.d.ts.map +1 -0
  50. package/dist/cjs/resources/users.js +182 -0
  51. package/dist/cjs/resources/users.js.map +1 -0
  52. package/dist/cjs/types.d.ts +256 -0
  53. package/dist/cjs/types.d.ts.map +1 -0
  54. package/dist/cjs/types.js +4 -0
  55. package/dist/cjs/types.js.map +1 -0
  56. package/dist/esm/client.d.ts +65 -0
  57. package/dist/esm/client.d.ts.map +1 -0
  58. package/dist/esm/client.js +80 -0
  59. package/dist/esm/client.js.map +1 -0
  60. package/dist/esm/errors.d.ts +38 -0
  61. package/dist/esm/errors.d.ts.map +1 -0
  62. package/dist/esm/errors.js +62 -0
  63. package/dist/esm/errors.js.map +1 -0
  64. package/dist/esm/http.d.ts +28 -0
  65. package/dist/esm/http.d.ts.map +1 -0
  66. package/dist/esm/http.js +246 -0
  67. package/dist/esm/http.js.map +1 -0
  68. package/dist/esm/index.d.ts +13 -0
  69. package/dist/esm/index.d.ts.map +1 -0
  70. package/dist/esm/index.js +16 -0
  71. package/dist/esm/index.js.map +1 -0
  72. package/dist/esm/resources/account.d.ts +24 -0
  73. package/dist/esm/resources/account.d.ts.map +1 -0
  74. package/dist/esm/resources/account.js +50 -0
  75. package/dist/esm/resources/account.js.map +1 -0
  76. package/dist/esm/resources/communities.d.ts +26 -0
  77. package/dist/esm/resources/communities.d.ts.map +1 -0
  78. package/dist/esm/resources/communities.js +43 -0
  79. package/dist/esm/resources/communities.js.map +1 -0
  80. package/dist/esm/resources/lists.d.ts +24 -0
  81. package/dist/esm/resources/lists.d.ts.map +1 -0
  82. package/dist/esm/resources/lists.js +56 -0
  83. package/dist/esm/resources/lists.js.map +1 -0
  84. package/dist/esm/resources/search.d.ts +60 -0
  85. package/dist/esm/resources/search.d.ts.map +1 -0
  86. package/dist/esm/resources/search.js +193 -0
  87. package/dist/esm/resources/search.js.map +1 -0
  88. package/dist/esm/resources/stream.d.ts +45 -0
  89. package/dist/esm/resources/stream.d.ts.map +1 -0
  90. package/dist/esm/resources/stream.js +124 -0
  91. package/dist/esm/resources/stream.js.map +1 -0
  92. package/dist/esm/resources/trending.d.ts +11 -0
  93. package/dist/esm/resources/trending.d.ts.map +1 -0
  94. package/dist/esm/resources/trending.js +17 -0
  95. package/dist/esm/resources/trending.js.map +1 -0
  96. package/dist/esm/resources/tweets.d.ts +84 -0
  97. package/dist/esm/resources/tweets.d.ts.map +1 -0
  98. package/dist/esm/resources/tweets.js +174 -0
  99. package/dist/esm/resources/tweets.js.map +1 -0
  100. package/dist/esm/resources/users.d.ts +81 -0
  101. package/dist/esm/resources/users.d.ts.map +1 -0
  102. package/dist/esm/resources/users.js +177 -0
  103. package/dist/esm/resources/users.js.map +1 -0
  104. package/dist/esm/types.d.ts +256 -0
  105. package/dist/esm/types.d.ts.map +1 -0
  106. package/dist/esm/types.js +3 -0
  107. package/dist/esm/types.js.map +1 -0
  108. package/package.json +43 -4
@@ -0,0 +1,60 @@
1
+ import type { HttpClient } from '../http.js';
2
+ import type { Tweet, User, PaginatedResponse, ApiResponse, SearchTweetsParams, SearchUsersParams } from '../types.js';
3
+ export declare class SearchResource {
4
+ private readonly http;
5
+ constructor(http: HttpClient);
6
+ /**
7
+ * Search for tweets.
8
+ */
9
+ tweets(params: SearchTweetsParams): Promise<PaginatedResponse<Tweet>>;
10
+ /**
11
+ * Search for users.
12
+ */
13
+ users(params: SearchUsersParams): Promise<ApiResponse<User[]>>;
14
+ /**
15
+ * Stream search results via SSE. Returns an EventSource-like object.
16
+ *
17
+ * Usage:
18
+ * ```ts
19
+ * const stream = client.search.stream({ query: 'bitcoin', count: 500 });
20
+ * stream.on('tweet', (tweet) => console.log(tweet));
21
+ * stream.on('done', (meta) => console.log('finished', meta));
22
+ * stream.on('error', (err) => console.error(err));
23
+ * ```
24
+ */
25
+ stream(params: Omit<SearchTweetsParams, 'stream' | 'cursor'>): SearchStream;
26
+ }
27
+ type StreamCallback<T> = (data: T) => void;
28
+ /**
29
+ * SSE stream wrapper for search results.
30
+ * Connects to the search endpoint with stream=true and emits events.
31
+ */
32
+ export declare class SearchStream {
33
+ private readonly http;
34
+ private readonly params;
35
+ private listeners;
36
+ private abortController;
37
+ private started;
38
+ constructor(http: HttpClient, params: Omit<SearchTweetsParams, 'stream' | 'cursor'>);
39
+ /**
40
+ * Register an event listener.
41
+ */
42
+ on(event: 'tweet', callback: StreamCallback<Tweet>): this;
43
+ on(event: 'done', callback: StreamCallback<Record<string, unknown>>): this;
44
+ on(event: 'error', callback: StreamCallback<Error>): this;
45
+ /**
46
+ * Remove an event listener.
47
+ */
48
+ off(event: 'tweet', callback: StreamCallback<Tweet>): this;
49
+ off(event: 'done', callback: StreamCallback<Record<string, unknown>>): this;
50
+ off(event: 'error', callback: StreamCallback<Error>): this;
51
+ /**
52
+ * Abort the stream.
53
+ */
54
+ close(): void;
55
+ private start;
56
+ private processSSELine;
57
+ private emit;
58
+ }
59
+ export {};
60
+ //# sourceMappingURL=search.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/resources/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EACV,KAAK,EACL,IAAI,EACJ,iBAAiB,EACjB,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EAElB,MAAM,aAAa,CAAC;AAErB,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAQ3E;;OAEG;IACG,KAAK,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;IAQpE;;;;;;;;;;OAUG;IACH,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,kBAAkB,EAAE,QAAQ,GAAG,QAAQ,CAAC,GAAG,YAAY;CAG5E;AAoBD,KAAK,cAAc,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;AAU3C;;;GAGG;AACH,qBAAa,YAAY;IAMrB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;IANzB,OAAO,CAAC,SAAS,CAAuD;IACxE,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,OAAO,CAAS;gBAGL,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,IAAI,CAAC,kBAAkB,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAOxE;;OAEG;IACH,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,CAAC,KAAK,CAAC,GAAG,IAAI;IACzD,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI;IAC1E,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,CAAC,KAAK,CAAC,GAAG,IAAI;IASzD;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,CAAC,KAAK,CAAC,GAAG,IAAI;IAC1D,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI;IAC3E,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,CAAC,KAAK,CAAC,GAAG,IAAI;IAW1D;;OAEG;IACH,KAAK,IAAI,IAAI;YAIC,KAAK;IAoDnB,OAAO,CAAC,cAAc;IAyBtB,OAAO,CAAC,IAAI;CAYb"}
@@ -0,0 +1,198 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.SearchStream = exports.SearchResource = void 0;
4
+ class SearchResource {
5
+ http;
6
+ constructor(http) {
7
+ this.http = http;
8
+ }
9
+ /**
10
+ * Search for tweets.
11
+ */
12
+ async tweets(params) {
13
+ return this.http.request({
14
+ method: 'POST',
15
+ path: '/search',
16
+ body: buildSearchBody(params),
17
+ });
18
+ }
19
+ /**
20
+ * Search for users.
21
+ */
22
+ async users(params) {
23
+ return this.http.request({
24
+ method: 'POST',
25
+ path: '/search/users',
26
+ body: { query: params.query, count: params.count },
27
+ });
28
+ }
29
+ /**
30
+ * Stream search results via SSE. Returns an EventSource-like object.
31
+ *
32
+ * Usage:
33
+ * ```ts
34
+ * const stream = client.search.stream({ query: 'bitcoin', count: 500 });
35
+ * stream.on('tweet', (tweet) => console.log(tweet));
36
+ * stream.on('done', (meta) => console.log('finished', meta));
37
+ * stream.on('error', (err) => console.error(err));
38
+ * ```
39
+ */
40
+ stream(params) {
41
+ return new SearchStream(this.http, params);
42
+ }
43
+ }
44
+ exports.SearchResource = SearchResource;
45
+ function buildSearchBody(params) {
46
+ const body = { query: params.query };
47
+ if (params.count !== undefined)
48
+ body.count = params.count;
49
+ if (params.sort !== undefined)
50
+ body.sort = params.sort;
51
+ if (params.cursor !== undefined)
52
+ body.cursor = params.cursor;
53
+ if (params.lang !== undefined)
54
+ body.lang = params.lang;
55
+ if (params.min_likes !== undefined)
56
+ body.min_likes = params.min_likes;
57
+ if (params.min_retweets !== undefined)
58
+ body.min_retweets = params.min_retweets;
59
+ if (params.exclude_replies !== undefined)
60
+ body.exclude_replies = params.exclude_replies;
61
+ if (params.exclude_retweets !== undefined)
62
+ body.exclude_retweets = params.exclude_retweets;
63
+ if (params.since !== undefined)
64
+ body.since = params.since;
65
+ if (params.until !== undefined)
66
+ body.until = params.until;
67
+ if (params.stream !== undefined)
68
+ body.stream = params.stream;
69
+ return body;
70
+ }
71
+ /**
72
+ * SSE stream wrapper for search results.
73
+ * Connects to the search endpoint with stream=true and emits events.
74
+ */
75
+ class SearchStream {
76
+ http;
77
+ params;
78
+ listeners = { tweet: [], done: [], error: [] };
79
+ abortController;
80
+ started = false;
81
+ constructor(http, params) {
82
+ this.http = http;
83
+ this.params = params;
84
+ this.abortController = new AbortController();
85
+ // Auto-start on next tick so listeners can be attached
86
+ queueMicrotask(() => this.start());
87
+ }
88
+ on(event, callback) {
89
+ const key = event;
90
+ if (this.listeners[key]) {
91
+ this.listeners[key].push(callback);
92
+ }
93
+ return this;
94
+ }
95
+ off(event, callback) {
96
+ const key = event;
97
+ if (this.listeners[key]) {
98
+ const arr = this.listeners[key];
99
+ const idx = arr.indexOf(callback);
100
+ if (idx !== -1)
101
+ arr.splice(idx, 1);
102
+ }
103
+ return this;
104
+ }
105
+ /**
106
+ * Abort the stream.
107
+ */
108
+ close() {
109
+ this.abortController.abort();
110
+ }
111
+ async start() {
112
+ if (this.started)
113
+ return;
114
+ this.started = true;
115
+ try {
116
+ const body = buildSearchBody({ ...this.params, stream: true });
117
+ const response = await this.http.requestRaw({
118
+ method: 'POST',
119
+ path: '/search',
120
+ body,
121
+ signal: this.abortController.signal,
122
+ });
123
+ if (!response.body) {
124
+ this.emit('error', new Error('No response body for stream'));
125
+ return;
126
+ }
127
+ const reader = response.body.getReader();
128
+ const decoder = new TextDecoder();
129
+ let buffer = '';
130
+ try {
131
+ while (true) {
132
+ const { done, value } = await reader.read();
133
+ if (done)
134
+ break;
135
+ buffer += decoder.decode(value, { stream: true });
136
+ const lines = buffer.split('\n');
137
+ buffer = lines.pop() ?? '';
138
+ for (const line of lines) {
139
+ this.processSSELine(line);
140
+ }
141
+ }
142
+ }
143
+ catch (readErr) {
144
+ // If aborted by .close(), swallow the error
145
+ if (this.abortController.signal.aborted)
146
+ return;
147
+ throw readErr;
148
+ }
149
+ // Process remaining buffer
150
+ if (buffer.trim()) {
151
+ this.processSSELine(buffer);
152
+ }
153
+ }
154
+ catch (err) {
155
+ if (!this.abortController.signal.aborted) {
156
+ this.emit('error', err instanceof Error ? err : new Error(String(err)));
157
+ }
158
+ }
159
+ }
160
+ processSSELine(line) {
161
+ const trimmed = line.trim();
162
+ if (!trimmed || trimmed.startsWith(':'))
163
+ return;
164
+ if (trimmed.startsWith('data: ')) {
165
+ const jsonStr = trimmed.slice(6);
166
+ try {
167
+ const parsed = JSON.parse(jsonStr);
168
+ if (parsed.type === 'tweet' && parsed.data) {
169
+ this.emit('tweet', parsed.data);
170
+ }
171
+ else if (parsed.type === 'done') {
172
+ this.emit('done', (parsed.meta ?? parsed));
173
+ }
174
+ else if (parsed.type === 'error') {
175
+ this.emit('error', new Error(parsed.error ?? 'Stream error'));
176
+ }
177
+ else if (parsed.data && !parsed.type) {
178
+ // Single tweet object without type wrapper
179
+ this.emit('tweet', parsed.data);
180
+ }
181
+ }
182
+ catch {
183
+ // Ignore malformed JSON lines
184
+ }
185
+ }
186
+ }
187
+ emit(event, data) {
188
+ const key = event;
189
+ const callbacks = this.listeners[key];
190
+ if (callbacks) {
191
+ for (const cb of callbacks) {
192
+ cb(data);
193
+ }
194
+ }
195
+ }
196
+ }
197
+ exports.SearchStream = SearchStream;
198
+ //# sourceMappingURL=search.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"search.js","sourceRoot":"","sources":["../../../src/resources/search.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,45 @@
1
+ import type { HttpClient } from '../http.js';
2
+ import type { Tweet } from '../types.js';
3
+ type StreamCallback<T> = (data: T) => void;
4
+ /**
5
+ * Real-time SSE stream from the /stream endpoint.
6
+ *
7
+ * Usage:
8
+ * ```ts
9
+ * const stream = client.stream.connect();
10
+ * stream.on('tweet', (tweet) => console.log(tweet));
11
+ * stream.on('error', (err) => console.error(err));
12
+ * // Later:
13
+ * stream.close();
14
+ * ```
15
+ */
16
+ export declare class RealtimeStream {
17
+ private readonly http;
18
+ private listeners;
19
+ private abortController;
20
+ private started;
21
+ constructor(http: HttpClient);
22
+ on(event: 'tweet', callback: StreamCallback<Tweet>): this;
23
+ on(event: 'error', callback: StreamCallback<Error>): this;
24
+ on(event: 'close', callback: StreamCallback<void>): this;
25
+ /**
26
+ * Remove an event listener.
27
+ */
28
+ off(event: 'tweet', callback: StreamCallback<Tweet>): this;
29
+ off(event: 'error', callback: StreamCallback<Error>): this;
30
+ off(event: 'close', callback: StreamCallback<void>): this;
31
+ close(): void;
32
+ private start;
33
+ private processLine;
34
+ private emit;
35
+ }
36
+ export declare class StreamResource {
37
+ private readonly http;
38
+ constructor(http: HttpClient);
39
+ /**
40
+ * Connect to the real-time SSE stream.
41
+ */
42
+ connect(): RealtimeStream;
43
+ }
44
+ export {};
45
+ //# sourceMappingURL=stream.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../../src/resources/stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,KAAK,EAAe,MAAM,aAAa,CAAC;AAEtD,KAAK,cAAc,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;AAU3C;;;;;;;;;;;GAWG;AACH,qBAAa,cAAc;IAKb,OAAO,CAAC,QAAQ,CAAC,IAAI;IAJjC,OAAO,CAAC,SAAS,CAAgE;IACjF,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,OAAO,CAAS;gBAEK,IAAI,EAAE,UAAU;IAK7C,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,CAAC,KAAK,CAAC,GAAG,IAAI;IACzD,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,CAAC,KAAK,CAAC,GAAG,IAAI;IACzD,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IASxD;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,CAAC,KAAK,CAAC,GAAG,IAAI;IAC1D,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,CAAC,KAAK,CAAC,GAAG,IAAI;IAC1D,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAWzD,KAAK,IAAI,IAAI;YAKC,KAAK;IA6CnB,OAAO,CAAC,WAAW;IAenB,OAAO,CAAC,IAAI;CAYb;AAED,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;OAEG;IACH,OAAO,IAAI,cAAc;CAG1B"}
@@ -0,0 +1,129 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.StreamResource = exports.RealtimeStream = void 0;
4
+ /**
5
+ * Real-time SSE stream from the /stream endpoint.
6
+ *
7
+ * Usage:
8
+ * ```ts
9
+ * const stream = client.stream.connect();
10
+ * stream.on('tweet', (tweet) => console.log(tweet));
11
+ * stream.on('error', (err) => console.error(err));
12
+ * // Later:
13
+ * stream.close();
14
+ * ```
15
+ */
16
+ class RealtimeStream {
17
+ http;
18
+ listeners = { tweet: [], error: [], close: [] };
19
+ abortController;
20
+ started = false;
21
+ constructor(http) {
22
+ this.http = http;
23
+ this.abortController = new AbortController();
24
+ queueMicrotask(() => this.start());
25
+ }
26
+ on(event, callback) {
27
+ const key = event;
28
+ if (this.listeners[key]) {
29
+ this.listeners[key].push(callback);
30
+ }
31
+ return this;
32
+ }
33
+ off(event, callback) {
34
+ const key = event;
35
+ if (this.listeners[key]) {
36
+ const arr = this.listeners[key];
37
+ const idx = arr.indexOf(callback);
38
+ if (idx !== -1)
39
+ arr.splice(idx, 1);
40
+ }
41
+ return this;
42
+ }
43
+ close() {
44
+ this.abortController.abort();
45
+ this.emit('close', undefined);
46
+ }
47
+ async start() {
48
+ if (this.started)
49
+ return;
50
+ this.started = true;
51
+ try {
52
+ const response = await this.http.requestRaw({
53
+ method: 'GET',
54
+ path: '/stream',
55
+ signal: this.abortController.signal,
56
+ });
57
+ if (!response.body) {
58
+ this.emit('error', new Error('No response body for stream'));
59
+ return;
60
+ }
61
+ const reader = response.body.getReader();
62
+ const decoder = new TextDecoder();
63
+ let buffer = '';
64
+ try {
65
+ while (true) {
66
+ const { done, value } = await reader.read();
67
+ if (done)
68
+ break;
69
+ buffer += decoder.decode(value, { stream: true });
70
+ const lines = buffer.split('\n');
71
+ buffer = lines.pop() ?? '';
72
+ for (const line of lines) {
73
+ this.processLine(line.trim());
74
+ }
75
+ }
76
+ }
77
+ catch (readErr) {
78
+ // If aborted by .close(), swallow the error
79
+ if (this.abortController.signal.aborted)
80
+ return;
81
+ throw readErr;
82
+ }
83
+ }
84
+ catch (err) {
85
+ if (!this.abortController.signal.aborted) {
86
+ this.emit('error', err instanceof Error ? err : new Error(String(err)));
87
+ }
88
+ }
89
+ }
90
+ processLine(line) {
91
+ if (!line || line.startsWith(':'))
92
+ return;
93
+ if (line.startsWith('data: ')) {
94
+ try {
95
+ const parsed = JSON.parse(line.slice(6));
96
+ if (parsed.data) {
97
+ this.emit('tweet', parsed.data);
98
+ }
99
+ }
100
+ catch {
101
+ // ignore
102
+ }
103
+ }
104
+ }
105
+ emit(event, data) {
106
+ const key = event;
107
+ const callbacks = this.listeners[key];
108
+ if (callbacks) {
109
+ for (const cb of callbacks) {
110
+ cb(data);
111
+ }
112
+ }
113
+ }
114
+ }
115
+ exports.RealtimeStream = RealtimeStream;
116
+ class StreamResource {
117
+ http;
118
+ constructor(http) {
119
+ this.http = http;
120
+ }
121
+ /**
122
+ * Connect to the real-time SSE stream.
123
+ */
124
+ connect() {
125
+ return new RealtimeStream(this.http);
126
+ }
127
+ }
128
+ exports.StreamResource = StreamResource;
129
+ //# sourceMappingURL=stream.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"stream.js","sourceRoot":"","sources":["../../../src/resources/stream.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,11 @@
1
+ import type { HttpClient } from '../http.js';
2
+ import type { TrendingTopic, TrendingParams, ApiResponse } from '../types.js';
3
+ export declare class TrendingResource {
4
+ private readonly http;
5
+ constructor(http: HttpClient);
6
+ /**
7
+ * Get current trending topics.
8
+ */
9
+ get(params?: TrendingParams): Promise<ApiResponse<TrendingTopic[]>>;
10
+ }
11
+ //# sourceMappingURL=trending.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"trending.d.ts","sourceRoot":"","sources":["../../../src/resources/trending.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE9E,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;OAEG;IACG,GAAG,CAAC,MAAM,GAAE,cAAmB,GAAG,OAAO,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC,CAAC;CAO9E"}
@@ -0,0 +1,21 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.TrendingResource = void 0;
4
+ class TrendingResource {
5
+ http;
6
+ constructor(http) {
7
+ this.http = http;
8
+ }
9
+ /**
10
+ * Get current trending topics.
11
+ */
12
+ async get(params = {}) {
13
+ return this.http.request({
14
+ method: 'GET',
15
+ path: '/trending',
16
+ query: { country: params.country },
17
+ });
18
+ }
19
+ }
20
+ exports.TrendingResource = TrendingResource;
21
+ //# sourceMappingURL=trending.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"trending.js","sourceRoot":"","sources":["../../../src/resources/trending.ts"],"names":[],"mappings":";;;AAGA,MAAa,gBAAgB;IACE;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,SAAyB,EAAE;QACnC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAkB;YACxC,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,WAAW;YACjB,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE;SACnC,CAAC,CAAC;IACL,CAAC;CACF;AAbD,4CAaC"}
@@ -0,0 +1,84 @@
1
+ import type { HttpClient } from '../http.js';
2
+ import type { Tweet, PaginationParams, PaginatedResponse, ApiResponse, CreateTweetParams, ReplyTweetParams, QuoteTweetParams, WriteResult, InteractionCheckResult } from '../types.js';
3
+ export declare class TweetsResource {
4
+ private readonly http;
5
+ constructor(http: HttpClient);
6
+ /**
7
+ * Get a single tweet by ID.
8
+ */
9
+ get(tweetId: string): Promise<ApiResponse<Tweet>>;
10
+ /**
11
+ * Get the conversation thread for a tweet.
12
+ */
13
+ conversation(tweetId: string, params?: PaginationParams): Promise<PaginatedResponse<Tweet>>;
14
+ /**
15
+ * Get quote tweets of a tweet.
16
+ */
17
+ quotes(tweetId: string, params?: PaginationParams): Promise<PaginatedResponse<Tweet>>;
18
+ /**
19
+ * Batch lookup multiple tweets by ID (max 100).
20
+ */
21
+ batch(tweetIds: string[]): Promise<ApiResponse<Tweet[]>>;
22
+ /**
23
+ * Create a new tweet. Requires a connected X account.
24
+ */
25
+ create(params: CreateTweetParams): Promise<ApiResponse<WriteResult>>;
26
+ /**
27
+ * Reply to a tweet. Requires a connected X account.
28
+ */
29
+ reply(params: ReplyTweetParams): Promise<ApiResponse<WriteResult>>;
30
+ /**
31
+ * Quote a tweet. Requires a connected X account.
32
+ */
33
+ quote(params: QuoteTweetParams): Promise<ApiResponse<WriteResult>>;
34
+ /**
35
+ * Delete a tweet. Requires a connected X account.
36
+ */
37
+ delete(tweetId: string): Promise<ApiResponse<{
38
+ success: boolean;
39
+ }>>;
40
+ /**
41
+ * Like a tweet. Requires a connected X account.
42
+ */
43
+ like(tweetId: string): Promise<ApiResponse<{
44
+ success: boolean;
45
+ }>>;
46
+ /**
47
+ * Unlike a tweet. Requires a connected X account.
48
+ */
49
+ unlike(tweetId: string): Promise<ApiResponse<{
50
+ success: boolean;
51
+ }>>;
52
+ /**
53
+ * Retweet a tweet. Requires a connected X account.
54
+ */
55
+ retweet(tweetId: string): Promise<ApiResponse<{
56
+ success: boolean;
57
+ }>>;
58
+ /**
59
+ * Unretweet a tweet. Requires a connected X account.
60
+ */
61
+ unretweet(tweetId: string): Promise<ApiResponse<{
62
+ success: boolean;
63
+ }>>;
64
+ /**
65
+ * Check if a user retweeted a tweet.
66
+ */
67
+ checkRetweet(tweetId: string, username: string): Promise<ApiResponse<InteractionCheckResult>>;
68
+ /**
69
+ * Check if a user replied to a tweet.
70
+ */
71
+ checkReply(tweetId: string, username: string): Promise<ApiResponse<InteractionCheckResult>>;
72
+ /**
73
+ * Check if a user quoted a tweet.
74
+ */
75
+ checkQuote(tweetId: string, username: string): Promise<ApiResponse<InteractionCheckResult>>;
76
+ }
77
+ type TweetPaginatedMethod<T> = (id: string, params: PaginationParams) => Promise<PaginatedResponse<T>>;
78
+ /**
79
+ * Async generator that auto-paginates a tweet-based paginated endpoint.
80
+ * @param maxPages Safety limit to prevent infinite loops (default 100).
81
+ */
82
+ export declare function paginateTweet<T>(method: TweetPaginatedMethod<T>, id: string, params?: PaginationParams, maxPages?: number): AsyncGenerator<T, void, undefined>;
83
+ export {};
84
+ //# sourceMappingURL=tweets.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tweets.d.ts","sourceRoot":"","sources":["../../../src/resources/tweets.ts"],"names":[],"mappings":"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"}