@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,246 @@
1
+ import { XCropError, AuthError, RateLimitError, NotFoundError, ForbiddenError, } from './errors.js';
2
+ const DEFAULT_BASE_URL = 'https://xcrop.io/api/v2';
3
+ const DEFAULT_TIMEOUT = 30_000;
4
+ const DEFAULT_MAX_RETRIES = 3;
5
+ /** SDK version — single source of truth */
6
+ export const SDK_VERSION = '1.0.1';
7
+ const USER_AGENT = `@xcrop/sdk/${SDK_VERSION}`;
8
+ /**
9
+ * Low-level HTTP client with automatic retry, backoff, and error mapping.
10
+ */
11
+ export class HttpClient {
12
+ apiKey;
13
+ baseUrl;
14
+ timeout;
15
+ maxRetries;
16
+ constructor(options) {
17
+ this.apiKey = options.apiKey;
18
+ this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, '');
19
+ this.timeout = options.timeout ?? DEFAULT_TIMEOUT;
20
+ this.maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;
21
+ }
22
+ async request(options) {
23
+ const { method, path, query, body, noRetry, signal } = options;
24
+ const url = this.buildUrl(path, query);
25
+ const headers = {
26
+ 'Authorization': `Bearer ${this.apiKey}`,
27
+ 'Content-Type': 'application/json',
28
+ 'User-Agent': USER_AGENT,
29
+ };
30
+ const maxAttempts = noRetry ? 1 : this.maxRetries + 1;
31
+ for (let attempt = 0; attempt < maxAttempts; attempt++) {
32
+ try {
33
+ const controller = new AbortController();
34
+ const timeoutId = setTimeout(() => controller.abort(), this.timeout);
35
+ // If an external signal is provided, link it
36
+ if (signal) {
37
+ if (signal.aborted) {
38
+ clearTimeout(timeoutId);
39
+ throw new XCropError('Request aborted', 0, 'ABORTED');
40
+ }
41
+ signal.addEventListener('abort', () => controller.abort(), { once: true });
42
+ }
43
+ const response = await fetch(url, {
44
+ method,
45
+ headers,
46
+ body: body ? JSON.stringify(body) : undefined,
47
+ signal: controller.signal,
48
+ });
49
+ clearTimeout(timeoutId);
50
+ const responseHeaders = extractHeaders(response.headers);
51
+ if (response.ok) {
52
+ const json = await response.json();
53
+ return json;
54
+ }
55
+ // Parse error body
56
+ let errorBody = {};
57
+ try {
58
+ errorBody = await response.json();
59
+ }
60
+ catch {
61
+ // ignore parse errors
62
+ }
63
+ const errorMessage = errorBody.error ?? `HTTP ${response.status}`;
64
+ const errorCode = errorBody.code ?? `HTTP_${response.status}`;
65
+ // Non-retryable errors
66
+ if (response.status === 401) {
67
+ throw new AuthError(errorMessage, responseHeaders);
68
+ }
69
+ if (response.status === 403) {
70
+ throw new ForbiddenError(errorMessage, responseHeaders);
71
+ }
72
+ if (response.status === 404) {
73
+ throw new NotFoundError(errorMessage, responseHeaders);
74
+ }
75
+ // Retryable: 429 rate limit
76
+ if (response.status === 429) {
77
+ if (attempt < maxAttempts - 1) {
78
+ const retryAfter = parseInt(responseHeaders['retry-after'] || '', 10);
79
+ const delay = retryAfter > 0
80
+ ? retryAfter * 1000
81
+ : backoffDelay(attempt);
82
+ await sleep(delay);
83
+ continue;
84
+ }
85
+ throw new RateLimitError(errorMessage, responseHeaders);
86
+ }
87
+ // Retryable: 5xx server errors
88
+ if (response.status >= 500) {
89
+ if (attempt < maxAttempts - 1) {
90
+ await sleep(backoffDelay(attempt));
91
+ continue;
92
+ }
93
+ throw new XCropError(errorMessage, response.status, errorCode, responseHeaders);
94
+ }
95
+ // Other 4xx — not retryable
96
+ throw new XCropError(errorMessage, response.status, errorCode, responseHeaders);
97
+ }
98
+ catch (err) {
99
+ if (err instanceof XCropError)
100
+ throw err;
101
+ // Abort / timeout
102
+ if (err instanceof DOMException && err.name === 'AbortError') {
103
+ if (attempt < maxAttempts - 1) {
104
+ await sleep(backoffDelay(attempt));
105
+ continue;
106
+ }
107
+ throw new XCropError(`Request timed out after ${this.timeout}ms`, 0, 'TIMEOUT');
108
+ }
109
+ // Network errors — retry
110
+ if (attempt < maxAttempts - 1) {
111
+ await sleep(backoffDelay(attempt));
112
+ continue;
113
+ }
114
+ throw new XCropError(err.message ?? 'Network error', 0, 'NETWORK_ERROR');
115
+ }
116
+ }
117
+ // Should never reach here
118
+ throw new XCropError('Max retries exceeded', 0, 'MAX_RETRIES');
119
+ }
120
+ /**
121
+ * Execute a request and return a raw Response for streaming.
122
+ * Includes retry logic for 429/5xx (same as request()).
123
+ * Timeout only applies to the initial connection, not to the stream body.
124
+ */
125
+ async requestRaw(options) {
126
+ const { method, path, query, body, signal: externalSignal } = options;
127
+ const url = this.buildUrl(path, query);
128
+ const headers = {
129
+ 'Authorization': `Bearer ${this.apiKey}`,
130
+ 'Content-Type': 'application/json',
131
+ 'User-Agent': USER_AGENT,
132
+ 'Accept': 'text/event-stream',
133
+ };
134
+ const maxAttempts = this.maxRetries + 1;
135
+ for (let attempt = 0; attempt < maxAttempts; attempt++) {
136
+ try {
137
+ // For streaming: only timeout the initial connection, not the full stream
138
+ const connectController = new AbortController();
139
+ const connectTimeout = setTimeout(() => connectController.abort(), this.timeout);
140
+ // Link external signal (for .close() cancellation)
141
+ if (externalSignal) {
142
+ if (externalSignal.aborted) {
143
+ clearTimeout(connectTimeout);
144
+ throw new XCropError('Request aborted', 0, 'ABORTED');
145
+ }
146
+ externalSignal.addEventListener('abort', () => connectController.abort(), { once: true });
147
+ }
148
+ const response = await fetch(url, {
149
+ method,
150
+ headers,
151
+ body: body ? JSON.stringify(body) : undefined,
152
+ signal: connectController.signal,
153
+ });
154
+ // Connection established — clear the connect timeout
155
+ // The stream can now read for as long as needed
156
+ clearTimeout(connectTimeout);
157
+ if (response.ok) {
158
+ return response;
159
+ }
160
+ const responseHeaders = extractHeaders(response.headers);
161
+ let errorBody = {};
162
+ try {
163
+ errorBody = await response.json();
164
+ }
165
+ catch {
166
+ // ignore
167
+ }
168
+ const msg = errorBody.error ?? `HTTP ${response.status}`;
169
+ // Non-retryable
170
+ if (response.status === 401)
171
+ throw new AuthError(msg, responseHeaders);
172
+ if (response.status === 403)
173
+ throw new ForbiddenError(msg, responseHeaders);
174
+ if (response.status === 404)
175
+ throw new NotFoundError(msg, responseHeaders);
176
+ // Retryable: 429
177
+ if (response.status === 429) {
178
+ if (attempt < maxAttempts - 1) {
179
+ const retryAfter = parseInt(responseHeaders['retry-after'] || '', 10);
180
+ const delay = retryAfter > 0 ? retryAfter * 1000 : backoffDelay(attempt);
181
+ await sleep(delay);
182
+ continue;
183
+ }
184
+ throw new RateLimitError(msg, responseHeaders);
185
+ }
186
+ // Retryable: 5xx
187
+ if (response.status >= 500) {
188
+ if (attempt < maxAttempts - 1) {
189
+ await sleep(backoffDelay(attempt));
190
+ continue;
191
+ }
192
+ }
193
+ throw new XCropError(msg, response.status, errorBody.code ?? 'ERROR', responseHeaders);
194
+ }
195
+ catch (err) {
196
+ if (err instanceof XCropError)
197
+ throw err;
198
+ if (err instanceof DOMException && err.name === 'AbortError') {
199
+ // Check if it was an external abort (user called .close())
200
+ if (externalSignal?.aborted) {
201
+ throw new XCropError('Request aborted', 0, 'ABORTED');
202
+ }
203
+ if (attempt < maxAttempts - 1) {
204
+ await sleep(backoffDelay(attempt));
205
+ continue;
206
+ }
207
+ throw new XCropError(`Request timed out after ${this.timeout}ms`, 0, 'TIMEOUT');
208
+ }
209
+ if (attempt < maxAttempts - 1) {
210
+ await sleep(backoffDelay(attempt));
211
+ continue;
212
+ }
213
+ throw new XCropError(err.message ?? 'Network error', 0, 'NETWORK_ERROR');
214
+ }
215
+ }
216
+ throw new XCropError('Max retries exceeded', 0, 'MAX_RETRIES');
217
+ }
218
+ buildUrl(path, query) {
219
+ const url = new URL(`${this.baseUrl}${path}`);
220
+ if (query) {
221
+ for (const [key, value] of Object.entries(query)) {
222
+ if (value !== undefined && value !== null) {
223
+ url.searchParams.set(key, String(value));
224
+ }
225
+ }
226
+ }
227
+ return url.toString();
228
+ }
229
+ }
230
+ function extractHeaders(headers) {
231
+ const result = {};
232
+ headers.forEach((value, key) => {
233
+ result[key.toLowerCase()] = value;
234
+ });
235
+ return result;
236
+ }
237
+ function backoffDelay(attempt) {
238
+ // Exponential backoff: 1s, 2s, 4s + jitter
239
+ const base = Math.min(1000 * Math.pow(2, attempt), 10_000);
240
+ const jitter = Math.random() * 500;
241
+ return base + jitter;
242
+ }
243
+ function sleep(ms) {
244
+ return new Promise((resolve) => setTimeout(resolve, ms));
245
+ }
246
+ //# sourceMappingURL=http.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/http.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,13 @@
1
+ export { XCrop } from './client.js';
2
+ export { SDK_VERSION } from './http.js';
3
+ export { XCropError, AuthError, RateLimitError, NotFoundError, ForbiddenError, } from './errors.js';
4
+ export { UsersResource } from './resources/users.js';
5
+ export { TweetsResource } from './resources/tweets.js';
6
+ export { SearchResource, SearchStream } from './resources/search.js';
7
+ export { ListsResource } from './resources/lists.js';
8
+ export { TrendingResource } from './resources/trending.js';
9
+ export { CommunitiesResource } from './resources/communities.js';
10
+ export { AccountResource } from './resources/account.js';
11
+ export { StreamResource, RealtimeStream } from './resources/stream.js';
12
+ export type { XCropOptions, ApiMeta, ApiResponse, ApiErrorResponse, PaginationParams, PaginatedResponse, User, CheckFollowResult, Tweet, Media, UrlEntity, List, TrendingTopic, TrendingParams, Community, SearchTweetsParams, SearchUsersParams, ConnectAccountParams, AccountStatus, CreateTweetParams, ReplyTweetParams, QuoteTweetParams, WriteResult, InteractionCheckResult, QualifiedAccountParams, QualifiedAccountResult, QualifiedNameParams, QualifiedNameResult, FollowersIdsParams, FollowersIdsMeta, FollowersIdsResponse, CommunityTweetsParams, CommunityMembersParams, StreamOptions, StreamEvent, RequestOptions, } from './types.js';
13
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGpC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAGxC,OAAO,EACL,UAAU,EACV,SAAS,EACT,cAAc,EACd,aAAa,EACb,cAAc,GACf,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvE,YAAY,EAEV,YAAY,EAGZ,OAAO,EACP,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EAGjB,IAAI,EACJ,iBAAiB,EACjB,KAAK,EACL,KAAK,EACL,SAAS,EACT,IAAI,EACJ,aAAa,EACb,cAAc,EACd,SAAS,EAGT,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,aAAa,EACb,WAAW,EACX,cAAc,GACf,MAAM,YAAY,CAAC"}
@@ -0,0 +1,16 @@
1
+ // Main client
2
+ export { XCrop } from './client.js';
3
+ // SDK version
4
+ export { SDK_VERSION } from './http.js';
5
+ // Error classes
6
+ export { XCropError, AuthError, RateLimitError, NotFoundError, ForbiddenError, } from './errors.js';
7
+ // Resource classes (for advanced usage / type narrowing)
8
+ export { UsersResource } from './resources/users.js';
9
+ export { TweetsResource } from './resources/tweets.js';
10
+ export { SearchResource, SearchStream } from './resources/search.js';
11
+ export { ListsResource } from './resources/lists.js';
12
+ export { TrendingResource } from './resources/trending.js';
13
+ export { CommunitiesResource } from './resources/communities.js';
14
+ export { AccountResource } from './resources/account.js';
15
+ export { StreamResource, RealtimeStream } from './resources/stream.js';
16
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,cAAc;AACd,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,gBAAgB;AAChB,OAAO,EACL,UAAU,EACV,SAAS,EACT,cAAc,EACd,aAAa,EACb,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,yDAAyD;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC"}
@@ -0,0 +1,24 @@
1
+ import type { HttpClient } from '../http.js';
2
+ import type { ConnectAccountParams, AccountStatus, ApiResponse } from '../types.js';
3
+ export declare class AccountResource {
4
+ private readonly http;
5
+ constructor(http: HttpClient);
6
+ /**
7
+ * Connect an X account using credentials or cookies.
8
+ * Required for write operations (tweet, like, retweet, follow).
9
+ */
10
+ connect(params: ConnectAccountParams): Promise<ApiResponse<{
11
+ success: boolean;
12
+ }>>;
13
+ /**
14
+ * Check the current X account connection status.
15
+ */
16
+ status(): Promise<ApiResponse<AccountStatus>>;
17
+ /**
18
+ * Disconnect the X account and remove stored credentials.
19
+ */
20
+ disconnect(): Promise<ApiResponse<{
21
+ success: boolean;
22
+ }>>;
23
+ }
24
+ //# sourceMappingURL=account.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../../../src/resources/account.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EACV,oBAAoB,EACpB,aAAa,EACb,WAAW,EACZ,MAAM,aAAa,CAAC;AAErB,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;;OAGG;IACG,OAAO,CACX,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,WAAW,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAuB7C;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;IAOnD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,WAAW,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAM/D"}
@@ -0,0 +1,50 @@
1
+ export class AccountResource {
2
+ http;
3
+ constructor(http) {
4
+ this.http = http;
5
+ }
6
+ /**
7
+ * Connect an X account using credentials or cookies.
8
+ * Required for write operations (tweet, like, retweet, follow).
9
+ */
10
+ async connect(params) {
11
+ const hasCredentials = params.username && params.password;
12
+ const hasCookies = params.cookies?.auth_token && params.cookies?.ct0;
13
+ if (!hasCredentials && !hasCookies) {
14
+ throw new Error('Either credentials (username + password) or cookies (auth_token + ct0) must be provided');
15
+ }
16
+ const body = {};
17
+ if (params.username)
18
+ body.username = params.username;
19
+ if (params.password)
20
+ body.password = params.password;
21
+ if (params.totp_secret)
22
+ body.totp_secret = params.totp_secret;
23
+ if (params.cookies)
24
+ body.cookies = params.cookies;
25
+ return this.http.request({
26
+ method: 'POST',
27
+ path: '/account/connect',
28
+ body,
29
+ });
30
+ }
31
+ /**
32
+ * Check the current X account connection status.
33
+ */
34
+ async status() {
35
+ return this.http.request({
36
+ method: 'GET',
37
+ path: '/account/status',
38
+ });
39
+ }
40
+ /**
41
+ * Disconnect the X account and remove stored credentials.
42
+ */
43
+ async disconnect() {
44
+ return this.http.request({
45
+ method: 'DELETE',
46
+ path: '/account/disconnect',
47
+ });
48
+ }
49
+ }
50
+ //# sourceMappingURL=account.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"account.js","sourceRoot":"","sources":["../../../src/resources/account.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,eAAe;IACG;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD;;;OAGG;IACH,KAAK,CAAC,OAAO,CACX,MAA4B;QAE5B,MAAM,cAAc,GAAG,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC;QAC1D,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,EAAE,UAAU,IAAI,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC;QAErE,IAAI,CAAC,cAAc,IAAI,CAAC,UAAU,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CACb,yFAAyF,CAC1F,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAA4B,EAAE,CAAC;QACzC,IAAI,MAAM,CAAC,QAAQ;YAAE,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QACrD,IAAI,MAAM,CAAC,QAAQ;YAAE,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QACrD,IAAI,MAAM,CAAC,WAAW;YAAE,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QAC9D,IAAI,MAAM,CAAC,OAAO;YAAE,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAElD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAuB;YAC7C,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,kBAAkB;YACxB,IAAI;SACL,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM;QACV,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAgB;YACtC,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,iBAAiB;SACxB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAuB;YAC7C,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,qBAAqB;SAC5B,CAAC,CAAC;IACL,CAAC;CACF"}
@@ -0,0 +1,26 @@
1
+ import type { HttpClient } from '../http.js';
2
+ import type { Community, Tweet, User, PaginatedResponse, ApiResponse, CommunityTweetsParams, CommunityMembersParams } from '../types.js';
3
+ /**
4
+ * X Communities data.
5
+ *
6
+ * ⚠️ Beta: these endpoints are newly added to the platform and may
7
+ * return a 503 (`ENDPOINT_IN_DEVELOPMENT`) while the backend is being
8
+ * finished. Treat a 503 here as "not ready yet", not a hard failure.
9
+ */
10
+ export declare class CommunitiesResource {
11
+ private readonly http;
12
+ constructor(http: HttpClient);
13
+ /**
14
+ * Get a community's profile.
15
+ */
16
+ get(communityId: string): Promise<ApiResponse<Community>>;
17
+ /**
18
+ * Get tweets from a community's timeline.
19
+ */
20
+ tweets(communityId: string, params?: CommunityTweetsParams): Promise<PaginatedResponse<Tweet>>;
21
+ /**
22
+ * Get members of a community.
23
+ */
24
+ members(communityId: string, params?: CommunityMembersParams): Promise<PaginatedResponse<User>>;
25
+ }
26
+ //# sourceMappingURL=communities.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"communities.d.ts","sourceRoot":"","sources":["../../../src/resources/communities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EACV,SAAS,EACT,KAAK,EACL,IAAI,EACJ,iBAAiB,EACjB,WAAW,EACX,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,aAAa,CAAC;AAErB;;;;;;GAMG;AACH,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;OAEG;IACG,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IAO/D;;OAEG;IACG,MAAM,CACV,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,qBAA0B,GACjC,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAQpC;;OAEG;IACG,OAAO,CACX,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,sBAA2B,GAClC,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;CAOpC"}
@@ -0,0 +1,43 @@
1
+ /**
2
+ * X Communities data.
3
+ *
4
+ * ⚠️ Beta: these endpoints are newly added to the platform and may
5
+ * return a 503 (`ENDPOINT_IN_DEVELOPMENT`) while the backend is being
6
+ * finished. Treat a 503 here as "not ready yet", not a hard failure.
7
+ */
8
+ export class CommunitiesResource {
9
+ http;
10
+ constructor(http) {
11
+ this.http = http;
12
+ }
13
+ /**
14
+ * Get a community's profile.
15
+ */
16
+ async get(communityId) {
17
+ return this.http.request({
18
+ method: 'GET',
19
+ path: `/communities/${encodeURIComponent(communityId)}`,
20
+ });
21
+ }
22
+ /**
23
+ * Get tweets from a community's timeline.
24
+ */
25
+ async tweets(communityId, params = {}) {
26
+ return this.http.request({
27
+ method: 'GET',
28
+ path: `/communities/${encodeURIComponent(communityId)}/tweets`,
29
+ query: { count: params.count, sort: params.sort, cursor: params.cursor },
30
+ });
31
+ }
32
+ /**
33
+ * Get members of a community.
34
+ */
35
+ async members(communityId, params = {}) {
36
+ return this.http.request({
37
+ method: 'GET',
38
+ path: `/communities/${encodeURIComponent(communityId)}/members`,
39
+ query: { count: params.count, sort: params.sort, cursor: params.cursor },
40
+ });
41
+ }
42
+ }
43
+ //# sourceMappingURL=communities.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"communities.js","sourceRoot":"","sources":["../../../src/resources/communities.ts"],"names":[],"mappings":"AAWA;;;;;;GAMG;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,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;SACzE,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;CACF"}
@@ -0,0 +1,24 @@
1
+ import type { HttpClient } from '../http.js';
2
+ import type { Tweet, User, PaginationParams, PaginatedResponse } 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): 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,EAClB,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,gBAAqB,GAC5B,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAQpC;;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,56 @@
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: { count: params.count, cursor: params.cursor },
15
+ });
16
+ }
17
+ /**
18
+ * Get members of a list.
19
+ */
20
+ async members(listId, params = {}) {
21
+ return this.http.request({
22
+ method: 'GET',
23
+ path: `/lists/${encodeURIComponent(listId)}/members`,
24
+ query: { count: params.count, cursor: params.cursor },
25
+ });
26
+ }
27
+ /**
28
+ * Get subscribers of a list.
29
+ */
30
+ async subscribers(listId, params = {}) {
31
+ return this.http.request({
32
+ method: 'GET',
33
+ path: `/lists/${encodeURIComponent(listId)}/subscribers`,
34
+ query: { count: params.count, cursor: params.cursor },
35
+ });
36
+ }
37
+ }
38
+ /**
39
+ * Async generator that auto-paginates a list-based paginated endpoint.
40
+ * @param maxPages Safety limit to prevent infinite loops (default 100).
41
+ */
42
+ export async function* paginateList(method, listId, params = {}, maxPages = DEFAULT_MAX_PAGES) {
43
+ let cursor = params.cursor;
44
+ let hasNext = true;
45
+ let page = 0;
46
+ while (hasNext && page < maxPages) {
47
+ const response = await method(listId, { ...params, cursor });
48
+ for (const item of response.data) {
49
+ yield item;
50
+ }
51
+ cursor = response.meta.cursor;
52
+ hasNext = !!response.meta.has_next && !!cursor;
53
+ page++;
54
+ }
55
+ }
56
+ //# sourceMappingURL=lists.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lists.js","sourceRoot":"","sources":["../../../src/resources/lists.ts"],"names":[],"mappings":"AAQA,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,SAA2B,EAAE;QAE7B,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;YACvB,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,UAAU,kBAAkB,CAAC,MAAM,CAAC,SAAS;YACnD,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,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"}