@datashift/sdk 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +411 -0
- package/dist/index.d.mts +232 -0
- package/dist/index.d.ts +232 -0
- package/dist/index.js +305 -0
- package/dist/index.js.map +1 -0
- package/dist/index.mjs +292 -0
- package/dist/index.mjs.map +1 -0
- package/package.json +60 -0
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1,232 @@
|
|
|
1
|
+
import { AxiosInstance } from 'axios';
|
|
2
|
+
|
|
3
|
+
type TaskState = 'pending' | 'queued' | 'completed';
|
|
4
|
+
interface Task {
|
|
5
|
+
id: string;
|
|
6
|
+
organization_id: string;
|
|
7
|
+
queue_id: string;
|
|
8
|
+
external_id: string | null;
|
|
9
|
+
state: TaskState;
|
|
10
|
+
data: Record<string, unknown>;
|
|
11
|
+
context: Record<string, unknown>;
|
|
12
|
+
metadata: Record<string, unknown>;
|
|
13
|
+
summary: string | null;
|
|
14
|
+
sla_deadline: string | null;
|
|
15
|
+
completed_at: string | null;
|
|
16
|
+
created_at: string;
|
|
17
|
+
updated_at: string;
|
|
18
|
+
queue?: Queue;
|
|
19
|
+
reviews?: Review[];
|
|
20
|
+
}
|
|
21
|
+
interface TaskStatus {
|
|
22
|
+
state: TaskState;
|
|
23
|
+
completed_at: string | null;
|
|
24
|
+
}
|
|
25
|
+
interface SubmitTaskInput {
|
|
26
|
+
queueKey: string;
|
|
27
|
+
data: Record<string, unknown>;
|
|
28
|
+
context?: Record<string, unknown>;
|
|
29
|
+
metadata?: Record<string, unknown>;
|
|
30
|
+
summary?: string;
|
|
31
|
+
externalId?: string;
|
|
32
|
+
}
|
|
33
|
+
type ReviewType = 'approval' | 'labeling' | 'classification' | 'scoring' | 'augmentation';
|
|
34
|
+
type AssignmentStrategy = 'manual' | 'round_robin' | 'ai_first' | 'ai_last';
|
|
35
|
+
interface ReviewOption {
|
|
36
|
+
id: string;
|
|
37
|
+
label: string;
|
|
38
|
+
display_order: number;
|
|
39
|
+
}
|
|
40
|
+
interface Queue {
|
|
41
|
+
id: string;
|
|
42
|
+
organization_id: string;
|
|
43
|
+
key: string;
|
|
44
|
+
name: string;
|
|
45
|
+
description: string | null;
|
|
46
|
+
review_type: ReviewType;
|
|
47
|
+
review_options: ReviewOption[];
|
|
48
|
+
multi_select: boolean;
|
|
49
|
+
assignment: AssignmentStrategy;
|
|
50
|
+
sla_minutes: number | null;
|
|
51
|
+
deleted_at: string | null;
|
|
52
|
+
created_at: string;
|
|
53
|
+
updated_at: string;
|
|
54
|
+
}
|
|
55
|
+
interface Review {
|
|
56
|
+
id: string;
|
|
57
|
+
task_id: string;
|
|
58
|
+
queue_id: string | null;
|
|
59
|
+
reviewer_id: string | null;
|
|
60
|
+
result: string[];
|
|
61
|
+
data: Record<string, unknown>;
|
|
62
|
+
comment: string | null;
|
|
63
|
+
created_at: string;
|
|
64
|
+
}
|
|
65
|
+
interface ListReviewsFilters {
|
|
66
|
+
taskId?: string;
|
|
67
|
+
reviewerId?: string;
|
|
68
|
+
queueKey?: string;
|
|
69
|
+
reviewerType?: 'ai' | 'human';
|
|
70
|
+
from?: Date | string;
|
|
71
|
+
to?: Date | string;
|
|
72
|
+
limit?: number;
|
|
73
|
+
offset?: number;
|
|
74
|
+
}
|
|
75
|
+
interface RestClientConfig {
|
|
76
|
+
apiKey: string;
|
|
77
|
+
baseUrl?: string;
|
|
78
|
+
timeout?: number;
|
|
79
|
+
retries?: number;
|
|
80
|
+
retryDelay?: number;
|
|
81
|
+
}
|
|
82
|
+
interface WaitOptions {
|
|
83
|
+
timeout?: number;
|
|
84
|
+
pollInterval?: number;
|
|
85
|
+
maxPollInterval?: number;
|
|
86
|
+
}
|
|
87
|
+
interface ReviewResult {
|
|
88
|
+
task_id: string;
|
|
89
|
+
result: string[];
|
|
90
|
+
data: Record<string, unknown>;
|
|
91
|
+
completed_at: string;
|
|
92
|
+
review: Review;
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
declare class TaskResource {
|
|
96
|
+
private client;
|
|
97
|
+
constructor(client: AxiosInstance);
|
|
98
|
+
/**
|
|
99
|
+
* Submit a task for human review
|
|
100
|
+
*/
|
|
101
|
+
submit(input: SubmitTaskInput): Promise<Task>;
|
|
102
|
+
/**
|
|
103
|
+
* Get a task by ID with full details
|
|
104
|
+
*/
|
|
105
|
+
get(taskId: string): Promise<Task>;
|
|
106
|
+
/**
|
|
107
|
+
* Get task status
|
|
108
|
+
*/
|
|
109
|
+
getStatus(taskId: string): Promise<TaskStatus>;
|
|
110
|
+
/**
|
|
111
|
+
* List tasks with optional filters
|
|
112
|
+
*/
|
|
113
|
+
list(filters?: {
|
|
114
|
+
queueId?: string;
|
|
115
|
+
state?: string;
|
|
116
|
+
}): Promise<Task[]>;
|
|
117
|
+
/**
|
|
118
|
+
* Wait for a task to be reviewed
|
|
119
|
+
*/
|
|
120
|
+
waitForReview(taskId: string, options?: WaitOptions): Promise<Task>;
|
|
121
|
+
private sleep;
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
declare class QueueResource {
|
|
125
|
+
private client;
|
|
126
|
+
constructor(client: AxiosInstance);
|
|
127
|
+
/**
|
|
128
|
+
* List all queues available to the organization
|
|
129
|
+
*/
|
|
130
|
+
list(): Promise<Queue[]>;
|
|
131
|
+
/**
|
|
132
|
+
* Get a queue by key
|
|
133
|
+
*/
|
|
134
|
+
get(key: string): Promise<Queue>;
|
|
135
|
+
}
|
|
136
|
+
|
|
137
|
+
declare class ReviewResource {
|
|
138
|
+
private client;
|
|
139
|
+
constructor(client: AxiosInstance);
|
|
140
|
+
/**
|
|
141
|
+
* List reviews with optional filters
|
|
142
|
+
*/
|
|
143
|
+
list(filters?: ListReviewsFilters): Promise<Review[]>;
|
|
144
|
+
/**
|
|
145
|
+
* Get a review by ID
|
|
146
|
+
*/
|
|
147
|
+
get(reviewId: string): Promise<Review>;
|
|
148
|
+
}
|
|
149
|
+
|
|
150
|
+
/**
|
|
151
|
+
* Datashift REST API client
|
|
152
|
+
*
|
|
153
|
+
* Use this client for backend service integrations with API key authentication.
|
|
154
|
+
* For AI agents with real-time push notifications, use DatashiftMcpClient instead.
|
|
155
|
+
*
|
|
156
|
+
* @example
|
|
157
|
+
* ```typescript
|
|
158
|
+
* const datashift = new DatashiftRestClient({
|
|
159
|
+
* apiKey: 'sk_live_...',
|
|
160
|
+
* });
|
|
161
|
+
*
|
|
162
|
+
* const task = await datashift.task.submit({
|
|
163
|
+
* queueKey: 'approvals',
|
|
164
|
+
* data: { action: 'delete-account' },
|
|
165
|
+
* });
|
|
166
|
+
*
|
|
167
|
+
* const result = await datashift.task.waitForReview(task.id);
|
|
168
|
+
* ```
|
|
169
|
+
*/
|
|
170
|
+
declare class DatashiftRestClient {
|
|
171
|
+
private client;
|
|
172
|
+
private retries;
|
|
173
|
+
private retryDelay;
|
|
174
|
+
readonly task: TaskResource;
|
|
175
|
+
readonly queue: QueueResource;
|
|
176
|
+
readonly review: ReviewResource;
|
|
177
|
+
constructor(config: RestClientConfig);
|
|
178
|
+
private setupErrorInterceptor;
|
|
179
|
+
private shouldRetry;
|
|
180
|
+
private transformError;
|
|
181
|
+
private sleep;
|
|
182
|
+
}
|
|
183
|
+
|
|
184
|
+
/**
|
|
185
|
+
* Base error class for all Datashift SDK errors
|
|
186
|
+
*/
|
|
187
|
+
declare class DatashiftError extends Error {
|
|
188
|
+
status?: number | undefined;
|
|
189
|
+
code?: string | undefined;
|
|
190
|
+
data?: unknown | undefined;
|
|
191
|
+
constructor(message: string, status?: number | undefined, code?: string | undefined, data?: unknown | undefined);
|
|
192
|
+
}
|
|
193
|
+
/**
|
|
194
|
+
* Thrown when authentication fails (invalid API key, expired token, etc.)
|
|
195
|
+
*/
|
|
196
|
+
declare class AuthenticationError extends DatashiftError {
|
|
197
|
+
constructor(message?: string);
|
|
198
|
+
}
|
|
199
|
+
/**
|
|
200
|
+
* Thrown when a requested resource is not found
|
|
201
|
+
*/
|
|
202
|
+
declare class NotFoundError extends DatashiftError {
|
|
203
|
+
constructor(resource: string, id?: string);
|
|
204
|
+
}
|
|
205
|
+
/**
|
|
206
|
+
* Thrown when request validation fails
|
|
207
|
+
*/
|
|
208
|
+
declare class ValidationError extends DatashiftError {
|
|
209
|
+
errors?: Record<string, string[]> | undefined;
|
|
210
|
+
constructor(message: string, errors?: Record<string, string[]> | undefined);
|
|
211
|
+
}
|
|
212
|
+
/**
|
|
213
|
+
* Thrown when an operation times out
|
|
214
|
+
*/
|
|
215
|
+
declare class TimeoutError extends DatashiftError {
|
|
216
|
+
constructor(message?: string);
|
|
217
|
+
}
|
|
218
|
+
/**
|
|
219
|
+
* Thrown when rate limited
|
|
220
|
+
*/
|
|
221
|
+
declare class RateLimitError extends DatashiftError {
|
|
222
|
+
retryAfter?: number | undefined;
|
|
223
|
+
constructor(retryAfter?: number | undefined);
|
|
224
|
+
}
|
|
225
|
+
/**
|
|
226
|
+
* Thrown when the server returns an error
|
|
227
|
+
*/
|
|
228
|
+
declare class ServerError extends DatashiftError {
|
|
229
|
+
constructor(message?: string);
|
|
230
|
+
}
|
|
231
|
+
|
|
232
|
+
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 TaskState, type TaskStatus, TimeoutError, ValidationError, type WaitOptions };
|
package/dist/index.js
ADDED
|
@@ -0,0 +1,305 @@
|
|
|
1
|
+
'use strict';
|
|
2
|
+
|
|
3
|
+
var axios = require('axios');
|
|
4
|
+
|
|
5
|
+
function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
|
|
6
|
+
|
|
7
|
+
var axios__default = /*#__PURE__*/_interopDefault(axios);
|
|
8
|
+
|
|
9
|
+
// src/rest-client.ts
|
|
10
|
+
|
|
11
|
+
// src/auth/api-key.ts
|
|
12
|
+
function configureApiKeyAuth(client, apiKey) {
|
|
13
|
+
client.interceptors.request.use((config) => {
|
|
14
|
+
config.headers.Authorization = `Bearer ${apiKey}`;
|
|
15
|
+
return config;
|
|
16
|
+
});
|
|
17
|
+
}
|
|
18
|
+
function validateApiKey(apiKey) {
|
|
19
|
+
if (!apiKey) {
|
|
20
|
+
throw new Error("API key is required");
|
|
21
|
+
}
|
|
22
|
+
if (!apiKey.startsWith("sk_live_") && !apiKey.startsWith("sk_test_")) {
|
|
23
|
+
throw new Error("Invalid API key format. Expected sk_live_* or sk_test_*");
|
|
24
|
+
}
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
// src/errors.ts
|
|
28
|
+
var DatashiftError = class extends Error {
|
|
29
|
+
constructor(message, status, code, data) {
|
|
30
|
+
super(message);
|
|
31
|
+
this.status = status;
|
|
32
|
+
this.code = code;
|
|
33
|
+
this.data = data;
|
|
34
|
+
this.name = "DatashiftError";
|
|
35
|
+
Error.captureStackTrace?.(this, this.constructor);
|
|
36
|
+
}
|
|
37
|
+
};
|
|
38
|
+
var AuthenticationError = class extends DatashiftError {
|
|
39
|
+
constructor(message = "Authentication failed") {
|
|
40
|
+
super(message, 401, "AUTHENTICATION_ERROR");
|
|
41
|
+
this.name = "AuthenticationError";
|
|
42
|
+
}
|
|
43
|
+
};
|
|
44
|
+
var NotFoundError = class extends DatashiftError {
|
|
45
|
+
constructor(resource, id) {
|
|
46
|
+
const message = id ? `${resource} '${id}' not found` : `${resource} not found`;
|
|
47
|
+
super(message, 404, "NOT_FOUND");
|
|
48
|
+
this.name = "NotFoundError";
|
|
49
|
+
}
|
|
50
|
+
};
|
|
51
|
+
var ValidationError = class extends DatashiftError {
|
|
52
|
+
constructor(message, errors) {
|
|
53
|
+
super(message, 400, "VALIDATION_ERROR", errors);
|
|
54
|
+
this.errors = errors;
|
|
55
|
+
this.name = "ValidationError";
|
|
56
|
+
}
|
|
57
|
+
};
|
|
58
|
+
var TimeoutError = class extends DatashiftError {
|
|
59
|
+
constructor(message = "Operation timed out") {
|
|
60
|
+
super(message, 408, "TIMEOUT");
|
|
61
|
+
this.name = "TimeoutError";
|
|
62
|
+
}
|
|
63
|
+
};
|
|
64
|
+
var RateLimitError = class extends DatashiftError {
|
|
65
|
+
constructor(retryAfter) {
|
|
66
|
+
super("Rate limit exceeded", 429, "RATE_LIMITED");
|
|
67
|
+
this.retryAfter = retryAfter;
|
|
68
|
+
this.name = "RateLimitError";
|
|
69
|
+
}
|
|
70
|
+
};
|
|
71
|
+
var ServerError = class extends DatashiftError {
|
|
72
|
+
constructor(message = "Internal server error") {
|
|
73
|
+
super(message, 500, "SERVER_ERROR");
|
|
74
|
+
this.name = "ServerError";
|
|
75
|
+
}
|
|
76
|
+
};
|
|
77
|
+
|
|
78
|
+
// src/resources/task.ts
|
|
79
|
+
var DEFAULT_WAIT_OPTIONS = {
|
|
80
|
+
timeout: 3e5,
|
|
81
|
+
// 5 minutes
|
|
82
|
+
pollInterval: 2e3,
|
|
83
|
+
// 2 seconds
|
|
84
|
+
maxPollInterval: 3e4
|
|
85
|
+
// 30 seconds
|
|
86
|
+
};
|
|
87
|
+
var TaskResource = class {
|
|
88
|
+
constructor(client) {
|
|
89
|
+
this.client = client;
|
|
90
|
+
}
|
|
91
|
+
/**
|
|
92
|
+
* Submit a task for human review
|
|
93
|
+
*/
|
|
94
|
+
async submit(input) {
|
|
95
|
+
const response = await this.client.post("/task", {
|
|
96
|
+
queue_key: input.queueKey,
|
|
97
|
+
data: input.data,
|
|
98
|
+
context: input.context ?? {},
|
|
99
|
+
metadata: input.metadata ?? {},
|
|
100
|
+
summary: input.summary,
|
|
101
|
+
external_id: input.externalId
|
|
102
|
+
});
|
|
103
|
+
return response.data;
|
|
104
|
+
}
|
|
105
|
+
/**
|
|
106
|
+
* Get a task by ID with full details
|
|
107
|
+
*/
|
|
108
|
+
async get(taskId) {
|
|
109
|
+
const response = await this.client.get(`/task/${taskId}`);
|
|
110
|
+
return response.data;
|
|
111
|
+
}
|
|
112
|
+
/**
|
|
113
|
+
* Get task status
|
|
114
|
+
*/
|
|
115
|
+
async getStatus(taskId) {
|
|
116
|
+
const response = await this.client.get(`/task/${taskId}/status`);
|
|
117
|
+
return response.data;
|
|
118
|
+
}
|
|
119
|
+
/**
|
|
120
|
+
* List tasks with optional filters
|
|
121
|
+
*/
|
|
122
|
+
async list(filters) {
|
|
123
|
+
const params = new URLSearchParams();
|
|
124
|
+
if (filters?.queueId) params.append("queue_id", filters.queueId);
|
|
125
|
+
if (filters?.state) params.append("state", filters.state);
|
|
126
|
+
const query = params.toString();
|
|
127
|
+
const response = await this.client.get(`/task${query ? `?${query}` : ""}`);
|
|
128
|
+
return response.data;
|
|
129
|
+
}
|
|
130
|
+
/**
|
|
131
|
+
* Wait for a task to be reviewed
|
|
132
|
+
*/
|
|
133
|
+
async waitForReview(taskId, options) {
|
|
134
|
+
const opts = { ...DEFAULT_WAIT_OPTIONS, ...options };
|
|
135
|
+
const startTime = Date.now();
|
|
136
|
+
let currentInterval = opts.pollInterval;
|
|
137
|
+
while (Date.now() - startTime < opts.timeout) {
|
|
138
|
+
const status = await this.getStatus(taskId);
|
|
139
|
+
if (status.state === "completed") {
|
|
140
|
+
return this.get(taskId);
|
|
141
|
+
}
|
|
142
|
+
await this.sleep(currentInterval);
|
|
143
|
+
currentInterval = Math.min(currentInterval * 1.5, opts.maxPollInterval);
|
|
144
|
+
}
|
|
145
|
+
throw new TimeoutError(
|
|
146
|
+
`Task ${taskId} was not completed within ${opts.timeout}ms`
|
|
147
|
+
);
|
|
148
|
+
}
|
|
149
|
+
sleep(ms) {
|
|
150
|
+
return new Promise((resolve) => setTimeout(resolve, ms));
|
|
151
|
+
}
|
|
152
|
+
};
|
|
153
|
+
|
|
154
|
+
// src/resources/queue.ts
|
|
155
|
+
var QueueResource = class {
|
|
156
|
+
constructor(client) {
|
|
157
|
+
this.client = client;
|
|
158
|
+
}
|
|
159
|
+
/**
|
|
160
|
+
* List all queues available to the organization
|
|
161
|
+
*/
|
|
162
|
+
async list() {
|
|
163
|
+
const response = await this.client.get("/queue");
|
|
164
|
+
return response.data;
|
|
165
|
+
}
|
|
166
|
+
/**
|
|
167
|
+
* Get a queue by key
|
|
168
|
+
*/
|
|
169
|
+
async get(key) {
|
|
170
|
+
const response = await this.client.get(`/queue/${key}`);
|
|
171
|
+
return response.data;
|
|
172
|
+
}
|
|
173
|
+
};
|
|
174
|
+
|
|
175
|
+
// src/resources/review.ts
|
|
176
|
+
var ReviewResource = class {
|
|
177
|
+
constructor(client) {
|
|
178
|
+
this.client = client;
|
|
179
|
+
}
|
|
180
|
+
/**
|
|
181
|
+
* List reviews with optional filters
|
|
182
|
+
*/
|
|
183
|
+
async list(filters) {
|
|
184
|
+
const params = new URLSearchParams();
|
|
185
|
+
if (filters?.taskId) params.append("task_id", filters.taskId);
|
|
186
|
+
if (filters?.reviewerId) params.append("reviewer_id", filters.reviewerId);
|
|
187
|
+
if (filters?.queueKey) params.append("queue_key", filters.queueKey);
|
|
188
|
+
if (filters?.reviewerType) params.append("reviewer_type", filters.reviewerType);
|
|
189
|
+
if (filters?.from) {
|
|
190
|
+
const date = filters.from instanceof Date ? filters.from.toISOString() : filters.from;
|
|
191
|
+
params.append("created_after", date);
|
|
192
|
+
}
|
|
193
|
+
if (filters?.to) {
|
|
194
|
+
const date = filters.to instanceof Date ? filters.to.toISOString() : filters.to;
|
|
195
|
+
params.append("created_before", date);
|
|
196
|
+
}
|
|
197
|
+
if (filters?.limit) params.append("limit", filters.limit.toString());
|
|
198
|
+
if (filters?.offset) params.append("offset", filters.offset.toString());
|
|
199
|
+
const query = params.toString();
|
|
200
|
+
const response = await this.client.get(`/review${query ? `?${query}` : ""}`);
|
|
201
|
+
return response.data;
|
|
202
|
+
}
|
|
203
|
+
/**
|
|
204
|
+
* Get a review by ID
|
|
205
|
+
*/
|
|
206
|
+
async get(reviewId) {
|
|
207
|
+
const response = await this.client.get(`/review/${reviewId}`);
|
|
208
|
+
return response.data;
|
|
209
|
+
}
|
|
210
|
+
};
|
|
211
|
+
|
|
212
|
+
// src/rest-client.ts
|
|
213
|
+
var DEFAULT_BASE_URL = "https://api.datashift.io";
|
|
214
|
+
var DEFAULT_TIMEOUT = 3e4;
|
|
215
|
+
var DEFAULT_RETRIES = 3;
|
|
216
|
+
var DEFAULT_RETRY_DELAY = 1e3;
|
|
217
|
+
var DatashiftRestClient = class {
|
|
218
|
+
client;
|
|
219
|
+
retries;
|
|
220
|
+
retryDelay;
|
|
221
|
+
task;
|
|
222
|
+
queue;
|
|
223
|
+
review;
|
|
224
|
+
constructor(config) {
|
|
225
|
+
validateApiKey(config.apiKey);
|
|
226
|
+
this.retries = config.retries ?? DEFAULT_RETRIES;
|
|
227
|
+
this.retryDelay = config.retryDelay ?? DEFAULT_RETRY_DELAY;
|
|
228
|
+
this.client = axios__default.default.create({
|
|
229
|
+
baseURL: config.baseUrl ?? DEFAULT_BASE_URL,
|
|
230
|
+
timeout: config.timeout ?? DEFAULT_TIMEOUT,
|
|
231
|
+
headers: {
|
|
232
|
+
"Content-Type": "application/json"
|
|
233
|
+
}
|
|
234
|
+
});
|
|
235
|
+
configureApiKeyAuth(this.client, config.apiKey);
|
|
236
|
+
this.setupErrorInterceptor();
|
|
237
|
+
this.task = new TaskResource(this.client);
|
|
238
|
+
this.queue = new QueueResource(this.client);
|
|
239
|
+
this.review = new ReviewResource(this.client);
|
|
240
|
+
}
|
|
241
|
+
setupErrorInterceptor() {
|
|
242
|
+
this.client.interceptors.response.use(
|
|
243
|
+
(response) => response,
|
|
244
|
+
async (error) => {
|
|
245
|
+
const config = error.config;
|
|
246
|
+
if (config && this.shouldRetry(error)) {
|
|
247
|
+
const retryCount = config.__retryCount || 0;
|
|
248
|
+
if (retryCount < this.retries) {
|
|
249
|
+
config.__retryCount = retryCount + 1;
|
|
250
|
+
await this.sleep(this.retryDelay * Math.pow(2, retryCount));
|
|
251
|
+
return this.client.request(config);
|
|
252
|
+
}
|
|
253
|
+
}
|
|
254
|
+
throw this.transformError(error);
|
|
255
|
+
}
|
|
256
|
+
);
|
|
257
|
+
}
|
|
258
|
+
shouldRetry(error) {
|
|
259
|
+
if (!error.response) return true;
|
|
260
|
+
return error.response.status >= 500 && error.response.status < 600;
|
|
261
|
+
}
|
|
262
|
+
transformError(error) {
|
|
263
|
+
if (!error.response) {
|
|
264
|
+
return new DatashiftError(
|
|
265
|
+
"Network error: Unable to reach Datashift API",
|
|
266
|
+
void 0,
|
|
267
|
+
"NETWORK_ERROR"
|
|
268
|
+
);
|
|
269
|
+
}
|
|
270
|
+
const status = error.response.status;
|
|
271
|
+
const data = error.response.data;
|
|
272
|
+
const message = data?.message || error.message;
|
|
273
|
+
switch (status) {
|
|
274
|
+
case 401:
|
|
275
|
+
return new AuthenticationError(message);
|
|
276
|
+
case 404:
|
|
277
|
+
return new NotFoundError("Resource", data?.entityId);
|
|
278
|
+
case 400:
|
|
279
|
+
return new ValidationError(message, data?.errors);
|
|
280
|
+
case 429:
|
|
281
|
+
return new RateLimitError(data?.retryAfter);
|
|
282
|
+
case 500:
|
|
283
|
+
case 502:
|
|
284
|
+
case 503:
|
|
285
|
+
case 504:
|
|
286
|
+
return new ServerError(message);
|
|
287
|
+
default:
|
|
288
|
+
return new DatashiftError(message, status, data?.code, data);
|
|
289
|
+
}
|
|
290
|
+
}
|
|
291
|
+
sleep(ms) {
|
|
292
|
+
return new Promise((resolve) => setTimeout(resolve, ms));
|
|
293
|
+
}
|
|
294
|
+
};
|
|
295
|
+
|
|
296
|
+
exports.AuthenticationError = AuthenticationError;
|
|
297
|
+
exports.DatashiftError = DatashiftError;
|
|
298
|
+
exports.DatashiftRestClient = DatashiftRestClient;
|
|
299
|
+
exports.NotFoundError = NotFoundError;
|
|
300
|
+
exports.RateLimitError = RateLimitError;
|
|
301
|
+
exports.ServerError = ServerError;
|
|
302
|
+
exports.TimeoutError = TimeoutError;
|
|
303
|
+
exports.ValidationError = ValidationError;
|
|
304
|
+
//# sourceMappingURL=index.js.map
|
|
305
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +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_live_') && !apiKey.startsWith('sk_test_')) {\n throw new Error('Invalid API key format. Expected sk_live_* or sk_test_*');\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 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 === 'completed') {\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 completed 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_live_...',\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"]}
|