@datashift/sdk 0.3.2 → 0.5.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.
- package/README.md +70 -6
- package/dist/index.d.mts +31 -5
- package/dist/index.d.ts +31 -5
- package/dist/index.js +18 -2
- package/dist/index.js.map +1 -1
- package/dist/index.mjs +18 -3
- package/dist/index.mjs.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -7,7 +7,7 @@ TypeScript SDK for integrating human-in-the-loop checkpoints into AI agent workf
|
|
|
7
7
|
|
|
8
8
|
## Overview
|
|
9
9
|
|
|
10
|
-
[Datashift](https://datashift.io) enables AI agents to submit tasks for human review before committing changes. Create review queues, define review types (approval, classification, labeling, scoring, augmentation), and integrate human oversight into any AI workflow — via [REST API](https://datashift.io/docs/api) or [MCP](https://datashift.io/docs/mcp).
|
|
10
|
+
[Datashift](https://datashift.io) enables AI agents to submit tasks for human review before committing changes. Create review queues, define review types (approval, classification, labeling, multiple_choice, scoring, augmentation), and integrate human oversight into any AI workflow — via [REST API](https://datashift.io/docs/api) or [MCP](https://datashift.io/docs/mcp).
|
|
11
11
|
|
|
12
12
|
## Installation
|
|
13
13
|
|
|
@@ -85,7 +85,7 @@ const task = await datashift.task.get(taskId);
|
|
|
85
85
|
// List tasks
|
|
86
86
|
const tasks = await datashift.task.list({
|
|
87
87
|
queueId?: string;
|
|
88
|
-
state?: 'pending' | 'queued' | 'reviewed';
|
|
88
|
+
state?: 'pending' | 'queued' | 'reviewed' | 'canceled';
|
|
89
89
|
});
|
|
90
90
|
|
|
91
91
|
// Wait for review
|
|
@@ -96,6 +96,8 @@ const reviewed = await datashift.task.waitForReview(taskId, {
|
|
|
96
96
|
});
|
|
97
97
|
```
|
|
98
98
|
|
|
99
|
+
`waitForReview` throws `TaskCanceledError` if the task is canceled before it is reviewed, and `TimeoutError` if no review arrives within `timeout`.
|
|
100
|
+
|
|
99
101
|
### Queue Operations
|
|
100
102
|
|
|
101
103
|
```typescript
|
|
@@ -232,6 +234,8 @@ interface WebhookTaskData {
|
|
|
232
234
|
summary: string | null;
|
|
233
235
|
data: Record<string, unknown>;
|
|
234
236
|
metadata: Record<string, unknown>;
|
|
237
|
+
choices: TaskChoice[] | null; // multiple_choice queues only
|
|
238
|
+
max_selections: number | null; // per-task override; multiple_choice only
|
|
235
239
|
sla_deadline: string | null;
|
|
236
240
|
reviewed_at: string | null;
|
|
237
241
|
created_at: string;
|
|
@@ -246,7 +250,7 @@ interface WebhookQueueData {
|
|
|
246
250
|
interface WebhookReviewData {
|
|
247
251
|
result: string[];
|
|
248
252
|
data: Record<string, unknown>;
|
|
249
|
-
|
|
253
|
+
feedback: string | null;
|
|
250
254
|
reviewer: { name: string; type: string };
|
|
251
255
|
created_at: string;
|
|
252
256
|
}
|
|
@@ -264,17 +268,29 @@ interface Task {
|
|
|
264
268
|
id: string;
|
|
265
269
|
queue_id: string;
|
|
266
270
|
external_id: string | null;
|
|
267
|
-
state: 'pending' | 'queued' | 'reviewed';
|
|
271
|
+
state: 'pending' | 'queued' | 'reviewed' | 'canceled';
|
|
268
272
|
data: Record<string, unknown>;
|
|
269
273
|
context: Record<string, unknown>;
|
|
270
274
|
metadata: Record<string, unknown>;
|
|
275
|
+
choices: TaskChoice[] | null; // multiple_choice queues only
|
|
276
|
+
max_selections: number | null; // per-task override; multiple_choice only
|
|
271
277
|
summary: string | null;
|
|
272
278
|
sla_deadline: string | null;
|
|
273
279
|
reviewed_at: string | null;
|
|
280
|
+
canceled_at: string | null;
|
|
274
281
|
created_at: string;
|
|
275
282
|
updated_at: string;
|
|
276
283
|
reviews?: Review[];
|
|
277
284
|
}
|
|
285
|
+
|
|
286
|
+
interface TaskChoice {
|
|
287
|
+
key: string;
|
|
288
|
+
label: string;
|
|
289
|
+
description?: string | null;
|
|
290
|
+
// Structured per-choice fields the viewer can render alongside the label
|
|
291
|
+
// (e.g., address/EIN for an entity-match candidate).
|
|
292
|
+
data?: Record<string, unknown> | null;
|
|
293
|
+
}
|
|
278
294
|
```
|
|
279
295
|
|
|
280
296
|
### Queue
|
|
@@ -285,14 +301,59 @@ interface Queue {
|
|
|
285
301
|
key: string;
|
|
286
302
|
name: string;
|
|
287
303
|
description: string | null;
|
|
288
|
-
review_type:
|
|
304
|
+
review_type:
|
|
305
|
+
| 'approval'
|
|
306
|
+
| 'labeling'
|
|
307
|
+
| 'classification'
|
|
308
|
+
| 'multiple_choice'
|
|
309
|
+
| 'scoring'
|
|
310
|
+
| 'augmentation';
|
|
289
311
|
review_options: ReviewOption[];
|
|
312
|
+
// Selection primitives. review_type sets sensible defaults; explicit
|
|
313
|
+
// values override.
|
|
314
|
+
max_selections: number | null; // 1 = single-select, null = unbounded
|
|
315
|
+
result_required: boolean; // if false, empty selection is valid
|
|
316
|
+
feedback_required: 'never' | 'always' | 'when_empty';
|
|
290
317
|
assignment: 'manual' | 'round_robin' | 'ai_first';
|
|
291
318
|
sla_minutes: number | null;
|
|
292
319
|
deleted_at: string | null;
|
|
293
320
|
}
|
|
294
321
|
```
|
|
295
322
|
|
|
323
|
+
#### Multiple choice
|
|
324
|
+
|
|
325
|
+
Use `review_type: 'multiple_choice'` when the candidate list varies per
|
|
326
|
+
task (e.g., entity matching, output ranking, picking the best of N
|
|
327
|
+
generated drafts). Ship the candidates with the task instead of the
|
|
328
|
+
queue:
|
|
329
|
+
|
|
330
|
+
```typescript
|
|
331
|
+
await datashift.task.submit({
|
|
332
|
+
queueKey: 'entity-match',
|
|
333
|
+
summary: 'Verify business identity',
|
|
334
|
+
data: { name: 'ACME Plumbing LLC', ein: '12-3456789' },
|
|
335
|
+
choices: [
|
|
336
|
+
{
|
|
337
|
+
key: 'cand_1',
|
|
338
|
+
label: 'ACME Plumbing LLC',
|
|
339
|
+
description: 'EIN 12-3456789',
|
|
340
|
+
data: { address: '100 Main St, Austin TX', confidence: 0.92 },
|
|
341
|
+
},
|
|
342
|
+
{
|
|
343
|
+
key: 'cand_2',
|
|
344
|
+
label: 'Acme Plumbing Inc',
|
|
345
|
+
description: 'EIN 11-2233445',
|
|
346
|
+
data: { address: '220 Oak St, Houston TX', confidence: 0.71 },
|
|
347
|
+
},
|
|
348
|
+
],
|
|
349
|
+
});
|
|
350
|
+
```
|
|
351
|
+
|
|
352
|
+
If none of the candidates is a real match, the reviewer can submit an
|
|
353
|
+
empty result. Configure the queue with `result_required: false` and
|
|
354
|
+
`feedback_required: 'when_empty'` to require an explanation in that case;
|
|
355
|
+
no reserved `__none__` key needed.
|
|
356
|
+
|
|
296
357
|
### Review
|
|
297
358
|
|
|
298
359
|
```typescript
|
|
@@ -302,7 +363,7 @@ interface Review {
|
|
|
302
363
|
reviewer_id: string | null;
|
|
303
364
|
result: string[];
|
|
304
365
|
data: Record<string, unknown>;
|
|
305
|
-
|
|
366
|
+
feedback: string | null;
|
|
306
367
|
created_at: string;
|
|
307
368
|
}
|
|
308
369
|
```
|
|
@@ -345,6 +406,7 @@ import {
|
|
|
345
406
|
NotFoundError,
|
|
346
407
|
ValidationError,
|
|
347
408
|
TimeoutError,
|
|
409
|
+
TaskCanceledError,
|
|
348
410
|
RateLimitError,
|
|
349
411
|
ServerError,
|
|
350
412
|
} from '@datashift/sdk';
|
|
@@ -354,6 +416,8 @@ try {
|
|
|
354
416
|
} catch (error) {
|
|
355
417
|
if (error instanceof TimeoutError) {
|
|
356
418
|
console.log('Review not finished in time');
|
|
419
|
+
} else if (error instanceof TaskCanceledError) {
|
|
420
|
+
console.log(`Task canceled at ${error.task.canceled_at}`);
|
|
357
421
|
} else if (error instanceof AuthenticationError) {
|
|
358
422
|
console.log('Invalid credentials');
|
|
359
423
|
} else if (error instanceof NotFoundError) {
|
package/dist/index.d.mts
CHANGED
|
@@ -1,6 +1,12 @@
|
|
|
1
1
|
import { AxiosInstance } from 'axios';
|
|
2
2
|
|
|
3
|
-
type TaskState = 'pending' | 'queued' | 'reviewed';
|
|
3
|
+
type TaskState = 'pending' | 'queued' | 'reviewed' | 'canceled';
|
|
4
|
+
interface TaskChoice {
|
|
5
|
+
key: string;
|
|
6
|
+
label: string;
|
|
7
|
+
description?: string | null;
|
|
8
|
+
data?: Record<string, unknown> | null;
|
|
9
|
+
}
|
|
4
10
|
interface Task {
|
|
5
11
|
id: string;
|
|
6
12
|
organization_id: string;
|
|
@@ -10,9 +16,12 @@ interface Task {
|
|
|
10
16
|
data: Record<string, unknown>;
|
|
11
17
|
context: Record<string, unknown>;
|
|
12
18
|
metadata: Record<string, unknown>;
|
|
19
|
+
choices: TaskChoice[] | null;
|
|
20
|
+
max_selections: number | null;
|
|
13
21
|
summary: string | null;
|
|
14
22
|
sla_deadline: string | null;
|
|
15
23
|
reviewed_at: string | null;
|
|
24
|
+
canceled_at: string | null;
|
|
16
25
|
created_at: string;
|
|
17
26
|
updated_at: string;
|
|
18
27
|
queue?: Queue;
|
|
@@ -29,8 +38,11 @@ interface SubmitTaskInput {
|
|
|
29
38
|
metadata?: Record<string, unknown>;
|
|
30
39
|
summary?: string;
|
|
31
40
|
externalId?: string;
|
|
41
|
+
choices?: TaskChoice[];
|
|
42
|
+
maxSelections?: number;
|
|
32
43
|
}
|
|
33
|
-
type ReviewType = 'approval' | 'labeling' | 'classification' | 'scoring' | 'augmentation';
|
|
44
|
+
type ReviewType = 'approval' | 'labeling' | 'classification' | 'multiple_choice' | 'scoring' | 'augmentation';
|
|
45
|
+
type FeedbackRequired = 'never' | 'always' | 'when_empty';
|
|
34
46
|
type AssignmentStrategy = 'manual' | 'round_robin' | 'ai_first' | 'ai_last';
|
|
35
47
|
interface ReviewOption {
|
|
36
48
|
id: string;
|
|
@@ -45,7 +57,9 @@ interface Queue {
|
|
|
45
57
|
description: string | null;
|
|
46
58
|
review_type: ReviewType;
|
|
47
59
|
review_options: ReviewOption[];
|
|
48
|
-
|
|
60
|
+
max_selections: number | null;
|
|
61
|
+
result_required: boolean;
|
|
62
|
+
feedback_required: FeedbackRequired;
|
|
49
63
|
assignment: AssignmentStrategy;
|
|
50
64
|
sla_minutes: number | null;
|
|
51
65
|
deleted_at: string | null;
|
|
@@ -99,6 +113,8 @@ interface WebhookTaskData {
|
|
|
99
113
|
summary: string | null;
|
|
100
114
|
data: Record<string, unknown>;
|
|
101
115
|
metadata: Record<string, unknown>;
|
|
116
|
+
choices: TaskChoice[] | null;
|
|
117
|
+
max_selections: number | null;
|
|
102
118
|
sla_deadline: string | null;
|
|
103
119
|
reviewed_at: string | null;
|
|
104
120
|
created_at: string;
|
|
@@ -160,7 +176,10 @@ declare class TaskResource {
|
|
|
160
176
|
state?: string;
|
|
161
177
|
}): Promise<Task[]>;
|
|
162
178
|
/**
|
|
163
|
-
* Wait for a task to be reviewed
|
|
179
|
+
* Wait for a task to be reviewed.
|
|
180
|
+
*
|
|
181
|
+
* @throws {TaskCanceledError} If the task is canceled before it is reviewed.
|
|
182
|
+
* @throws {TimeoutError} If the task is not reviewed within `timeout`.
|
|
164
183
|
*/
|
|
165
184
|
waitForReview(taskId: string, options?: WaitOptions): Promise<Task>;
|
|
166
185
|
private sleep;
|
|
@@ -260,6 +279,13 @@ declare class ValidationError extends DatashiftError {
|
|
|
260
279
|
declare class TimeoutError extends DatashiftError {
|
|
261
280
|
constructor(message?: string);
|
|
262
281
|
}
|
|
282
|
+
/**
|
|
283
|
+
* Thrown by `waitForReview` when the task is canceled before it is reviewed
|
|
284
|
+
*/
|
|
285
|
+
declare class TaskCanceledError extends DatashiftError {
|
|
286
|
+
task: Task;
|
|
287
|
+
constructor(task: Task);
|
|
288
|
+
}
|
|
263
289
|
/**
|
|
264
290
|
* Thrown when rate limited
|
|
265
291
|
*/
|
|
@@ -274,4 +300,4 @@ declare class ServerError extends DatashiftError {
|
|
|
274
300
|
constructor(message?: string);
|
|
275
301
|
}
|
|
276
302
|
|
|
277
|
-
export { type AssignmentStrategy, AuthenticationError, DatashiftError, DatashiftRestClient, type ListReviewsFilters, NotFoundError, type Queue, RateLimitError, type RestClientConfig, type Review, type ReviewOption, type ReviewResult, type ReviewType, ServerError, type SubmitTaskInput, type Task, type TaskCreatedWebhookEvent, type TaskReviewedWebhookEvent, type TaskState, type TaskStatus, TimeoutError, ValidationError, type WaitOptions, type WebhookEvent, type WebhookEventType, type WebhookQueueData, type WebhookReviewData, type WebhookTaskData };
|
|
303
|
+
export { type AssignmentStrategy, AuthenticationError, DatashiftError, DatashiftRestClient, type ListReviewsFilters, NotFoundError, type Queue, RateLimitError, type RestClientConfig, type Review, type ReviewOption, type ReviewResult, type ReviewType, ServerError, type SubmitTaskInput, type Task, TaskCanceledError, type TaskCreatedWebhookEvent, type TaskReviewedWebhookEvent, type TaskState, type TaskStatus, TimeoutError, ValidationError, type WaitOptions, type WebhookEvent, type WebhookEventType, type WebhookQueueData, type WebhookReviewData, type WebhookTaskData };
|
package/dist/index.d.ts
CHANGED
|
@@ -1,6 +1,12 @@
|
|
|
1
1
|
import { AxiosInstance } from 'axios';
|
|
2
2
|
|
|
3
|
-
type TaskState = 'pending' | 'queued' | 'reviewed';
|
|
3
|
+
type TaskState = 'pending' | 'queued' | 'reviewed' | 'canceled';
|
|
4
|
+
interface TaskChoice {
|
|
5
|
+
key: string;
|
|
6
|
+
label: string;
|
|
7
|
+
description?: string | null;
|
|
8
|
+
data?: Record<string, unknown> | null;
|
|
9
|
+
}
|
|
4
10
|
interface Task {
|
|
5
11
|
id: string;
|
|
6
12
|
organization_id: string;
|
|
@@ -10,9 +16,12 @@ interface Task {
|
|
|
10
16
|
data: Record<string, unknown>;
|
|
11
17
|
context: Record<string, unknown>;
|
|
12
18
|
metadata: Record<string, unknown>;
|
|
19
|
+
choices: TaskChoice[] | null;
|
|
20
|
+
max_selections: number | null;
|
|
13
21
|
summary: string | null;
|
|
14
22
|
sla_deadline: string | null;
|
|
15
23
|
reviewed_at: string | null;
|
|
24
|
+
canceled_at: string | null;
|
|
16
25
|
created_at: string;
|
|
17
26
|
updated_at: string;
|
|
18
27
|
queue?: Queue;
|
|
@@ -29,8 +38,11 @@ interface SubmitTaskInput {
|
|
|
29
38
|
metadata?: Record<string, unknown>;
|
|
30
39
|
summary?: string;
|
|
31
40
|
externalId?: string;
|
|
41
|
+
choices?: TaskChoice[];
|
|
42
|
+
maxSelections?: number;
|
|
32
43
|
}
|
|
33
|
-
type ReviewType = 'approval' | 'labeling' | 'classification' | 'scoring' | 'augmentation';
|
|
44
|
+
type ReviewType = 'approval' | 'labeling' | 'classification' | 'multiple_choice' | 'scoring' | 'augmentation';
|
|
45
|
+
type FeedbackRequired = 'never' | 'always' | 'when_empty';
|
|
34
46
|
type AssignmentStrategy = 'manual' | 'round_robin' | 'ai_first' | 'ai_last';
|
|
35
47
|
interface ReviewOption {
|
|
36
48
|
id: string;
|
|
@@ -45,7 +57,9 @@ interface Queue {
|
|
|
45
57
|
description: string | null;
|
|
46
58
|
review_type: ReviewType;
|
|
47
59
|
review_options: ReviewOption[];
|
|
48
|
-
|
|
60
|
+
max_selections: number | null;
|
|
61
|
+
result_required: boolean;
|
|
62
|
+
feedback_required: FeedbackRequired;
|
|
49
63
|
assignment: AssignmentStrategy;
|
|
50
64
|
sla_minutes: number | null;
|
|
51
65
|
deleted_at: string | null;
|
|
@@ -99,6 +113,8 @@ interface WebhookTaskData {
|
|
|
99
113
|
summary: string | null;
|
|
100
114
|
data: Record<string, unknown>;
|
|
101
115
|
metadata: Record<string, unknown>;
|
|
116
|
+
choices: TaskChoice[] | null;
|
|
117
|
+
max_selections: number | null;
|
|
102
118
|
sla_deadline: string | null;
|
|
103
119
|
reviewed_at: string | null;
|
|
104
120
|
created_at: string;
|
|
@@ -160,7 +176,10 @@ declare class TaskResource {
|
|
|
160
176
|
state?: string;
|
|
161
177
|
}): Promise<Task[]>;
|
|
162
178
|
/**
|
|
163
|
-
* Wait for a task to be reviewed
|
|
179
|
+
* Wait for a task to be reviewed.
|
|
180
|
+
*
|
|
181
|
+
* @throws {TaskCanceledError} If the task is canceled before it is reviewed.
|
|
182
|
+
* @throws {TimeoutError} If the task is not reviewed within `timeout`.
|
|
164
183
|
*/
|
|
165
184
|
waitForReview(taskId: string, options?: WaitOptions): Promise<Task>;
|
|
166
185
|
private sleep;
|
|
@@ -260,6 +279,13 @@ declare class ValidationError extends DatashiftError {
|
|
|
260
279
|
declare class TimeoutError extends DatashiftError {
|
|
261
280
|
constructor(message?: string);
|
|
262
281
|
}
|
|
282
|
+
/**
|
|
283
|
+
* Thrown by `waitForReview` when the task is canceled before it is reviewed
|
|
284
|
+
*/
|
|
285
|
+
declare class TaskCanceledError extends DatashiftError {
|
|
286
|
+
task: Task;
|
|
287
|
+
constructor(task: Task);
|
|
288
|
+
}
|
|
263
289
|
/**
|
|
264
290
|
* Thrown when rate limited
|
|
265
291
|
*/
|
|
@@ -274,4 +300,4 @@ declare class ServerError extends DatashiftError {
|
|
|
274
300
|
constructor(message?: string);
|
|
275
301
|
}
|
|
276
302
|
|
|
277
|
-
export { type AssignmentStrategy, AuthenticationError, DatashiftError, DatashiftRestClient, type ListReviewsFilters, NotFoundError, type Queue, RateLimitError, type RestClientConfig, type Review, type ReviewOption, type ReviewResult, type ReviewType, ServerError, type SubmitTaskInput, type Task, type TaskCreatedWebhookEvent, type TaskReviewedWebhookEvent, type TaskState, type TaskStatus, TimeoutError, ValidationError, type WaitOptions, type WebhookEvent, type WebhookEventType, type WebhookQueueData, type WebhookReviewData, type WebhookTaskData };
|
|
303
|
+
export { type AssignmentStrategy, AuthenticationError, DatashiftError, DatashiftRestClient, type ListReviewsFilters, NotFoundError, type Queue, RateLimitError, type RestClientConfig, type Review, type ReviewOption, type ReviewResult, type ReviewType, ServerError, type SubmitTaskInput, type Task, TaskCanceledError, type TaskCreatedWebhookEvent, type TaskReviewedWebhookEvent, type TaskState, type TaskStatus, TimeoutError, ValidationError, type WaitOptions, type WebhookEvent, type WebhookEventType, type WebhookQueueData, type WebhookReviewData, type WebhookTaskData };
|
package/dist/index.js
CHANGED
|
@@ -61,6 +61,13 @@ var TimeoutError = class extends DatashiftError {
|
|
|
61
61
|
this.name = "TimeoutError";
|
|
62
62
|
}
|
|
63
63
|
};
|
|
64
|
+
var TaskCanceledError = class extends DatashiftError {
|
|
65
|
+
constructor(task) {
|
|
66
|
+
super(`Task ${task.id} was canceled before it was reviewed`, 409, "TASK_CANCELED", task);
|
|
67
|
+
this.task = task;
|
|
68
|
+
this.name = "TaskCanceledError";
|
|
69
|
+
}
|
|
70
|
+
};
|
|
64
71
|
var RateLimitError = class extends DatashiftError {
|
|
65
72
|
constructor(retryAfter) {
|
|
66
73
|
super("Rate limit exceeded", 429, "RATE_LIMITED");
|
|
@@ -98,7 +105,9 @@ var TaskResource = class {
|
|
|
98
105
|
context: input.context ?? {},
|
|
99
106
|
metadata: input.metadata ?? {},
|
|
100
107
|
summary: input.summary,
|
|
101
|
-
external_id: input.externalId
|
|
108
|
+
external_id: input.externalId,
|
|
109
|
+
choices: input.choices,
|
|
110
|
+
max_selections: input.maxSelections
|
|
102
111
|
});
|
|
103
112
|
return response.data;
|
|
104
113
|
}
|
|
@@ -128,7 +137,10 @@ var TaskResource = class {
|
|
|
128
137
|
return response.data;
|
|
129
138
|
}
|
|
130
139
|
/**
|
|
131
|
-
* Wait for a task to be reviewed
|
|
140
|
+
* Wait for a task to be reviewed.
|
|
141
|
+
*
|
|
142
|
+
* @throws {TaskCanceledError} If the task is canceled before it is reviewed.
|
|
143
|
+
* @throws {TimeoutError} If the task is not reviewed within `timeout`.
|
|
132
144
|
*/
|
|
133
145
|
async waitForReview(taskId, options) {
|
|
134
146
|
const opts = { ...DEFAULT_WAIT_OPTIONS, ...options };
|
|
@@ -139,6 +151,9 @@ var TaskResource = class {
|
|
|
139
151
|
if (status.state === "reviewed") {
|
|
140
152
|
return this.get(taskId);
|
|
141
153
|
}
|
|
154
|
+
if (status.state === "canceled") {
|
|
155
|
+
throw new TaskCanceledError(await this.get(taskId));
|
|
156
|
+
}
|
|
142
157
|
await this.sleep(currentInterval);
|
|
143
158
|
currentInterval = Math.min(currentInterval * 1.5, opts.maxPollInterval);
|
|
144
159
|
}
|
|
@@ -299,6 +314,7 @@ exports.DatashiftRestClient = DatashiftRestClient;
|
|
|
299
314
|
exports.NotFoundError = NotFoundError;
|
|
300
315
|
exports.RateLimitError = RateLimitError;
|
|
301
316
|
exports.ServerError = ServerError;
|
|
317
|
+
exports.TaskCanceledError = TaskCanceledError;
|
|
302
318
|
exports.TimeoutError = TimeoutError;
|
|
303
319
|
exports.ValidationError = ValidationError;
|
|
304
320
|
//# sourceMappingURL=index.js.map
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/auth/api-key.ts","../src/errors.ts","../src/resources/task.ts","../src/resources/queue.ts","../src/resources/review.ts","../src/rest-client.ts"],"names":["axios"],"mappings":"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","file":"index.js","sourcesContent":["import type { AxiosInstance } from 'axios';\n\n/**\n * Configures axios instance with API key authentication\n */\nexport function configureApiKeyAuth(client: AxiosInstance, apiKey: string): void {\n client.interceptors.request.use((config) => {\n config.headers.Authorization = `Bearer ${apiKey}`;\n return config;\n });\n}\n\n/**\n * Validates API key format\n */\nexport function validateApiKey(apiKey: string): void {\n if (!apiKey) {\n throw new Error('API key is required');\n }\n\n if (!apiKey.startsWith('sk_')) {\n throw new Error('Invalid API key format. Expected sk_');\n }\n}\n\n","/**\n * Base error class for all Datashift SDK errors\n */\nexport class DatashiftError extends Error {\n constructor(\n message: string,\n public status?: number,\n public code?: string,\n public data?: unknown,\n ) {\n super(message);\n this.name = 'DatashiftError';\n Error.captureStackTrace?.(this, this.constructor);\n }\n}\n\n/**\n * Thrown when authentication fails (invalid API key, expired token, etc.)\n */\nexport class AuthenticationError extends DatashiftError {\n constructor(message = 'Authentication failed') {\n super(message, 401, 'AUTHENTICATION_ERROR');\n this.name = 'AuthenticationError';\n }\n}\n\n/**\n * Thrown when a requested resource is not found\n */\nexport class NotFoundError extends DatashiftError {\n constructor(resource: string, id?: string) {\n const message = id ? `${resource} '${id}' not found` : `${resource} not found`;\n super(message, 404, 'NOT_FOUND');\n this.name = 'NotFoundError';\n }\n}\n\n/**\n * Thrown when request validation fails\n */\nexport class ValidationError extends DatashiftError {\n constructor(\n message: string,\n public errors?: Record<string, string[]>,\n ) {\n super(message, 400, 'VALIDATION_ERROR', errors);\n this.name = 'ValidationError';\n }\n}\n\n/**\n * Thrown when an operation times out\n */\nexport class TimeoutError extends DatashiftError {\n constructor(message = 'Operation timed out') {\n super(message, 408, 'TIMEOUT');\n this.name = 'TimeoutError';\n }\n}\n\n/**\n * Thrown when rate limited\n */\nexport class RateLimitError extends DatashiftError {\n constructor(\n public retryAfter?: number,\n ) {\n super('Rate limit exceeded', 429, 'RATE_LIMITED');\n this.name = 'RateLimitError';\n }\n}\n\n/**\n * Thrown when the server returns an error\n */\nexport class ServerError extends DatashiftError {\n constructor(message = 'Internal server error') {\n super(message, 500, 'SERVER_ERROR');\n this.name = 'ServerError';\n }\n}\n","import type { AxiosInstance } from 'axios';\nimport type {\n Task,\n TaskStatus,\n SubmitTaskInput,\n WaitOptions,\n} from '../types/index.js';\nimport { TimeoutError } from '../errors.js';\n\nconst DEFAULT_WAIT_OPTIONS: Required<WaitOptions> = {\n timeout: 300000, // 5 minutes\n pollInterval: 2000, // 2 seconds\n maxPollInterval: 30000, // 30 seconds\n};\n\nexport class TaskResource {\n constructor(private client: AxiosInstance) {}\n\n /**\n * Submit a task for human review\n */\n async submit(input: SubmitTaskInput): Promise<Task> {\n const response = await this.client.post<Task>('/task', {\n queue_key: input.queueKey,\n data: input.data,\n context: input.context ?? {},\n metadata: input.metadata ?? {},\n summary: input.summary,\n external_id: input.externalId,\n });\n return response.data;\n }\n\n /**\n * Get a task by ID with full details\n */\n async get(taskId: string): Promise<Task> {\n const response = await this.client.get<Task>(`/task/${taskId}`);\n return response.data;\n }\n\n /**\n * Get task status\n */\n private async getStatus(taskId: string): Promise<TaskStatus> {\n const response = await this.client.get<TaskStatus>(`/task/${taskId}/status`);\n return response.data;\n }\n\n /**\n * List tasks with optional filters\n */\n async list(filters?: { queueId?: string; state?: string }): Promise<Task[]> {\n const params = new URLSearchParams();\n if (filters?.queueId) params.append('queue_id', filters.queueId);\n if (filters?.state) params.append('state', filters.state);\n\n const query = params.toString();\n const response = await this.client.get<Task[]>(`/task${query ? `?${query}` : ''}`);\n return response.data;\n }\n\n /**\n * Wait for a task to be reviewed\n */\n async waitForReview(taskId: string, options?: WaitOptions): Promise<Task> {\n const opts = { ...DEFAULT_WAIT_OPTIONS, ...options };\n const startTime = Date.now();\n let currentInterval = opts.pollInterval;\n\n while (Date.now() - startTime < opts.timeout) {\n const status = await this.getStatus(taskId);\n\n if (status.state === 'reviewed') {\n // Fetch full task with reviews\n return this.get(taskId);\n }\n\n // Wait before next poll\n await this.sleep(currentInterval);\n\n // Exponential backoff (double interval, cap at max)\n currentInterval = Math.min(currentInterval * 1.5, opts.maxPollInterval);\n }\n\n throw new TimeoutError(\n `Task ${taskId} was not reviewed within ${opts.timeout}ms`,\n );\n }\n\n private sleep(ms: number): Promise<void> {\n return new Promise((resolve) => setTimeout(resolve, ms));\n }\n}\n","import type { AxiosInstance } from 'axios';\nimport type { Queue } from '../types/index.js';\n\nexport class QueueResource {\n constructor(private client: AxiosInstance) {}\n\n /**\n * List all queues available to the organization\n */\n async list(): Promise<Queue[]> {\n const response = await this.client.get<Queue[]>('/queue');\n return response.data;\n }\n\n /**\n * Get a queue by key\n */\n async get(key: string): Promise<Queue> {\n const response = await this.client.get<Queue>(`/queue/${key}`);\n return response.data;\n }\n}\n","import type { AxiosInstance } from 'axios';\nimport type { Review, ListReviewsFilters } from '../types/index.js';\n\nexport class ReviewResource {\n constructor(private client: AxiosInstance) {}\n\n /**\n * List reviews with optional filters\n */\n async list(filters?: ListReviewsFilters): Promise<Review[]> {\n const params = new URLSearchParams();\n\n if (filters?.taskId) params.append('task_id', filters.taskId);\n if (filters?.reviewerId) params.append('reviewer_id', filters.reviewerId);\n if (filters?.queueKey) params.append('queue_key', filters.queueKey);\n if (filters?.reviewerType) params.append('reviewer_type', filters.reviewerType);\n if (filters?.from) {\n const date = filters.from instanceof Date\n ? filters.from.toISOString()\n : filters.from;\n params.append('created_after', date);\n }\n if (filters?.to) {\n const date = filters.to instanceof Date\n ? filters.to.toISOString()\n : filters.to;\n params.append('created_before', date);\n }\n if (filters?.limit) params.append('limit', filters.limit.toString());\n if (filters?.offset) params.append('offset', filters.offset.toString());\n\n const query = params.toString();\n const response = await this.client.get<Review[]>(`/review${query ? `?${query}` : ''}`);\n return response.data;\n }\n\n /**\n * Get a review by ID\n */\n async get(reviewId: string): Promise<Review> {\n const response = await this.client.get<Review>(`/review/${reviewId}`);\n return response.data;\n }\n}\n","import axios, { AxiosInstance, AxiosError } from 'axios';\nimport type { RestClientConfig } from './types/index.js';\nimport { configureApiKeyAuth, validateApiKey } from './auth/api-key.js';\nimport { TaskResource } from './resources/task.js';\nimport { QueueResource } from './resources/queue.js';\nimport { ReviewResource } from './resources/review.js';\nimport {\n DatashiftError,\n AuthenticationError,\n NotFoundError,\n ValidationError,\n RateLimitError,\n ServerError,\n} from './errors.js';\n\nconst DEFAULT_BASE_URL = 'https://api.datashift.io';\nconst DEFAULT_TIMEOUT = 30000;\nconst DEFAULT_RETRIES = 3;\nconst DEFAULT_RETRY_DELAY = 1000;\n\n/**\n * Datashift REST API client\n *\n * Use this client for backend service integrations with API key authentication.\n * For AI agents with real-time push notifications, use DatashiftMcpClient instead.\n *\n * @example\n * ```typescript\n * const datashift = new DatashiftRestClient({\n * apiKey: 'sk_...',\n * });\n *\n * const task = await datashift.task.submit({\n * queueKey: 'approvals',\n * data: { action: 'delete-account' },\n * });\n *\n * const result = await datashift.task.waitForReview(task.id);\n * ```\n */\nexport class DatashiftRestClient {\n private client: AxiosInstance;\n private retries: number;\n private retryDelay: number;\n\n public readonly task: TaskResource;\n public readonly queue: QueueResource;\n public readonly review: ReviewResource;\n\n constructor(config: RestClientConfig) {\n validateApiKey(config.apiKey);\n\n this.retries = config.retries ?? DEFAULT_RETRIES;\n this.retryDelay = config.retryDelay ?? DEFAULT_RETRY_DELAY;\n\n this.client = axios.create({\n baseURL: config.baseUrl ?? DEFAULT_BASE_URL,\n timeout: config.timeout ?? DEFAULT_TIMEOUT,\n headers: {\n 'Content-Type': 'application/json',\n },\n });\n\n // Configure API key authentication\n configureApiKeyAuth(this.client, config.apiKey);\n\n // Configure error handling\n this.setupErrorInterceptor();\n\n // Initialize resources\n this.task = new TaskResource(this.client);\n this.queue = new QueueResource(this.client);\n this.review = new ReviewResource(this.client);\n }\n\n private setupErrorInterceptor(): void {\n this.client.interceptors.response.use(\n (response) => response,\n async (error: AxiosError) => {\n // Handle retry logic for transient errors\n const config = error.config;\n if (config && this.shouldRetry(error)) {\n const retryCount = (config as any).__retryCount || 0;\n if (retryCount < this.retries) {\n (config as any).__retryCount = retryCount + 1;\n await this.sleep(this.retryDelay * Math.pow(2, retryCount));\n return this.client.request(config);\n }\n }\n\n // Transform to SDK errors\n throw this.transformError(error);\n },\n );\n }\n\n private shouldRetry(error: AxiosError): boolean {\n // Retry on network errors or 5xx server errors\n if (!error.response) return true;\n return error.response.status >= 500 && error.response.status < 600;\n }\n\n private transformError(error: AxiosError): DatashiftError {\n if (!error.response) {\n return new DatashiftError(\n 'Network error: Unable to reach Datashift API',\n undefined,\n 'NETWORK_ERROR',\n );\n }\n\n const status = error.response.status;\n const data = error.response.data as any;\n const message = data?.message || error.message;\n\n switch (status) {\n case 401:\n return new AuthenticationError(message);\n case 404:\n return new NotFoundError('Resource', data?.entityId);\n case 400:\n return new ValidationError(message, data?.errors);\n case 429:\n return new RateLimitError(data?.retryAfter);\n case 500:\n case 502:\n case 503:\n case 504:\n return new ServerError(message);\n default:\n return new DatashiftError(message, status, data?.code, data);\n }\n }\n\n private sleep(ms: number): Promise<void> {\n return new Promise((resolve) => setTimeout(resolve, ms));\n }\n}\n"]}
|
|
1
|
+
{"version":3,"sources":["../src/auth/api-key.ts","../src/errors.ts","../src/resources/task.ts","../src/resources/queue.ts","../src/resources/review.ts","../src/rest-client.ts"],"names":["axios"],"mappings":"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","file":"index.js","sourcesContent":["import type { AxiosInstance } from 'axios';\n\n/**\n * Configures axios instance with API key authentication\n */\nexport function configureApiKeyAuth(client: AxiosInstance, apiKey: string): void {\n client.interceptors.request.use((config) => {\n config.headers.Authorization = `Bearer ${apiKey}`;\n return config;\n });\n}\n\n/**\n * Validates API key format\n */\nexport function validateApiKey(apiKey: string): void {\n if (!apiKey) {\n throw new Error('API key is required');\n }\n\n if (!apiKey.startsWith('sk_')) {\n throw new Error('Invalid API key format. Expected sk_');\n }\n}\n\n","import type { Task } from './types/index.js';\n\n/**\n * Base error class for all Datashift SDK errors\n */\nexport class DatashiftError extends Error {\n constructor(\n message: string,\n public status?: number,\n public code?: string,\n public data?: unknown,\n ) {\n super(message);\n this.name = 'DatashiftError';\n Error.captureStackTrace?.(this, this.constructor);\n }\n}\n\n/**\n * Thrown when authentication fails (invalid API key, expired token, etc.)\n */\nexport class AuthenticationError extends DatashiftError {\n constructor(message = 'Authentication failed') {\n super(message, 401, 'AUTHENTICATION_ERROR');\n this.name = 'AuthenticationError';\n }\n}\n\n/**\n * Thrown when a requested resource is not found\n */\nexport class NotFoundError extends DatashiftError {\n constructor(resource: string, id?: string) {\n const message = id ? `${resource} '${id}' not found` : `${resource} not found`;\n super(message, 404, 'NOT_FOUND');\n this.name = 'NotFoundError';\n }\n}\n\n/**\n * Thrown when request validation fails\n */\nexport class ValidationError extends DatashiftError {\n constructor(\n message: string,\n public errors?: Record<string, string[]>,\n ) {\n super(message, 400, 'VALIDATION_ERROR', errors);\n this.name = 'ValidationError';\n }\n}\n\n/**\n * Thrown when an operation times out\n */\nexport class TimeoutError extends DatashiftError {\n constructor(message = 'Operation timed out') {\n super(message, 408, 'TIMEOUT');\n this.name = 'TimeoutError';\n }\n}\n\n/**\n * Thrown by `waitForReview` when the task is canceled before it is reviewed\n */\nexport class TaskCanceledError extends DatashiftError {\n constructor(public task: Task) {\n super(`Task ${task.id} was canceled before it was reviewed`, 409, 'TASK_CANCELED', task);\n this.name = 'TaskCanceledError';\n }\n}\n\n/**\n * Thrown when rate limited\n */\nexport class RateLimitError extends DatashiftError {\n constructor(\n public retryAfter?: number,\n ) {\n super('Rate limit exceeded', 429, 'RATE_LIMITED');\n this.name = 'RateLimitError';\n }\n}\n\n/**\n * Thrown when the server returns an error\n */\nexport class ServerError extends DatashiftError {\n constructor(message = 'Internal server error') {\n super(message, 500, 'SERVER_ERROR');\n this.name = 'ServerError';\n }\n}\n","import type { AxiosInstance } from 'axios';\nimport type {\n Task,\n TaskStatus,\n SubmitTaskInput,\n WaitOptions,\n} from '../types/index.js';\nimport { TaskCanceledError, TimeoutError } from '../errors.js';\n\nconst DEFAULT_WAIT_OPTIONS: Required<WaitOptions> = {\n timeout: 300000, // 5 minutes\n pollInterval: 2000, // 2 seconds\n maxPollInterval: 30000, // 30 seconds\n};\n\nexport class TaskResource {\n constructor(private client: AxiosInstance) {}\n\n /**\n * Submit a task for human review\n */\n async submit(input: SubmitTaskInput): Promise<Task> {\n const response = await this.client.post<Task>('/task', {\n queue_key: input.queueKey,\n data: input.data,\n context: input.context ?? {},\n metadata: input.metadata ?? {},\n summary: input.summary,\n external_id: input.externalId,\n choices: input.choices,\n max_selections: input.maxSelections,\n });\n return response.data;\n }\n\n /**\n * Get a task by ID with full details\n */\n async get(taskId: string): Promise<Task> {\n const response = await this.client.get<Task>(`/task/${taskId}`);\n return response.data;\n }\n\n /**\n * Get task status\n */\n private async getStatus(taskId: string): Promise<TaskStatus> {\n const response = await this.client.get<TaskStatus>(`/task/${taskId}/status`);\n return response.data;\n }\n\n /**\n * List tasks with optional filters\n */\n async list(filters?: { queueId?: string; state?: string }): Promise<Task[]> {\n const params = new URLSearchParams();\n if (filters?.queueId) params.append('queue_id', filters.queueId);\n if (filters?.state) params.append('state', filters.state);\n\n const query = params.toString();\n const response = await this.client.get<Task[]>(`/task${query ? `?${query}` : ''}`);\n return response.data;\n }\n\n /**\n * Wait for a task to be reviewed.\n *\n * @throws {TaskCanceledError} If the task is canceled before it is reviewed.\n * @throws {TimeoutError} If the task is not reviewed within `timeout`.\n */\n async waitForReview(taskId: string, options?: WaitOptions): Promise<Task> {\n const opts = { ...DEFAULT_WAIT_OPTIONS, ...options };\n const startTime = Date.now();\n let currentInterval = opts.pollInterval;\n\n while (Date.now() - startTime < opts.timeout) {\n const status = await this.getStatus(taskId);\n\n if (status.state === 'reviewed') {\n // Fetch full task with reviews\n return this.get(taskId);\n }\n\n if (status.state === 'canceled') {\n throw new TaskCanceledError(await this.get(taskId));\n }\n\n // Wait before next poll\n await this.sleep(currentInterval);\n\n // Exponential backoff (double interval, cap at max)\n currentInterval = Math.min(currentInterval * 1.5, opts.maxPollInterval);\n }\n\n throw new TimeoutError(\n `Task ${taskId} was not reviewed within ${opts.timeout}ms`,\n );\n }\n\n private sleep(ms: number): Promise<void> {\n return new Promise((resolve) => setTimeout(resolve, ms));\n }\n}\n","import type { AxiosInstance } from 'axios';\nimport type { Queue } from '../types/index.js';\n\nexport class QueueResource {\n constructor(private client: AxiosInstance) {}\n\n /**\n * List all queues available to the organization\n */\n async list(): Promise<Queue[]> {\n const response = await this.client.get<Queue[]>('/queue');\n return response.data;\n }\n\n /**\n * Get a queue by key\n */\n async get(key: string): Promise<Queue> {\n const response = await this.client.get<Queue>(`/queue/${key}`);\n return response.data;\n }\n}\n","import type { AxiosInstance } from 'axios';\nimport type { Review, ListReviewsFilters } from '../types/index.js';\n\nexport class ReviewResource {\n constructor(private client: AxiosInstance) {}\n\n /**\n * List reviews with optional filters\n */\n async list(filters?: ListReviewsFilters): Promise<Review[]> {\n const params = new URLSearchParams();\n\n if (filters?.taskId) params.append('task_id', filters.taskId);\n if (filters?.reviewerId) params.append('reviewer_id', filters.reviewerId);\n if (filters?.queueKey) params.append('queue_key', filters.queueKey);\n if (filters?.reviewerType) params.append('reviewer_type', filters.reviewerType);\n if (filters?.from) {\n const date = filters.from instanceof Date\n ? filters.from.toISOString()\n : filters.from;\n params.append('created_after', date);\n }\n if (filters?.to) {\n const date = filters.to instanceof Date\n ? filters.to.toISOString()\n : filters.to;\n params.append('created_before', date);\n }\n if (filters?.limit) params.append('limit', filters.limit.toString());\n if (filters?.offset) params.append('offset', filters.offset.toString());\n\n const query = params.toString();\n const response = await this.client.get<Review[]>(`/review${query ? `?${query}` : ''}`);\n return response.data;\n }\n\n /**\n * Get a review by ID\n */\n async get(reviewId: string): Promise<Review> {\n const response = await this.client.get<Review>(`/review/${reviewId}`);\n return response.data;\n }\n}\n","import axios, { AxiosInstance, AxiosError } from 'axios';\nimport type { RestClientConfig } from './types/index.js';\nimport { configureApiKeyAuth, validateApiKey } from './auth/api-key.js';\nimport { TaskResource } from './resources/task.js';\nimport { QueueResource } from './resources/queue.js';\nimport { ReviewResource } from './resources/review.js';\nimport {\n DatashiftError,\n AuthenticationError,\n NotFoundError,\n ValidationError,\n RateLimitError,\n ServerError,\n} from './errors.js';\n\nconst DEFAULT_BASE_URL = 'https://api.datashift.io';\nconst DEFAULT_TIMEOUT = 30000;\nconst DEFAULT_RETRIES = 3;\nconst DEFAULT_RETRY_DELAY = 1000;\n\n/**\n * Datashift REST API client\n *\n * Use this client for backend service integrations with API key authentication.\n * For AI agents with real-time push notifications, use DatashiftMcpClient instead.\n *\n * @example\n * ```typescript\n * const datashift = new DatashiftRestClient({\n * apiKey: 'sk_...',\n * });\n *\n * const task = await datashift.task.submit({\n * queueKey: 'approvals',\n * data: { action: 'delete-account' },\n * });\n *\n * const result = await datashift.task.waitForReview(task.id);\n * ```\n */\nexport class DatashiftRestClient {\n private client: AxiosInstance;\n private retries: number;\n private retryDelay: number;\n\n public readonly task: TaskResource;\n public readonly queue: QueueResource;\n public readonly review: ReviewResource;\n\n constructor(config: RestClientConfig) {\n validateApiKey(config.apiKey);\n\n this.retries = config.retries ?? DEFAULT_RETRIES;\n this.retryDelay = config.retryDelay ?? DEFAULT_RETRY_DELAY;\n\n this.client = axios.create({\n baseURL: config.baseUrl ?? DEFAULT_BASE_URL,\n timeout: config.timeout ?? DEFAULT_TIMEOUT,\n headers: {\n 'Content-Type': 'application/json',\n },\n });\n\n // Configure API key authentication\n configureApiKeyAuth(this.client, config.apiKey);\n\n // Configure error handling\n this.setupErrorInterceptor();\n\n // Initialize resources\n this.task = new TaskResource(this.client);\n this.queue = new QueueResource(this.client);\n this.review = new ReviewResource(this.client);\n }\n\n private setupErrorInterceptor(): void {\n this.client.interceptors.response.use(\n (response) => response,\n async (error: AxiosError) => {\n // Handle retry logic for transient errors\n const config = error.config;\n if (config && this.shouldRetry(error)) {\n const retryCount = (config as any).__retryCount || 0;\n if (retryCount < this.retries) {\n (config as any).__retryCount = retryCount + 1;\n await this.sleep(this.retryDelay * Math.pow(2, retryCount));\n return this.client.request(config);\n }\n }\n\n // Transform to SDK errors\n throw this.transformError(error);\n },\n );\n }\n\n private shouldRetry(error: AxiosError): boolean {\n // Retry on network errors or 5xx server errors\n if (!error.response) return true;\n return error.response.status >= 500 && error.response.status < 600;\n }\n\n private transformError(error: AxiosError): DatashiftError {\n if (!error.response) {\n return new DatashiftError(\n 'Network error: Unable to reach Datashift API',\n undefined,\n 'NETWORK_ERROR',\n );\n }\n\n const status = error.response.status;\n const data = error.response.data as any;\n const message = data?.message || error.message;\n\n switch (status) {\n case 401:\n return new AuthenticationError(message);\n case 404:\n return new NotFoundError('Resource', data?.entityId);\n case 400:\n return new ValidationError(message, data?.errors);\n case 429:\n return new RateLimitError(data?.retryAfter);\n case 500:\n case 502:\n case 503:\n case 504:\n return new ServerError(message);\n default:\n return new DatashiftError(message, status, data?.code, data);\n }\n }\n\n private sleep(ms: number): Promise<void> {\n return new Promise((resolve) => setTimeout(resolve, ms));\n }\n}\n"]}
|
package/dist/index.mjs
CHANGED
|
@@ -55,6 +55,13 @@ var TimeoutError = class extends DatashiftError {
|
|
|
55
55
|
this.name = "TimeoutError";
|
|
56
56
|
}
|
|
57
57
|
};
|
|
58
|
+
var TaskCanceledError = class extends DatashiftError {
|
|
59
|
+
constructor(task) {
|
|
60
|
+
super(`Task ${task.id} was canceled before it was reviewed`, 409, "TASK_CANCELED", task);
|
|
61
|
+
this.task = task;
|
|
62
|
+
this.name = "TaskCanceledError";
|
|
63
|
+
}
|
|
64
|
+
};
|
|
58
65
|
var RateLimitError = class extends DatashiftError {
|
|
59
66
|
constructor(retryAfter) {
|
|
60
67
|
super("Rate limit exceeded", 429, "RATE_LIMITED");
|
|
@@ -92,7 +99,9 @@ var TaskResource = class {
|
|
|
92
99
|
context: input.context ?? {},
|
|
93
100
|
metadata: input.metadata ?? {},
|
|
94
101
|
summary: input.summary,
|
|
95
|
-
external_id: input.externalId
|
|
102
|
+
external_id: input.externalId,
|
|
103
|
+
choices: input.choices,
|
|
104
|
+
max_selections: input.maxSelections
|
|
96
105
|
});
|
|
97
106
|
return response.data;
|
|
98
107
|
}
|
|
@@ -122,7 +131,10 @@ var TaskResource = class {
|
|
|
122
131
|
return response.data;
|
|
123
132
|
}
|
|
124
133
|
/**
|
|
125
|
-
* Wait for a task to be reviewed
|
|
134
|
+
* Wait for a task to be reviewed.
|
|
135
|
+
*
|
|
136
|
+
* @throws {TaskCanceledError} If the task is canceled before it is reviewed.
|
|
137
|
+
* @throws {TimeoutError} If the task is not reviewed within `timeout`.
|
|
126
138
|
*/
|
|
127
139
|
async waitForReview(taskId, options) {
|
|
128
140
|
const opts = { ...DEFAULT_WAIT_OPTIONS, ...options };
|
|
@@ -133,6 +145,9 @@ var TaskResource = class {
|
|
|
133
145
|
if (status.state === "reviewed") {
|
|
134
146
|
return this.get(taskId);
|
|
135
147
|
}
|
|
148
|
+
if (status.state === "canceled") {
|
|
149
|
+
throw new TaskCanceledError(await this.get(taskId));
|
|
150
|
+
}
|
|
136
151
|
await this.sleep(currentInterval);
|
|
137
152
|
currentInterval = Math.min(currentInterval * 1.5, opts.maxPollInterval);
|
|
138
153
|
}
|
|
@@ -287,6 +302,6 @@ var DatashiftRestClient = class {
|
|
|
287
302
|
}
|
|
288
303
|
};
|
|
289
304
|
|
|
290
|
-
export { AuthenticationError, DatashiftError, DatashiftRestClient, NotFoundError, RateLimitError, ServerError, TimeoutError, ValidationError };
|
|
305
|
+
export { AuthenticationError, DatashiftError, DatashiftRestClient, NotFoundError, RateLimitError, ServerError, TaskCanceledError, TimeoutError, ValidationError };
|
|
291
306
|
//# sourceMappingURL=index.mjs.map
|
|
292
307
|
//# sourceMappingURL=index.mjs.map
|
package/dist/index.mjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/auth/api-key.ts","../src/errors.ts","../src/resources/task.ts","../src/resources/queue.ts","../src/resources/review.ts","../src/rest-client.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["import type { AxiosInstance } from 'axios';\n\n/**\n * Configures axios instance with API key authentication\n */\nexport function configureApiKeyAuth(client: AxiosInstance, apiKey: string): void {\n client.interceptors.request.use((config) => {\n config.headers.Authorization = `Bearer ${apiKey}`;\n return config;\n });\n}\n\n/**\n * Validates API key format\n */\nexport function validateApiKey(apiKey: string): void {\n if (!apiKey) {\n throw new Error('API key is required');\n }\n\n if (!apiKey.startsWith('sk_')) {\n throw new Error('Invalid API key format. Expected sk_');\n }\n}\n\n","/**\n * Base error class for all Datashift SDK errors\n */\nexport class DatashiftError extends Error {\n constructor(\n message: string,\n public status?: number,\n public code?: string,\n public data?: unknown,\n ) {\n super(message);\n this.name = 'DatashiftError';\n Error.captureStackTrace?.(this, this.constructor);\n }\n}\n\n/**\n * Thrown when authentication fails (invalid API key, expired token, etc.)\n */\nexport class AuthenticationError extends DatashiftError {\n constructor(message = 'Authentication failed') {\n super(message, 401, 'AUTHENTICATION_ERROR');\n this.name = 'AuthenticationError';\n }\n}\n\n/**\n * Thrown when a requested resource is not found\n */\nexport class NotFoundError extends DatashiftError {\n constructor(resource: string, id?: string) {\n const message = id ? `${resource} '${id}' not found` : `${resource} not found`;\n super(message, 404, 'NOT_FOUND');\n this.name = 'NotFoundError';\n }\n}\n\n/**\n * Thrown when request validation fails\n */\nexport class ValidationError extends DatashiftError {\n constructor(\n message: string,\n public errors?: Record<string, string[]>,\n ) {\n super(message, 400, 'VALIDATION_ERROR', errors);\n this.name = 'ValidationError';\n }\n}\n\n/**\n * Thrown when an operation times out\n */\nexport class TimeoutError extends DatashiftError {\n constructor(message = 'Operation timed out') {\n super(message, 408, 'TIMEOUT');\n this.name = 'TimeoutError';\n }\n}\n\n/**\n * Thrown when rate limited\n */\nexport class RateLimitError extends DatashiftError {\n constructor(\n public retryAfter?: number,\n ) {\n super('Rate limit exceeded', 429, 'RATE_LIMITED');\n this.name = 'RateLimitError';\n }\n}\n\n/**\n * Thrown when the server returns an error\n */\nexport class ServerError extends DatashiftError {\n constructor(message = 'Internal server error') {\n super(message, 500, 'SERVER_ERROR');\n this.name = 'ServerError';\n }\n}\n","import type { AxiosInstance } from 'axios';\nimport type {\n Task,\n TaskStatus,\n SubmitTaskInput,\n WaitOptions,\n} from '../types/index.js';\nimport { TimeoutError } from '../errors.js';\n\nconst DEFAULT_WAIT_OPTIONS: Required<WaitOptions> = {\n timeout: 300000, // 5 minutes\n pollInterval: 2000, // 2 seconds\n maxPollInterval: 30000, // 30 seconds\n};\n\nexport class TaskResource {\n constructor(private client: AxiosInstance) {}\n\n /**\n * Submit a task for human review\n */\n async submit(input: SubmitTaskInput): Promise<Task> {\n const response = await this.client.post<Task>('/task', {\n queue_key: input.queueKey,\n data: input.data,\n context: input.context ?? {},\n metadata: input.metadata ?? {},\n summary: input.summary,\n external_id: input.externalId,\n });\n return response.data;\n }\n\n /**\n * Get a task by ID with full details\n */\n async get(taskId: string): Promise<Task> {\n const response = await this.client.get<Task>(`/task/${taskId}`);\n return response.data;\n }\n\n /**\n * Get task status\n */\n private async getStatus(taskId: string): Promise<TaskStatus> {\n const response = await this.client.get<TaskStatus>(`/task/${taskId}/status`);\n return response.data;\n }\n\n /**\n * List tasks with optional filters\n */\n async list(filters?: { queueId?: string; state?: string }): Promise<Task[]> {\n const params = new URLSearchParams();\n if (filters?.queueId) params.append('queue_id', filters.queueId);\n if (filters?.state) params.append('state', filters.state);\n\n const query = params.toString();\n const response = await this.client.get<Task[]>(`/task${query ? `?${query}` : ''}`);\n return response.data;\n }\n\n /**\n * Wait for a task to be reviewed\n */\n async waitForReview(taskId: string, options?: WaitOptions): Promise<Task> {\n const opts = { ...DEFAULT_WAIT_OPTIONS, ...options };\n const startTime = Date.now();\n let currentInterval = opts.pollInterval;\n\n while (Date.now() - startTime < opts.timeout) {\n const status = await this.getStatus(taskId);\n\n if (status.state === 'reviewed') {\n // Fetch full task with reviews\n return this.get(taskId);\n }\n\n // Wait before next poll\n await this.sleep(currentInterval);\n\n // Exponential backoff (double interval, cap at max)\n currentInterval = Math.min(currentInterval * 1.5, opts.maxPollInterval);\n }\n\n throw new TimeoutError(\n `Task ${taskId} was not reviewed within ${opts.timeout}ms`,\n );\n }\n\n private sleep(ms: number): Promise<void> {\n return new Promise((resolve) => setTimeout(resolve, ms));\n }\n}\n","import type { AxiosInstance } from 'axios';\nimport type { Queue } from '../types/index.js';\n\nexport class QueueResource {\n constructor(private client: AxiosInstance) {}\n\n /**\n * List all queues available to the organization\n */\n async list(): Promise<Queue[]> {\n const response = await this.client.get<Queue[]>('/queue');\n return response.data;\n }\n\n /**\n * Get a queue by key\n */\n async get(key: string): Promise<Queue> {\n const response = await this.client.get<Queue>(`/queue/${key}`);\n return response.data;\n }\n}\n","import type { AxiosInstance } from 'axios';\nimport type { Review, ListReviewsFilters } from '../types/index.js';\n\nexport class ReviewResource {\n constructor(private client: AxiosInstance) {}\n\n /**\n * List reviews with optional filters\n */\n async list(filters?: ListReviewsFilters): Promise<Review[]> {\n const params = new URLSearchParams();\n\n if (filters?.taskId) params.append('task_id', filters.taskId);\n if (filters?.reviewerId) params.append('reviewer_id', filters.reviewerId);\n if (filters?.queueKey) params.append('queue_key', filters.queueKey);\n if (filters?.reviewerType) params.append('reviewer_type', filters.reviewerType);\n if (filters?.from) {\n const date = filters.from instanceof Date\n ? filters.from.toISOString()\n : filters.from;\n params.append('created_after', date);\n }\n if (filters?.to) {\n const date = filters.to instanceof Date\n ? filters.to.toISOString()\n : filters.to;\n params.append('created_before', date);\n }\n if (filters?.limit) params.append('limit', filters.limit.toString());\n if (filters?.offset) params.append('offset', filters.offset.toString());\n\n const query = params.toString();\n const response = await this.client.get<Review[]>(`/review${query ? `?${query}` : ''}`);\n return response.data;\n }\n\n /**\n * Get a review by ID\n */\n async get(reviewId: string): Promise<Review> {\n const response = await this.client.get<Review>(`/review/${reviewId}`);\n return response.data;\n }\n}\n","import axios, { AxiosInstance, AxiosError } from 'axios';\nimport type { RestClientConfig } from './types/index.js';\nimport { configureApiKeyAuth, validateApiKey } from './auth/api-key.js';\nimport { TaskResource } from './resources/task.js';\nimport { QueueResource } from './resources/queue.js';\nimport { ReviewResource } from './resources/review.js';\nimport {\n DatashiftError,\n AuthenticationError,\n NotFoundError,\n ValidationError,\n RateLimitError,\n ServerError,\n} from './errors.js';\n\nconst DEFAULT_BASE_URL = 'https://api.datashift.io';\nconst DEFAULT_TIMEOUT = 30000;\nconst DEFAULT_RETRIES = 3;\nconst DEFAULT_RETRY_DELAY = 1000;\n\n/**\n * Datashift REST API client\n *\n * Use this client for backend service integrations with API key authentication.\n * For AI agents with real-time push notifications, use DatashiftMcpClient instead.\n *\n * @example\n * ```typescript\n * const datashift = new DatashiftRestClient({\n * apiKey: 'sk_...',\n * });\n *\n * const task = await datashift.task.submit({\n * queueKey: 'approvals',\n * data: { action: 'delete-account' },\n * });\n *\n * const result = await datashift.task.waitForReview(task.id);\n * ```\n */\nexport class DatashiftRestClient {\n private client: AxiosInstance;\n private retries: number;\n private retryDelay: number;\n\n public readonly task: TaskResource;\n public readonly queue: QueueResource;\n public readonly review: ReviewResource;\n\n constructor(config: RestClientConfig) {\n validateApiKey(config.apiKey);\n\n this.retries = config.retries ?? DEFAULT_RETRIES;\n this.retryDelay = config.retryDelay ?? DEFAULT_RETRY_DELAY;\n\n this.client = axios.create({\n baseURL: config.baseUrl ?? DEFAULT_BASE_URL,\n timeout: config.timeout ?? DEFAULT_TIMEOUT,\n headers: {\n 'Content-Type': 'application/json',\n },\n });\n\n // Configure API key authentication\n configureApiKeyAuth(this.client, config.apiKey);\n\n // Configure error handling\n this.setupErrorInterceptor();\n\n // Initialize resources\n this.task = new TaskResource(this.client);\n this.queue = new QueueResource(this.client);\n this.review = new ReviewResource(this.client);\n }\n\n private setupErrorInterceptor(): void {\n this.client.interceptors.response.use(\n (response) => response,\n async (error: AxiosError) => {\n // Handle retry logic for transient errors\n const config = error.config;\n if (config && this.shouldRetry(error)) {\n const retryCount = (config as any).__retryCount || 0;\n if (retryCount < this.retries) {\n (config as any).__retryCount = retryCount + 1;\n await this.sleep(this.retryDelay * Math.pow(2, retryCount));\n return this.client.request(config);\n }\n }\n\n // Transform to SDK errors\n throw this.transformError(error);\n },\n );\n }\n\n private shouldRetry(error: AxiosError): boolean {\n // Retry on network errors or 5xx server errors\n if (!error.response) return true;\n return error.response.status >= 500 && error.response.status < 600;\n }\n\n private transformError(error: AxiosError): DatashiftError {\n if (!error.response) {\n return new DatashiftError(\n 'Network error: Unable to reach Datashift API',\n undefined,\n 'NETWORK_ERROR',\n );\n }\n\n const status = error.response.status;\n const data = error.response.data as any;\n const message = data?.message || error.message;\n\n switch (status) {\n case 401:\n return new AuthenticationError(message);\n case 404:\n return new NotFoundError('Resource', data?.entityId);\n case 400:\n return new ValidationError(message, data?.errors);\n case 429:\n return new RateLimitError(data?.retryAfter);\n case 500:\n case 502:\n case 503:\n case 504:\n return new ServerError(message);\n default:\n return new DatashiftError(message, status, data?.code, data);\n }\n }\n\n private sleep(ms: number): Promise<void> {\n return new Promise((resolve) => setTimeout(resolve, ms));\n }\n}\n"]}
|
|
1
|
+
{"version":3,"sources":["../src/auth/api-key.ts","../src/errors.ts","../src/resources/task.ts","../src/resources/queue.ts","../src/resources/review.ts","../src/rest-client.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["import type { AxiosInstance } from 'axios';\n\n/**\n * Configures axios instance with API key authentication\n */\nexport function configureApiKeyAuth(client: AxiosInstance, apiKey: string): void {\n client.interceptors.request.use((config) => {\n config.headers.Authorization = `Bearer ${apiKey}`;\n return config;\n });\n}\n\n/**\n * Validates API key format\n */\nexport function validateApiKey(apiKey: string): void {\n if (!apiKey) {\n throw new Error('API key is required');\n }\n\n if (!apiKey.startsWith('sk_')) {\n throw new Error('Invalid API key format. Expected sk_');\n }\n}\n\n","import type { Task } from './types/index.js';\n\n/**\n * Base error class for all Datashift SDK errors\n */\nexport class DatashiftError extends Error {\n constructor(\n message: string,\n public status?: number,\n public code?: string,\n public data?: unknown,\n ) {\n super(message);\n this.name = 'DatashiftError';\n Error.captureStackTrace?.(this, this.constructor);\n }\n}\n\n/**\n * Thrown when authentication fails (invalid API key, expired token, etc.)\n */\nexport class AuthenticationError extends DatashiftError {\n constructor(message = 'Authentication failed') {\n super(message, 401, 'AUTHENTICATION_ERROR');\n this.name = 'AuthenticationError';\n }\n}\n\n/**\n * Thrown when a requested resource is not found\n */\nexport class NotFoundError extends DatashiftError {\n constructor(resource: string, id?: string) {\n const message = id ? `${resource} '${id}' not found` : `${resource} not found`;\n super(message, 404, 'NOT_FOUND');\n this.name = 'NotFoundError';\n }\n}\n\n/**\n * Thrown when request validation fails\n */\nexport class ValidationError extends DatashiftError {\n constructor(\n message: string,\n public errors?: Record<string, string[]>,\n ) {\n super(message, 400, 'VALIDATION_ERROR', errors);\n this.name = 'ValidationError';\n }\n}\n\n/**\n * Thrown when an operation times out\n */\nexport class TimeoutError extends DatashiftError {\n constructor(message = 'Operation timed out') {\n super(message, 408, 'TIMEOUT');\n this.name = 'TimeoutError';\n }\n}\n\n/**\n * Thrown by `waitForReview` when the task is canceled before it is reviewed\n */\nexport class TaskCanceledError extends DatashiftError {\n constructor(public task: Task) {\n super(`Task ${task.id} was canceled before it was reviewed`, 409, 'TASK_CANCELED', task);\n this.name = 'TaskCanceledError';\n }\n}\n\n/**\n * Thrown when rate limited\n */\nexport class RateLimitError extends DatashiftError {\n constructor(\n public retryAfter?: number,\n ) {\n super('Rate limit exceeded', 429, 'RATE_LIMITED');\n this.name = 'RateLimitError';\n }\n}\n\n/**\n * Thrown when the server returns an error\n */\nexport class ServerError extends DatashiftError {\n constructor(message = 'Internal server error') {\n super(message, 500, 'SERVER_ERROR');\n this.name = 'ServerError';\n }\n}\n","import type { AxiosInstance } from 'axios';\nimport type {\n Task,\n TaskStatus,\n SubmitTaskInput,\n WaitOptions,\n} from '../types/index.js';\nimport { TaskCanceledError, TimeoutError } from '../errors.js';\n\nconst DEFAULT_WAIT_OPTIONS: Required<WaitOptions> = {\n timeout: 300000, // 5 minutes\n pollInterval: 2000, // 2 seconds\n maxPollInterval: 30000, // 30 seconds\n};\n\nexport class TaskResource {\n constructor(private client: AxiosInstance) {}\n\n /**\n * Submit a task for human review\n */\n async submit(input: SubmitTaskInput): Promise<Task> {\n const response = await this.client.post<Task>('/task', {\n queue_key: input.queueKey,\n data: input.data,\n context: input.context ?? {},\n metadata: input.metadata ?? {},\n summary: input.summary,\n external_id: input.externalId,\n choices: input.choices,\n max_selections: input.maxSelections,\n });\n return response.data;\n }\n\n /**\n * Get a task by ID with full details\n */\n async get(taskId: string): Promise<Task> {\n const response = await this.client.get<Task>(`/task/${taskId}`);\n return response.data;\n }\n\n /**\n * Get task status\n */\n private async getStatus(taskId: string): Promise<TaskStatus> {\n const response = await this.client.get<TaskStatus>(`/task/${taskId}/status`);\n return response.data;\n }\n\n /**\n * List tasks with optional filters\n */\n async list(filters?: { queueId?: string; state?: string }): Promise<Task[]> {\n const params = new URLSearchParams();\n if (filters?.queueId) params.append('queue_id', filters.queueId);\n if (filters?.state) params.append('state', filters.state);\n\n const query = params.toString();\n const response = await this.client.get<Task[]>(`/task${query ? `?${query}` : ''}`);\n return response.data;\n }\n\n /**\n * Wait for a task to be reviewed.\n *\n * @throws {TaskCanceledError} If the task is canceled before it is reviewed.\n * @throws {TimeoutError} If the task is not reviewed within `timeout`.\n */\n async waitForReview(taskId: string, options?: WaitOptions): Promise<Task> {\n const opts = { ...DEFAULT_WAIT_OPTIONS, ...options };\n const startTime = Date.now();\n let currentInterval = opts.pollInterval;\n\n while (Date.now() - startTime < opts.timeout) {\n const status = await this.getStatus(taskId);\n\n if (status.state === 'reviewed') {\n // Fetch full task with reviews\n return this.get(taskId);\n }\n\n if (status.state === 'canceled') {\n throw new TaskCanceledError(await this.get(taskId));\n }\n\n // Wait before next poll\n await this.sleep(currentInterval);\n\n // Exponential backoff (double interval, cap at max)\n currentInterval = Math.min(currentInterval * 1.5, opts.maxPollInterval);\n }\n\n throw new TimeoutError(\n `Task ${taskId} was not reviewed within ${opts.timeout}ms`,\n );\n }\n\n private sleep(ms: number): Promise<void> {\n return new Promise((resolve) => setTimeout(resolve, ms));\n }\n}\n","import type { AxiosInstance } from 'axios';\nimport type { Queue } from '../types/index.js';\n\nexport class QueueResource {\n constructor(private client: AxiosInstance) {}\n\n /**\n * List all queues available to the organization\n */\n async list(): Promise<Queue[]> {\n const response = await this.client.get<Queue[]>('/queue');\n return response.data;\n }\n\n /**\n * Get a queue by key\n */\n async get(key: string): Promise<Queue> {\n const response = await this.client.get<Queue>(`/queue/${key}`);\n return response.data;\n }\n}\n","import type { AxiosInstance } from 'axios';\nimport type { Review, ListReviewsFilters } from '../types/index.js';\n\nexport class ReviewResource {\n constructor(private client: AxiosInstance) {}\n\n /**\n * List reviews with optional filters\n */\n async list(filters?: ListReviewsFilters): Promise<Review[]> {\n const params = new URLSearchParams();\n\n if (filters?.taskId) params.append('task_id', filters.taskId);\n if (filters?.reviewerId) params.append('reviewer_id', filters.reviewerId);\n if (filters?.queueKey) params.append('queue_key', filters.queueKey);\n if (filters?.reviewerType) params.append('reviewer_type', filters.reviewerType);\n if (filters?.from) {\n const date = filters.from instanceof Date\n ? filters.from.toISOString()\n : filters.from;\n params.append('created_after', date);\n }\n if (filters?.to) {\n const date = filters.to instanceof Date\n ? filters.to.toISOString()\n : filters.to;\n params.append('created_before', date);\n }\n if (filters?.limit) params.append('limit', filters.limit.toString());\n if (filters?.offset) params.append('offset', filters.offset.toString());\n\n const query = params.toString();\n const response = await this.client.get<Review[]>(`/review${query ? `?${query}` : ''}`);\n return response.data;\n }\n\n /**\n * Get a review by ID\n */\n async get(reviewId: string): Promise<Review> {\n const response = await this.client.get<Review>(`/review/${reviewId}`);\n return response.data;\n }\n}\n","import axios, { AxiosInstance, AxiosError } from 'axios';\nimport type { RestClientConfig } from './types/index.js';\nimport { configureApiKeyAuth, validateApiKey } from './auth/api-key.js';\nimport { TaskResource } from './resources/task.js';\nimport { QueueResource } from './resources/queue.js';\nimport { ReviewResource } from './resources/review.js';\nimport {\n DatashiftError,\n AuthenticationError,\n NotFoundError,\n ValidationError,\n RateLimitError,\n ServerError,\n} from './errors.js';\n\nconst DEFAULT_BASE_URL = 'https://api.datashift.io';\nconst DEFAULT_TIMEOUT = 30000;\nconst DEFAULT_RETRIES = 3;\nconst DEFAULT_RETRY_DELAY = 1000;\n\n/**\n * Datashift REST API client\n *\n * Use this client for backend service integrations with API key authentication.\n * For AI agents with real-time push notifications, use DatashiftMcpClient instead.\n *\n * @example\n * ```typescript\n * const datashift = new DatashiftRestClient({\n * apiKey: 'sk_...',\n * });\n *\n * const task = await datashift.task.submit({\n * queueKey: 'approvals',\n * data: { action: 'delete-account' },\n * });\n *\n * const result = await datashift.task.waitForReview(task.id);\n * ```\n */\nexport class DatashiftRestClient {\n private client: AxiosInstance;\n private retries: number;\n private retryDelay: number;\n\n public readonly task: TaskResource;\n public readonly queue: QueueResource;\n public readonly review: ReviewResource;\n\n constructor(config: RestClientConfig) {\n validateApiKey(config.apiKey);\n\n this.retries = config.retries ?? DEFAULT_RETRIES;\n this.retryDelay = config.retryDelay ?? DEFAULT_RETRY_DELAY;\n\n this.client = axios.create({\n baseURL: config.baseUrl ?? DEFAULT_BASE_URL,\n timeout: config.timeout ?? DEFAULT_TIMEOUT,\n headers: {\n 'Content-Type': 'application/json',\n },\n });\n\n // Configure API key authentication\n configureApiKeyAuth(this.client, config.apiKey);\n\n // Configure error handling\n this.setupErrorInterceptor();\n\n // Initialize resources\n this.task = new TaskResource(this.client);\n this.queue = new QueueResource(this.client);\n this.review = new ReviewResource(this.client);\n }\n\n private setupErrorInterceptor(): void {\n this.client.interceptors.response.use(\n (response) => response,\n async (error: AxiosError) => {\n // Handle retry logic for transient errors\n const config = error.config;\n if (config && this.shouldRetry(error)) {\n const retryCount = (config as any).__retryCount || 0;\n if (retryCount < this.retries) {\n (config as any).__retryCount = retryCount + 1;\n await this.sleep(this.retryDelay * Math.pow(2, retryCount));\n return this.client.request(config);\n }\n }\n\n // Transform to SDK errors\n throw this.transformError(error);\n },\n );\n }\n\n private shouldRetry(error: AxiosError): boolean {\n // Retry on network errors or 5xx server errors\n if (!error.response) return true;\n return error.response.status >= 500 && error.response.status < 600;\n }\n\n private transformError(error: AxiosError): DatashiftError {\n if (!error.response) {\n return new DatashiftError(\n 'Network error: Unable to reach Datashift API',\n undefined,\n 'NETWORK_ERROR',\n );\n }\n\n const status = error.response.status;\n const data = error.response.data as any;\n const message = data?.message || error.message;\n\n switch (status) {\n case 401:\n return new AuthenticationError(message);\n case 404:\n return new NotFoundError('Resource', data?.entityId);\n case 400:\n return new ValidationError(message, data?.errors);\n case 429:\n return new RateLimitError(data?.retryAfter);\n case 500:\n case 502:\n case 503:\n case 504:\n return new ServerError(message);\n default:\n return new DatashiftError(message, status, data?.code, data);\n }\n }\n\n private sleep(ms: number): Promise<void> {\n return new Promise((resolve) => setTimeout(resolve, ms));\n }\n}\n"]}
|