@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,MAAa,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;AAtDD,kDAsDC"}
@@ -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,66 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.ListsResource = void 0;
4
+ exports.paginateList = paginateList;
5
+ const DEFAULT_MAX_PAGES = 100;
6
+ class ListsResource {
7
+ http;
8
+ constructor(http) {
9
+ this.http = http;
10
+ }
11
+ /**
12
+ * Get tweets from a list.
13
+ */
14
+ async tweets(listId, params = {}) {
15
+ return this.http.request({
16
+ method: 'GET',
17
+ path: `/lists/${encodeURIComponent(listId)}/tweets`,
18
+ query: {
19
+ count: params.count,
20
+ cursor: params.cursor,
21
+ since: params.since,
22
+ until: params.until,
23
+ },
24
+ });
25
+ }
26
+ /**
27
+ * Get members of a list.
28
+ */
29
+ async members(listId, params = {}) {
30
+ return this.http.request({
31
+ method: 'GET',
32
+ path: `/lists/${encodeURIComponent(listId)}/members`,
33
+ query: { count: params.count, cursor: params.cursor },
34
+ });
35
+ }
36
+ /**
37
+ * Get subscribers of a list.
38
+ */
39
+ async subscribers(listId, params = {}) {
40
+ return this.http.request({
41
+ method: 'GET',
42
+ path: `/lists/${encodeURIComponent(listId)}/subscribers`,
43
+ query: { count: params.count, cursor: params.cursor },
44
+ });
45
+ }
46
+ }
47
+ exports.ListsResource = ListsResource;
48
+ /**
49
+ * Async generator that auto-paginates a list-based paginated endpoint.
50
+ * @param maxPages Safety limit to prevent infinite loops (default 100).
51
+ */
52
+ async function* paginateList(method, listId, params = {}, maxPages = DEFAULT_MAX_PAGES) {
53
+ let cursor = params.cursor;
54
+ let hasNext = true;
55
+ let page = 0;
56
+ while (hasNext && page < maxPages) {
57
+ const response = await method(listId, { ...params, cursor });
58
+ for (const item of response.data) {
59
+ yield item;
60
+ }
61
+ cursor = response.meta.cursor;
62
+ hasNext = !!response.meta.has_next && !!cursor;
63
+ page++;
64
+ }
65
+ }
66
+ //# sourceMappingURL=lists.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lists.js","sourceRoot":"","sources":["../../../src/resources/lists.ts"],"names":[],"mappings":";;;AAkEA,oCAqBC;AA9ED,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAE9B,MAAa,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;AAjDD,sCAiDC;AAED;;;GAGG;AACI,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,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"}