@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,256 @@
1
+ export interface XCropOptions {
2
+ /** API key (starts with xc_live_ or xc_test_) */
3
+ apiKey: string;
4
+ /** Base URL for the API. Defaults to https://xcrop.io/api/v2 */
5
+ baseUrl?: string;
6
+ /** Request timeout in milliseconds. Defaults to 30000 */
7
+ timeout?: number;
8
+ /** Maximum number of retries on 429/5xx. Defaults to 3 */
9
+ maxRetries?: number;
10
+ }
11
+ export interface ApiMeta {
12
+ latency_ms?: number;
13
+ cached?: boolean;
14
+ total?: number;
15
+ cursor?: string;
16
+ has_next?: boolean;
17
+ }
18
+ export interface ApiResponse<T> {
19
+ data: T;
20
+ meta: ApiMeta;
21
+ }
22
+ export interface ApiErrorResponse {
23
+ error: string;
24
+ code: string;
25
+ }
26
+ export interface PaginationParams {
27
+ count?: number;
28
+ cursor?: string;
29
+ }
30
+ export interface PaginatedResponse<T> {
31
+ data: T[];
32
+ meta: ApiMeta;
33
+ }
34
+ export interface User {
35
+ id: string;
36
+ username: string;
37
+ name: string;
38
+ description?: string;
39
+ profile_image_url?: string;
40
+ profile_banner_url?: string;
41
+ verified?: boolean;
42
+ is_blue_verified?: boolean;
43
+ followers_count: number;
44
+ following_count: number;
45
+ tweet_count: number;
46
+ listed_count?: number;
47
+ created_at: string;
48
+ location?: string;
49
+ url?: string;
50
+ pinned_tweet_id?: string;
51
+ protected?: boolean;
52
+ [key: string]: unknown;
53
+ }
54
+ export interface CheckFollowResult {
55
+ source: string;
56
+ target: string;
57
+ /** Does `source` follow `target`? */
58
+ source_follows_target: boolean;
59
+ /** Does `target` follow `source`? */
60
+ target_follows_source: boolean;
61
+ [key: string]: unknown;
62
+ }
63
+ export interface QualifiedAccountParams {
64
+ /** Minimum follower count required. */
65
+ min_followers?: number;
66
+ /** Minimum account age in days. */
67
+ min_age_days?: number;
68
+ }
69
+ export interface QualifiedAccountResult {
70
+ username: string;
71
+ qualified: boolean;
72
+ followers: number;
73
+ accountAgeDays: number;
74
+ minFollowers: number;
75
+ minAgeDays: number;
76
+ createdAt: string;
77
+ [key: string]: unknown;
78
+ }
79
+ export interface QualifiedNameParams {
80
+ /** Text the display name must contain. */
81
+ contains: string;
82
+ /** Where the text must appear in the display name. Defaults to 'anywhere'. */
83
+ position?: 'anywhere' | 'left' | 'right';
84
+ }
85
+ export interface QualifiedNameResult {
86
+ username: string;
87
+ qualified: boolean;
88
+ name: string;
89
+ contains: string;
90
+ position: string;
91
+ [key: string]: unknown;
92
+ }
93
+ export interface FollowersIdsParams {
94
+ /** Number of IDs to return, up to 5000. Defaults to 5000. */
95
+ count?: number;
96
+ cursor?: string;
97
+ }
98
+ export interface FollowersIdsMeta {
99
+ total?: number;
100
+ has_next_page?: boolean;
101
+ next_cursor?: string | null;
102
+ latency_ms?: number;
103
+ [key: string]: unknown;
104
+ }
105
+ export interface FollowersIdsResponse {
106
+ data: string[];
107
+ meta: FollowersIdsMeta;
108
+ }
109
+ export interface Tweet {
110
+ id: string;
111
+ text: string;
112
+ author_id?: string;
113
+ author?: User;
114
+ created_at: string;
115
+ like_count?: number;
116
+ retweet_count?: number;
117
+ reply_count?: number;
118
+ quote_count?: number;
119
+ bookmark_count?: number;
120
+ view_count?: number;
121
+ lang?: string;
122
+ in_reply_to_tweet_id?: string;
123
+ conversation_id?: string;
124
+ quoted_tweet_id?: string;
125
+ quoted_tweet?: Tweet;
126
+ media?: Media[];
127
+ urls?: UrlEntity[];
128
+ hashtags?: string[];
129
+ [key: string]: unknown;
130
+ }
131
+ export interface Media {
132
+ type: string;
133
+ url?: string;
134
+ preview_image_url?: string;
135
+ width?: number;
136
+ height?: number;
137
+ alt_text?: string;
138
+ [key: string]: unknown;
139
+ }
140
+ export interface UrlEntity {
141
+ url: string;
142
+ expanded_url: string;
143
+ display_url: string;
144
+ [key: string]: unknown;
145
+ }
146
+ export interface SearchTweetsParams {
147
+ query: string;
148
+ count?: number;
149
+ sort?: 'latest' | 'popular' | 'engagement';
150
+ cursor?: string;
151
+ lang?: string;
152
+ min_likes?: number;
153
+ min_retweets?: number;
154
+ exclude_replies?: boolean;
155
+ exclude_retweets?: boolean;
156
+ since?: string;
157
+ until?: string;
158
+ stream?: boolean;
159
+ }
160
+ export interface SearchUsersParams {
161
+ query: string;
162
+ count?: number;
163
+ }
164
+ export interface List {
165
+ id: string;
166
+ name: string;
167
+ description?: string;
168
+ member_count?: number;
169
+ subscriber_count?: number;
170
+ created_at?: string;
171
+ owner?: User;
172
+ [key: string]: unknown;
173
+ }
174
+ export interface TrendingParams {
175
+ /** Country/region for trends. Defaults to 'Worldwide'. */
176
+ country?: string;
177
+ }
178
+ export interface TrendingTopic {
179
+ name: string;
180
+ tweet_count?: number;
181
+ domain?: string;
182
+ context?: string;
183
+ [key: string]: unknown;
184
+ }
185
+ export interface Community {
186
+ id: string;
187
+ name: string;
188
+ description?: string;
189
+ member_count?: number;
190
+ [key: string]: unknown;
191
+ }
192
+ export interface CommunityTweetsParams extends PaginationParams {
193
+ sort?: 'latest' | 'popular' | 'engagement';
194
+ }
195
+ export interface CommunityMembersParams extends PaginationParams {
196
+ sort?: 'default' | 'followers' | 'name';
197
+ }
198
+ export interface ConnectAccountParams {
199
+ username?: string;
200
+ password?: string;
201
+ totp_secret?: string;
202
+ cookies?: {
203
+ auth_token: string;
204
+ ct0: string;
205
+ };
206
+ }
207
+ export interface AccountStatus {
208
+ connected: boolean;
209
+ username?: string;
210
+ [key: string]: unknown;
211
+ }
212
+ export interface CreateTweetParams {
213
+ text: string;
214
+ }
215
+ export interface ReplyTweetParams {
216
+ tweet_id: string;
217
+ text: string;
218
+ }
219
+ export interface QuoteTweetParams {
220
+ tweet_id: string;
221
+ text: string;
222
+ }
223
+ export interface WriteResult {
224
+ success: boolean;
225
+ tweet_id?: string;
226
+ [key: string]: unknown;
227
+ }
228
+ export interface InteractionCheckResult {
229
+ found: boolean;
230
+ tweet_id?: string;
231
+ [key: string]: unknown;
232
+ }
233
+ export type StreamEvent = 'tweet' | 'done' | 'error';
234
+ export interface StreamOptions {
235
+ query: string;
236
+ count?: number;
237
+ sort?: 'latest' | 'popular' | 'engagement';
238
+ lang?: string;
239
+ min_likes?: number;
240
+ min_retweets?: number;
241
+ exclude_replies?: boolean;
242
+ exclude_retweets?: boolean;
243
+ since?: string;
244
+ until?: string;
245
+ }
246
+ export interface RequestOptions {
247
+ method: 'GET' | 'POST' | 'DELETE';
248
+ path: string;
249
+ query?: Record<string, string | number | boolean | undefined>;
250
+ body?: Record<string, unknown>;
251
+ /** Skip automatic retry for this request */
252
+ noRetry?: boolean;
253
+ /** External abort signal (for stream cancellation) */
254
+ signal?: AbortSignal;
255
+ }
256
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ "use strict";
2
+ // ─── Client Options ──────────────────────────────────────────────
3
+ Object.defineProperty(exports, "__esModule", { value: true });
4
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":";AAAA,oEAAoE"}
@@ -0,0 +1,65 @@
1
+ import { UsersResource } from './resources/users.js';
2
+ import { TweetsResource } from './resources/tweets.js';
3
+ import { SearchResource } from './resources/search.js';
4
+ import { ListsResource } from './resources/lists.js';
5
+ import { TrendingResource } from './resources/trending.js';
6
+ import { CommunitiesResource } from './resources/communities.js';
7
+ import { AccountResource } from './resources/account.js';
8
+ import { StreamResource } from './resources/stream.js';
9
+ import type { XCropOptions, PaginationParams, CommunityTweetsParams, CommunityMembersParams, Tweet, User } from './types.js';
10
+ type UserTweetsFn = UsersResource['tweets'] & {
11
+ paginate(username: string, params?: PaginationParams): AsyncGenerator<Tweet, void, undefined>;
12
+ };
13
+ interface PaginateHelpers {
14
+ userTweets(username: string, params?: PaginationParams): AsyncGenerator<Tweet, void, undefined>;
15
+ userMentions(username: string, params?: PaginationParams): AsyncGenerator<Tweet, void, undefined>;
16
+ userFollowers(username: string, params?: PaginationParams): AsyncGenerator<User, void, undefined>;
17
+ userFollowing(username: string, params?: PaginationParams): AsyncGenerator<User, void, undefined>;
18
+ userReplies(username: string, params?: PaginationParams): AsyncGenerator<Tweet, void, undefined>;
19
+ userMedia(username: string, params?: PaginationParams): AsyncGenerator<Tweet, void, undefined>;
20
+ userVerifiedFollowers(username: string, params?: PaginationParams): AsyncGenerator<User, void, undefined>;
21
+ tweetConversation(tweetId: string, params?: PaginationParams): AsyncGenerator<Tweet, void, undefined>;
22
+ tweetQuotes(tweetId: string, params?: PaginationParams): AsyncGenerator<Tweet, void, undefined>;
23
+ listTweets(listId: string, params?: PaginationParams): AsyncGenerator<Tweet, void, undefined>;
24
+ listMembers(listId: string, params?: PaginationParams): AsyncGenerator<User, void, undefined>;
25
+ listSubscribers(listId: string, params?: PaginationParams): AsyncGenerator<User, void, undefined>;
26
+ communityTweets(communityId: string, params?: CommunityTweetsParams): AsyncGenerator<Tweet, void, undefined>;
27
+ communityMembers(communityId: string, params?: CommunityMembersParams): AsyncGenerator<User, void, undefined>;
28
+ }
29
+ /**
30
+ * XCROP SDK client for the X/Twitter data intelligence API.
31
+ *
32
+ * @example
33
+ * ```ts
34
+ * import { XCrop } from '@xcrop/sdk';
35
+ *
36
+ * const client = new XCrop({ apiKey: 'xc_live_...' });
37
+ * const user = await client.users.get('elonmusk');
38
+ * ```
39
+ */
40
+ export declare class XCrop {
41
+ private readonly http;
42
+ /** User profile, tweets, followers, and follow-check endpoints. */
43
+ readonly users: UsersResource & {
44
+ tweets: UserTweetsFn;
45
+ };
46
+ /** Tweet data, write operations, interactions, and checks. */
47
+ readonly tweets: TweetsResource;
48
+ /** Search tweets and users, with streaming support. */
49
+ readonly search: SearchResource;
50
+ /** Twitter list data. */
51
+ readonly lists: ListsResource;
52
+ /** Trending topics. */
53
+ readonly trending: TrendingResource;
54
+ /** X Communities data (beta — may return 503 while under development). */
55
+ readonly communities: CommunitiesResource;
56
+ /** X account connection management for write operations. */
57
+ readonly account: AccountResource;
58
+ /** Real-time SSE stream. */
59
+ readonly stream: StreamResource;
60
+ /** Pagination helper — auto-iterate through all pages. */
61
+ readonly paginate: PaginateHelpers;
62
+ constructor(options: XCropOptions);
63
+ }
64
+ export {};
65
+ //# sourceMappingURL=client.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,80 @@
1
+ import { HttpClient } from './http.js';
2
+ import { UsersResource, paginateUser } from './resources/users.js';
3
+ import { TweetsResource, paginateTweet } from './resources/tweets.js';
4
+ import { SearchResource } from './resources/search.js';
5
+ import { ListsResource, paginateList } from './resources/lists.js';
6
+ import { TrendingResource } from './resources/trending.js';
7
+ import { CommunitiesResource } from './resources/communities.js';
8
+ import { AccountResource } from './resources/account.js';
9
+ import { StreamResource } from './resources/stream.js';
10
+ /**
11
+ * XCROP SDK client for the X/Twitter data intelligence API.
12
+ *
13
+ * @example
14
+ * ```ts
15
+ * import { XCrop } from '@xcrop/sdk';
16
+ *
17
+ * const client = new XCrop({ apiKey: 'xc_live_...' });
18
+ * const user = await client.users.get('elonmusk');
19
+ * ```
20
+ */
21
+ export class XCrop {
22
+ http;
23
+ /** User profile, tweets, followers, and follow-check endpoints. */
24
+ users;
25
+ /** Tweet data, write operations, interactions, and checks. */
26
+ tweets;
27
+ /** Search tweets and users, with streaming support. */
28
+ search;
29
+ /** Twitter list data. */
30
+ lists;
31
+ /** Trending topics. */
32
+ trending;
33
+ /** X Communities data (beta — may return 503 while under development). */
34
+ communities;
35
+ /** X account connection management for write operations. */
36
+ account;
37
+ /** Real-time SSE stream. */
38
+ stream;
39
+ /** Pagination helper — auto-iterate through all pages. */
40
+ paginate;
41
+ constructor(options) {
42
+ if (!options.apiKey) {
43
+ throw new Error('apiKey is required');
44
+ }
45
+ this.http = new HttpClient(options);
46
+ // Initialize resources
47
+ const usersBase = new UsersResource(this.http);
48
+ this.tweets = new TweetsResource(this.http);
49
+ this.search = new SearchResource(this.http);
50
+ this.lists = new ListsResource(this.http);
51
+ this.trending = new TrendingResource(this.http);
52
+ this.communities = new CommunitiesResource(this.http);
53
+ this.account = new AccountResource(this.http);
54
+ this.stream = new StreamResource(this.http);
55
+ // Build users.tweets with nested .paginate()
56
+ const boundTweets = usersBase.tweets.bind(usersBase);
57
+ const tweetsFn = Object.assign(boundTweets, {
58
+ paginate: (username, params) => paginateUser(boundTweets, username, params),
59
+ });
60
+ this.users = Object.assign(usersBase, { tweets: tweetsFn });
61
+ // Build top-level paginate helpers
62
+ this.paginate = {
63
+ userTweets: (username, params) => paginateUser(boundTweets, username, params),
64
+ userMentions: (username, params) => paginateUser(usersBase.mentions.bind(usersBase), username, params),
65
+ userFollowers: (username, params) => paginateUser(usersBase.followers.bind(usersBase), username, params),
66
+ userFollowing: (username, params) => paginateUser(usersBase.following.bind(usersBase), username, params),
67
+ userReplies: (username, params) => paginateUser(usersBase.replies.bind(usersBase), username, params),
68
+ userMedia: (username, params) => paginateUser(usersBase.media.bind(usersBase), username, params),
69
+ userVerifiedFollowers: (username, params) => paginateUser(usersBase.verifiedFollowers.bind(usersBase), username, params),
70
+ tweetConversation: (tweetId, params) => paginateTweet(this.tweets.conversation.bind(this.tweets), tweetId, params),
71
+ tweetQuotes: (tweetId, params) => paginateTweet(this.tweets.quotes.bind(this.tweets), tweetId, params),
72
+ listTweets: (listId, params) => paginateList(this.lists.tweets.bind(this.lists), listId, params),
73
+ listMembers: (listId, params) => paginateList(this.lists.members.bind(this.lists), listId, params),
74
+ listSubscribers: (listId, params) => paginateList(this.lists.subscribers.bind(this.lists), listId, params),
75
+ communityTweets: (communityId, params) => paginateList(this.communities.tweets.bind(this.communities), communityId, params),
76
+ communityMembers: (communityId, params) => paginateList(this.communities.members.bind(this.communities), communityId, params),
77
+ };
78
+ }
79
+ }
80
+ //# sourceMappingURL=client.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,38 @@
1
+ /**
2
+ * Base error class for all XCROP SDK errors.
3
+ */
4
+ export declare class XCropError extends Error {
5
+ readonly status: number;
6
+ readonly code: string;
7
+ readonly headers: Record<string, string>;
8
+ constructor(message: string, status: number, code: string, headers?: Record<string, string>);
9
+ }
10
+ /**
11
+ * Thrown when authentication fails (401).
12
+ */
13
+ export declare class AuthError extends XCropError {
14
+ constructor(message: string, headers?: Record<string, string>);
15
+ }
16
+ /**
17
+ * Thrown when rate limit is exceeded (429).
18
+ * Contains retry timing information.
19
+ */
20
+ export declare class RateLimitError extends XCropError {
21
+ readonly retryAfter: number | null;
22
+ readonly remaining: number;
23
+ readonly limit: number;
24
+ constructor(message: string, headers?: Record<string, string>);
25
+ }
26
+ /**
27
+ * Thrown when a resource is not found (404).
28
+ */
29
+ export declare class NotFoundError extends XCropError {
30
+ constructor(message: string, headers?: Record<string, string>);
31
+ }
32
+ /**
33
+ * Thrown when the request is forbidden (403).
34
+ */
35
+ export declare class ForbiddenError extends XCropError {
36
+ constructor(message: string, headers?: Record<string, string>);
37
+ }
38
+ //# sourceMappingURL=errors.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBAG9C,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM;CASvC;AAED;;GAEG;AACH,qBAAa,SAAU,SAAQ,UAAU;gBAC3B,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM;CAIlE;AAED;;;GAGG;AACH,qBAAa,cAAe,SAAQ,UAAU;IAC5C,SAAgB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,SAAgB,KAAK,EAAE,MAAM,CAAC;gBAG5B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM;CAUvC;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,UAAU;gBAC/B,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM;CAIlE;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,UAAU;gBAChC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM;CAIlE"}
@@ -0,0 +1,62 @@
1
+ /**
2
+ * Base error class for all XCROP SDK errors.
3
+ */
4
+ export class XCropError extends Error {
5
+ status;
6
+ code;
7
+ headers;
8
+ constructor(message, status, code, headers = {}) {
9
+ super(message);
10
+ this.name = 'XCropError';
11
+ this.status = status;
12
+ this.code = code;
13
+ this.headers = headers;
14
+ Object.setPrototypeOf(this, new.target.prototype);
15
+ }
16
+ }
17
+ /**
18
+ * Thrown when authentication fails (401).
19
+ */
20
+ export class AuthError extends XCropError {
21
+ constructor(message, headers = {}) {
22
+ super(message, 401, 'AUTH_ERROR', headers);
23
+ this.name = 'AuthError';
24
+ }
25
+ }
26
+ /**
27
+ * Thrown when rate limit is exceeded (429).
28
+ * Contains retry timing information.
29
+ */
30
+ export class RateLimitError extends XCropError {
31
+ retryAfter;
32
+ remaining;
33
+ limit;
34
+ constructor(message, headers = {}) {
35
+ super(message, 429, 'RATE_LIMIT', headers);
36
+ this.name = 'RateLimitError';
37
+ this.retryAfter = headers['retry-after']
38
+ ? parseInt(headers['retry-after'], 10)
39
+ : null;
40
+ this.remaining = parseInt(headers['x-ratelimit-remaining'] || '0', 10);
41
+ this.limit = parseInt(headers['x-ratelimit-limit'] || '0', 10);
42
+ }
43
+ }
44
+ /**
45
+ * Thrown when a resource is not found (404).
46
+ */
47
+ export class NotFoundError extends XCropError {
48
+ constructor(message, headers = {}) {
49
+ super(message, 404, 'NOT_FOUND', headers);
50
+ this.name = 'NotFoundError';
51
+ }
52
+ }
53
+ /**
54
+ * Thrown when the request is forbidden (403).
55
+ */
56
+ export class ForbiddenError extends XCropError {
57
+ constructor(message, headers = {}) {
58
+ super(message, 403, 'FORBIDDEN', headers);
59
+ this.name = 'ForbiddenError';
60
+ }
61
+ }
62
+ //# sourceMappingURL=errors.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,UAAW,SAAQ,KAAK;IACnB,MAAM,CAAS;IACf,IAAI,CAAS;IACb,OAAO,CAAyB;IAEhD,YACE,OAAe,EACf,MAAc,EACd,IAAY,EACZ,UAAkC,EAAE;QAEpC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,SAAU,SAAQ,UAAU;IACvC,YAAY,OAAe,EAAE,UAAkC,EAAE;QAC/D,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,cAAe,SAAQ,UAAU;IAC5B,UAAU,CAAgB;IAC1B,SAAS,CAAS;IAClB,KAAK,CAAS;IAE9B,YACE,OAAe,EACf,UAAkC,EAAE;QAEpC,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC;YACtC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,EAAE,CAAC;YACtC,CAAC,CAAC,IAAI,CAAC;QACT,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,uBAAuB,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;QACvE,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,mBAAmB,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;IACjE,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,UAAU;IAC3C,YAAY,OAAe,EAAE,UAAkC,EAAE;QAC/D,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,UAAU;IAC5C,YAAY,OAAe,EAAE,UAAkC,EAAE;QAC/D,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF"}
@@ -0,0 +1,28 @@
1
+ import type { ApiResponse, PaginatedResponse, RequestOptions, XCropOptions } from './types.js';
2
+ /** SDK version — single source of truth */
3
+ export declare const SDK_VERSION = "1.0.1";
4
+ /**
5
+ * Low-level HTTP client with automatic retry, backoff, and error mapping.
6
+ */
7
+ export declare class HttpClient {
8
+ private readonly apiKey;
9
+ private readonly baseUrl;
10
+ private readonly timeout;
11
+ private readonly maxRetries;
12
+ constructor(options: XCropOptions);
13
+ /**
14
+ * Execute a request with automatic retry on 429 and 5xx errors.
15
+ * Returns the parsed JSON response with proper typing for both
16
+ * single-item and paginated responses.
17
+ */
18
+ request<T>(options: RequestOptions): Promise<ApiResponse<T>>;
19
+ request<T>(options: RequestOptions): Promise<PaginatedResponse<T>>;
20
+ /**
21
+ * Execute a request and return a raw Response for streaming.
22
+ * Includes retry logic for 429/5xx (same as request()).
23
+ * Timeout only applies to the initial connection, not to the stream body.
24
+ */
25
+ requestRaw(options: RequestOptions): Promise<Response>;
26
+ private buildUrl;
27
+ }
28
+ //# sourceMappingURL=http.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/http.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAM/F,2CAA2C;AAC3C,eAAO,MAAM,WAAW,UAAU,CAAC;AAGnC;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,OAAO,EAAE,YAAY;IAOjC;;;;OAIG;IACG,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAC5D,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IA2HxE;;;;OAIG;IACG,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC;IAgH5D,OAAO,CAAC,QAAQ;CAcjB"}