@xcrop/sdk 0.0.0-stage → 1.1.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 (108) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +415 -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 +46 -0
  8. package/dist/cjs/errors.d.ts.map +1 -0
  9. package/dist/cjs/errors.js +79 -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 +28 -0
  21. package/dist/cjs/resources/account.d.ts.map +1 -0
  22. package/dist/cjs/resources/account.js +63 -0
  23. package/dist/cjs/resources/account.js.map +1 -0
  24. package/dist/cjs/resources/communities.d.ts +29 -0
  25. package/dist/cjs/resources/communities.d.ts.map +1 -0
  26. package/dist/cjs/resources/communities.js +56 -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 +66 -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 +90 -0
  45. package/dist/cjs/resources/tweets.d.ts.map +1 -0
  46. package/dist/cjs/resources/tweets.js +202 -0
  47. package/dist/cjs/resources/tweets.js.map +1 -0
  48. package/dist/cjs/resources/users.d.ts +96 -0
  49. package/dist/cjs/resources/users.d.ts.map +1 -0
  50. package/dist/cjs/resources/users.js +238 -0
  51. package/dist/cjs/resources/users.js.map +1 -0
  52. package/dist/cjs/types.d.ts +442 -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 +46 -0
  61. package/dist/esm/errors.d.ts.map +1 -0
  62. package/dist/esm/errors.js +71 -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 +28 -0
  73. package/dist/esm/resources/account.d.ts.map +1 -0
  74. package/dist/esm/resources/account.js +59 -0
  75. package/dist/esm/resources/account.js.map +1 -0
  76. package/dist/esm/resources/communities.d.ts +29 -0
  77. package/dist/esm/resources/communities.d.ts.map +1 -0
  78. package/dist/esm/resources/communities.js +52 -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 +61 -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 +90 -0
  97. package/dist/esm/resources/tweets.d.ts.map +1 -0
  98. package/dist/esm/resources/tweets.js +197 -0
  99. package/dist/esm/resources/tweets.js.map +1 -0
  100. package/dist/esm/resources/users.d.ts +96 -0
  101. package/dist/esm/resources/users.d.ts.map +1 -0
  102. package/dist/esm/resources/users.js +233 -0
  103. package/dist/esm/resources/users.js.map +1 -0
  104. package/dist/esm/types.d.ts +442 -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 @@
1
+ {"version":3,"file":"communities.js","sourceRoot":"","sources":["../../../src/resources/communities.ts"],"names":[],"mappings":"AAYA;;;;;GAKG;AACH,MAAM,OAAO,mBAAmB;IACD;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,WAAmB;QAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAY;YAClC,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,gBAAgB,kBAAkB,CAAC,WAAW,CAAC,EAAE;SACxD,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CACV,WAAmB,EACnB,SAAgC,EAAE;QAElC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;YACvB,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,gBAAgB,kBAAkB,CAAC,WAAW,CAAC,SAAS;YAC9D,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;SACtD,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CACX,WAAmB,EACnB,SAAiC,EAAE;QAEnC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;YACvB,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,gBAAgB,kBAAkB,CAAC,WAAW,CAAC,UAAU;YAC/D,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;SACzE,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CACd,WAAmB,EACnB,SAAoC,EAAE;QAEtC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;YACvB,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,gBAAgB,kBAAkB,CAAC,WAAW,CAAC,aAAa;YAClE,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;SACzE,CAAC,CAAC;IACL,CAAC;CACF"}
@@ -0,0 +1,24 @@
1
+ import type { HttpClient } from '../http.js';
2
+ import type { Tweet, User, PaginationParams, PaginatedResponse, TimeWindowParams } from '../types.js';
3
+ export declare class ListsResource {
4
+ private readonly http;
5
+ constructor(http: HttpClient);
6
+ /**
7
+ * Get tweets from a list.
8
+ */
9
+ tweets(listId: string, params?: PaginationParams & TimeWindowParams): Promise<PaginatedResponse<Tweet>>;
10
+ /**
11
+ * Get members of a list.
12
+ */
13
+ members(listId: string, params?: PaginationParams): Promise<PaginatedResponse<User>>;
14
+ /**
15
+ * Get subscribers of a list.
16
+ */
17
+ subscribers(listId: string, params?: PaginationParams): Promise<PaginatedResponse<User>>;
18
+ }
19
+ /**
20
+ * Async generator that auto-paginates a list-based paginated endpoint.
21
+ * @param maxPages Safety limit to prevent infinite loops (default 100).
22
+ */
23
+ export declare function paginateList<T>(method: (listId: string, params: PaginationParams) => Promise<PaginatedResponse<T>>, listId: string, params?: PaginationParams, maxPages?: number): AsyncGenerator<T, void, undefined>;
24
+ //# sourceMappingURL=lists.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lists.d.ts","sourceRoot":"","sources":["../../../src/resources/lists.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EACV,KAAK,EACL,IAAI,EACJ,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,aAAa,CAAC;AAIrB,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;OAEG;IACG,MAAM,CACV,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,gBAAgB,GAAG,gBAAqB,GAC/C,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAapC;;OAEG;IACG,OAAO,CACX,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,gBAAqB,GAC5B,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAQnC;;OAEG;IACG,WAAW,CACf,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,gBAAqB,GAC5B,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;CAOpC;AAED;;;GAGG;AACH,wBAAuB,YAAY,CAAC,CAAC,EACnC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,EACnF,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,gBAAqB,EAC7B,QAAQ,GAAE,MAA0B,GACnC,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAgBpC"}
@@ -0,0 +1,61 @@
1
+ const DEFAULT_MAX_PAGES = 100;
2
+ export class ListsResource {
3
+ http;
4
+ constructor(http) {
5
+ this.http = http;
6
+ }
7
+ /**
8
+ * Get tweets from a list.
9
+ */
10
+ async tweets(listId, params = {}) {
11
+ return this.http.request({
12
+ method: 'GET',
13
+ path: `/lists/${encodeURIComponent(listId)}/tweets`,
14
+ query: {
15
+ count: params.count,
16
+ cursor: params.cursor,
17
+ since: params.since,
18
+ until: params.until,
19
+ },
20
+ });
21
+ }
22
+ /**
23
+ * Get members of a list.
24
+ */
25
+ async members(listId, params = {}) {
26
+ return this.http.request({
27
+ method: 'GET',
28
+ path: `/lists/${encodeURIComponent(listId)}/members`,
29
+ query: { count: params.count, cursor: params.cursor },
30
+ });
31
+ }
32
+ /**
33
+ * Get subscribers of a list.
34
+ */
35
+ async subscribers(listId, params = {}) {
36
+ return this.http.request({
37
+ method: 'GET',
38
+ path: `/lists/${encodeURIComponent(listId)}/subscribers`,
39
+ query: { count: params.count, cursor: params.cursor },
40
+ });
41
+ }
42
+ }
43
+ /**
44
+ * Async generator that auto-paginates a list-based paginated endpoint.
45
+ * @param maxPages Safety limit to prevent infinite loops (default 100).
46
+ */
47
+ export async function* paginateList(method, listId, params = {}, maxPages = DEFAULT_MAX_PAGES) {
48
+ let cursor = params.cursor;
49
+ let hasNext = true;
50
+ let page = 0;
51
+ while (hasNext && page < maxPages) {
52
+ const response = await method(listId, { ...params, cursor });
53
+ for (const item of response.data) {
54
+ yield item;
55
+ }
56
+ cursor = response.meta.cursor;
57
+ hasNext = !!response.meta.has_next && !!cursor;
58
+ page++;
59
+ }
60
+ }
61
+ //# sourceMappingURL=lists.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lists.js","sourceRoot":"","sources":["../../../src/resources/lists.ts"],"names":[],"mappings":"AASA,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAE9B,MAAM,OAAO,aAAa;IACK;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD;;OAEG;IACH,KAAK,CAAC,MAAM,CACV,MAAc,EACd,SAA8C,EAAE;QAEhD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;YACvB,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,UAAU,kBAAkB,CAAC,MAAM,CAAC,SAAS;YACnD,KAAK,EAAE;gBACL,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,KAAK,EAAE,MAAM,CAAC,KAAK;aACpB;SACF,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CACX,MAAc,EACd,SAA2B,EAAE;QAE7B,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;YACvB,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,UAAU,kBAAkB,CAAC,MAAM,CAAC,UAAU;YACpD,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;SACtD,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CACf,MAAc,EACd,SAA2B,EAAE;QAE7B,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;YACvB,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,UAAU,kBAAkB,CAAC,MAAM,CAAC,cAAc;YACxD,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;SACtD,CAAC,CAAC;IACL,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,YAAY,CACjC,MAAmF,EACnF,MAAc,EACd,SAA2B,EAAE,EAC7B,WAAmB,iBAAiB;IAEpC,IAAI,MAAM,GAAuB,MAAM,CAAC,MAAM,CAAC;IAC/C,IAAI,OAAO,GAAG,IAAI,CAAC;IACnB,IAAI,IAAI,GAAG,CAAC,CAAC;IAEb,OAAO,OAAO,IAAI,IAAI,GAAG,QAAQ,EAAE,CAAC;QAClC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAE7D,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;YACjC,MAAM,IAAI,CAAC;QACb,CAAC;QAED,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;QAC9B,OAAO,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC,MAAM,CAAC;QAC/C,IAAI,EAAE,CAAC;IACT,CAAC;AACH,CAAC"}
@@ -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,193 @@
1
+ export class SearchResource {
2
+ http;
3
+ constructor(http) {
4
+ this.http = http;
5
+ }
6
+ /**
7
+ * Search for tweets.
8
+ */
9
+ async tweets(params) {
10
+ return this.http.request({
11
+ method: 'POST',
12
+ path: '/search',
13
+ body: buildSearchBody(params),
14
+ });
15
+ }
16
+ /**
17
+ * Search for users.
18
+ */
19
+ async users(params) {
20
+ return this.http.request({
21
+ method: 'POST',
22
+ path: '/search/users',
23
+ body: { query: params.query, count: params.count },
24
+ });
25
+ }
26
+ /**
27
+ * Stream search results via SSE. Returns an EventSource-like object.
28
+ *
29
+ * Usage:
30
+ * ```ts
31
+ * const stream = client.search.stream({ query: 'bitcoin', count: 500 });
32
+ * stream.on('tweet', (tweet) => console.log(tweet));
33
+ * stream.on('done', (meta) => console.log('finished', meta));
34
+ * stream.on('error', (err) => console.error(err));
35
+ * ```
36
+ */
37
+ stream(params) {
38
+ return new SearchStream(this.http, params);
39
+ }
40
+ }
41
+ function buildSearchBody(params) {
42
+ const body = { query: params.query };
43
+ if (params.count !== undefined)
44
+ body.count = params.count;
45
+ if (params.sort !== undefined)
46
+ body.sort = params.sort;
47
+ if (params.cursor !== undefined)
48
+ body.cursor = params.cursor;
49
+ if (params.lang !== undefined)
50
+ body.lang = params.lang;
51
+ if (params.min_likes !== undefined)
52
+ body.min_likes = params.min_likes;
53
+ if (params.min_retweets !== undefined)
54
+ body.min_retweets = params.min_retweets;
55
+ if (params.exclude_replies !== undefined)
56
+ body.exclude_replies = params.exclude_replies;
57
+ if (params.exclude_retweets !== undefined)
58
+ body.exclude_retweets = params.exclude_retweets;
59
+ if (params.since !== undefined)
60
+ body.since = params.since;
61
+ if (params.until !== undefined)
62
+ body.until = params.until;
63
+ if (params.stream !== undefined)
64
+ body.stream = params.stream;
65
+ return body;
66
+ }
67
+ /**
68
+ * SSE stream wrapper for search results.
69
+ * Connects to the search endpoint with stream=true and emits events.
70
+ */
71
+ export class SearchStream {
72
+ http;
73
+ params;
74
+ listeners = { tweet: [], done: [], error: [] };
75
+ abortController;
76
+ started = false;
77
+ constructor(http, params) {
78
+ this.http = http;
79
+ this.params = params;
80
+ this.abortController = new AbortController();
81
+ // Auto-start on next tick so listeners can be attached
82
+ queueMicrotask(() => this.start());
83
+ }
84
+ on(event, callback) {
85
+ const key = event;
86
+ if (this.listeners[key]) {
87
+ this.listeners[key].push(callback);
88
+ }
89
+ return this;
90
+ }
91
+ off(event, callback) {
92
+ const key = event;
93
+ if (this.listeners[key]) {
94
+ const arr = this.listeners[key];
95
+ const idx = arr.indexOf(callback);
96
+ if (idx !== -1)
97
+ arr.splice(idx, 1);
98
+ }
99
+ return this;
100
+ }
101
+ /**
102
+ * Abort the stream.
103
+ */
104
+ close() {
105
+ this.abortController.abort();
106
+ }
107
+ async start() {
108
+ if (this.started)
109
+ return;
110
+ this.started = true;
111
+ try {
112
+ const body = buildSearchBody({ ...this.params, stream: true });
113
+ const response = await this.http.requestRaw({
114
+ method: 'POST',
115
+ path: '/search',
116
+ body,
117
+ signal: this.abortController.signal,
118
+ });
119
+ if (!response.body) {
120
+ this.emit('error', new Error('No response body for stream'));
121
+ return;
122
+ }
123
+ const reader = response.body.getReader();
124
+ const decoder = new TextDecoder();
125
+ let buffer = '';
126
+ try {
127
+ while (true) {
128
+ const { done, value } = await reader.read();
129
+ if (done)
130
+ break;
131
+ buffer += decoder.decode(value, { stream: true });
132
+ const lines = buffer.split('\n');
133
+ buffer = lines.pop() ?? '';
134
+ for (const line of lines) {
135
+ this.processSSELine(line);
136
+ }
137
+ }
138
+ }
139
+ catch (readErr) {
140
+ // If aborted by .close(), swallow the error
141
+ if (this.abortController.signal.aborted)
142
+ return;
143
+ throw readErr;
144
+ }
145
+ // Process remaining buffer
146
+ if (buffer.trim()) {
147
+ this.processSSELine(buffer);
148
+ }
149
+ }
150
+ catch (err) {
151
+ if (!this.abortController.signal.aborted) {
152
+ this.emit('error', err instanceof Error ? err : new Error(String(err)));
153
+ }
154
+ }
155
+ }
156
+ processSSELine(line) {
157
+ const trimmed = line.trim();
158
+ if (!trimmed || trimmed.startsWith(':'))
159
+ return;
160
+ if (trimmed.startsWith('data: ')) {
161
+ const jsonStr = trimmed.slice(6);
162
+ try {
163
+ const parsed = JSON.parse(jsonStr);
164
+ if (parsed.type === 'tweet' && parsed.data) {
165
+ this.emit('tweet', parsed.data);
166
+ }
167
+ else if (parsed.type === 'done') {
168
+ this.emit('done', (parsed.meta ?? parsed));
169
+ }
170
+ else if (parsed.type === 'error') {
171
+ this.emit('error', new Error(parsed.error ?? 'Stream error'));
172
+ }
173
+ else if (parsed.data && !parsed.type) {
174
+ // Single tweet object without type wrapper
175
+ this.emit('tweet', parsed.data);
176
+ }
177
+ }
178
+ catch {
179
+ // Ignore malformed JSON lines
180
+ }
181
+ }
182
+ }
183
+ emit(event, data) {
184
+ const key = event;
185
+ const callbacks = this.listeners[key];
186
+ if (callbacks) {
187
+ for (const cb of callbacks) {
188
+ cb(data);
189
+ }
190
+ }
191
+ }
192
+ }
193
+ //# 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,124 @@
1
+ /**
2
+ * Real-time SSE stream from the /stream endpoint.
3
+ *
4
+ * Usage:
5
+ * ```ts
6
+ * const stream = client.stream.connect();
7
+ * stream.on('tweet', (tweet) => console.log(tweet));
8
+ * stream.on('error', (err) => console.error(err));
9
+ * // Later:
10
+ * stream.close();
11
+ * ```
12
+ */
13
+ export class RealtimeStream {
14
+ http;
15
+ listeners = { tweet: [], error: [], close: [] };
16
+ abortController;
17
+ started = false;
18
+ constructor(http) {
19
+ this.http = http;
20
+ this.abortController = new AbortController();
21
+ queueMicrotask(() => this.start());
22
+ }
23
+ on(event, callback) {
24
+ const key = event;
25
+ if (this.listeners[key]) {
26
+ this.listeners[key].push(callback);
27
+ }
28
+ return this;
29
+ }
30
+ off(event, callback) {
31
+ const key = event;
32
+ if (this.listeners[key]) {
33
+ const arr = this.listeners[key];
34
+ const idx = arr.indexOf(callback);
35
+ if (idx !== -1)
36
+ arr.splice(idx, 1);
37
+ }
38
+ return this;
39
+ }
40
+ close() {
41
+ this.abortController.abort();
42
+ this.emit('close', undefined);
43
+ }
44
+ async start() {
45
+ if (this.started)
46
+ return;
47
+ this.started = true;
48
+ try {
49
+ const response = await this.http.requestRaw({
50
+ method: 'GET',
51
+ path: '/stream',
52
+ signal: this.abortController.signal,
53
+ });
54
+ if (!response.body) {
55
+ this.emit('error', new Error('No response body for stream'));
56
+ return;
57
+ }
58
+ const reader = response.body.getReader();
59
+ const decoder = new TextDecoder();
60
+ let buffer = '';
61
+ try {
62
+ while (true) {
63
+ const { done, value } = await reader.read();
64
+ if (done)
65
+ break;
66
+ buffer += decoder.decode(value, { stream: true });
67
+ const lines = buffer.split('\n');
68
+ buffer = lines.pop() ?? '';
69
+ for (const line of lines) {
70
+ this.processLine(line.trim());
71
+ }
72
+ }
73
+ }
74
+ catch (readErr) {
75
+ // If aborted by .close(), swallow the error
76
+ if (this.abortController.signal.aborted)
77
+ return;
78
+ throw readErr;
79
+ }
80
+ }
81
+ catch (err) {
82
+ if (!this.abortController.signal.aborted) {
83
+ this.emit('error', err instanceof Error ? err : new Error(String(err)));
84
+ }
85
+ }
86
+ }
87
+ processLine(line) {
88
+ if (!line || line.startsWith(':'))
89
+ return;
90
+ if (line.startsWith('data: ')) {
91
+ try {
92
+ const parsed = JSON.parse(line.slice(6));
93
+ if (parsed.data) {
94
+ this.emit('tweet', parsed.data);
95
+ }
96
+ }
97
+ catch {
98
+ // ignore
99
+ }
100
+ }
101
+ }
102
+ emit(event, data) {
103
+ const key = event;
104
+ const callbacks = this.listeners[key];
105
+ if (callbacks) {
106
+ for (const cb of callbacks) {
107
+ cb(data);
108
+ }
109
+ }
110
+ }
111
+ }
112
+ export class StreamResource {
113
+ http;
114
+ constructor(http) {
115
+ this.http = http;
116
+ }
117
+ /**
118
+ * Connect to the real-time SSE stream.
119
+ */
120
+ connect() {
121
+ return new RealtimeStream(this.http);
122
+ }
123
+ }
124
+ //# 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,17 @@
1
+ export class TrendingResource {
2
+ http;
3
+ constructor(http) {
4
+ this.http = http;
5
+ }
6
+ /**
7
+ * Get current trending topics.
8
+ */
9
+ async get(params = {}) {
10
+ return this.http.request({
11
+ method: 'GET',
12
+ path: '/trending',
13
+ query: { country: params.country },
14
+ });
15
+ }
16
+ }
17
+ //# sourceMappingURL=trending.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"trending.js","sourceRoot":"","sources":["../../../src/resources/trending.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,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"}