@datashift/sdk 0.1.2 → 0.2.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 +14 -17
- package/dist/index.d.mts +6 -6
- package/dist/index.d.ts +6 -6
- package/dist/index.js +4 -4
- package/dist/index.js.map +1 -1
- package/dist/index.mjs +4 -4
- package/dist/index.mjs.map +1 -1
- package/package.json +14 -11
package/README.md
CHANGED
|
@@ -4,7 +4,7 @@ TypeScript SDK for integrating human-in-the-loop checkpoints into AI agent workf
|
|
|
4
4
|
|
|
5
5
|
## Overview
|
|
6
6
|
|
|
7
|
-
Datashift enables AI agents to submit tasks for human review before committing changes.
|
|
7
|
+
Datashift enables AI agents to submit tasks for human review before committing changes.
|
|
8
8
|
|
|
9
9
|
## Installation
|
|
10
10
|
|
|
@@ -79,17 +79,14 @@ const task = await datashift.task.submit({
|
|
|
79
79
|
// Get task by ID
|
|
80
80
|
const task = await datashift.task.get(taskId);
|
|
81
81
|
|
|
82
|
-
// Get task status (lightweight)
|
|
83
|
-
const status = await datashift.task.getStatus(taskId);
|
|
84
|
-
|
|
85
82
|
// List tasks
|
|
86
83
|
const tasks = await datashift.task.list({
|
|
87
84
|
queueId?: string;
|
|
88
|
-
state?: 'pending' | 'queued' | '
|
|
85
|
+
state?: 'pending' | 'queued' | 'reviewed';
|
|
89
86
|
});
|
|
90
87
|
|
|
91
88
|
// Wait for review
|
|
92
|
-
const
|
|
89
|
+
const reviewed = await datashift.task.waitForReview(taskId, {
|
|
93
90
|
timeout: 300000, // 5 minutes
|
|
94
91
|
pollInterval: 2000, // Start at 2s
|
|
95
92
|
maxPollInterval: 30000 // Back off to 30s
|
|
@@ -127,7 +124,7 @@ const review = await datashift.review.get(reviewId);
|
|
|
127
124
|
// Create webhook
|
|
128
125
|
const webhook = await datashift.webhook.create({
|
|
129
126
|
url: 'https://your-service.com/webhook',
|
|
130
|
-
events: ['task.
|
|
127
|
+
events: ['task.reviewed'],
|
|
131
128
|
});
|
|
132
129
|
// Save webhook.secret securely!
|
|
133
130
|
|
|
@@ -137,7 +134,7 @@ const webhooks = await datashift.webhook.list();
|
|
|
137
134
|
// Update webhook
|
|
138
135
|
const updated = await datashift.webhook.update(webhookId, {
|
|
139
136
|
url: 'https://new-url.com/webhook',
|
|
140
|
-
events: ['task.
|
|
137
|
+
events: ['task.reviewed', 'task.created'],
|
|
141
138
|
active: true,
|
|
142
139
|
});
|
|
143
140
|
|
|
@@ -154,7 +151,7 @@ await datashift.webhook.delete(webhookId);
|
|
|
154
151
|
|
|
155
152
|
## Webhooks
|
|
156
153
|
|
|
157
|
-
Webhooks provide async notifications when tasks are
|
|
154
|
+
Webhooks provide async notifications when tasks are reviewed.
|
|
158
155
|
|
|
159
156
|
### Setting Up a Webhook Endpoint
|
|
160
157
|
|
|
@@ -179,9 +176,9 @@ app.post('/webhook/datashift',
|
|
|
179
176
|
// Parse event
|
|
180
177
|
const event = parseWebhookEvent<WebhookEvent>(req.body);
|
|
181
178
|
|
|
182
|
-
if (event.event === 'task.
|
|
179
|
+
if (event.event === 'task.reviewed') {
|
|
183
180
|
const {task_id, result, review} = event.data;
|
|
184
|
-
|
|
181
|
+
handleTaskReviewed(task_id, result, review);
|
|
185
182
|
}
|
|
186
183
|
|
|
187
184
|
res.status(200).send('OK');
|
|
@@ -193,7 +190,7 @@ app.post('/webhook/datashift',
|
|
|
193
190
|
|
|
194
191
|
| Event | Description |
|
|
195
192
|
|------------------|--------------------------------|
|
|
196
|
-
| `task.
|
|
193
|
+
| `task.reviewed` | Task has been reviewed |
|
|
197
194
|
|
|
198
195
|
### Webhook Payload
|
|
199
196
|
|
|
@@ -220,13 +217,13 @@ interface Task {
|
|
|
220
217
|
id: string;
|
|
221
218
|
queue_id: string;
|
|
222
219
|
external_id: string | null;
|
|
223
|
-
state: 'pending' | 'queued' | '
|
|
220
|
+
state: 'pending' | 'queued' | 'reviewed';
|
|
224
221
|
data: Record<string, unknown>;
|
|
225
222
|
context: Record<string, unknown>;
|
|
226
223
|
metadata: Record<string, unknown>;
|
|
227
224
|
summary: string | null;
|
|
228
225
|
sla_deadline: string | null;
|
|
229
|
-
|
|
226
|
+
reviewed_at: string | null;
|
|
230
227
|
created_at: string;
|
|
231
228
|
updated_at: string;
|
|
232
229
|
reviews?: Review[];
|
|
@@ -285,7 +282,7 @@ interface ReviewResult {
|
|
|
285
282
|
task_id: string;
|
|
286
283
|
result: string[];
|
|
287
284
|
data: Record<string, unknown>;
|
|
288
|
-
|
|
285
|
+
reviewed_at: string;
|
|
289
286
|
review: Review;
|
|
290
287
|
}
|
|
291
288
|
```
|
|
@@ -309,7 +306,7 @@ try {
|
|
|
309
306
|
const result = await datashift.task.waitForReview(taskId, {timeout: 60000});
|
|
310
307
|
} catch (error) {
|
|
311
308
|
if (error instanceof TimeoutError) {
|
|
312
|
-
console.log('Review not
|
|
309
|
+
console.log('Review not finished in time');
|
|
313
310
|
} else if (error instanceof AuthenticationError) {
|
|
314
311
|
console.log('Invalid credentials');
|
|
315
312
|
} else if (error instanceof NotFoundError) {
|
|
@@ -385,7 +382,7 @@ app.post('/webhook/datashift',
|
|
|
385
382
|
|
|
386
383
|
const event = parseWebhookEvent<WebhookEvent>(req.body);
|
|
387
384
|
|
|
388
|
-
if (event.event === 'task.
|
|
385
|
+
if (event.event === 'task.reviewed') {
|
|
389
386
|
const resolver = pendingTasks.get(event.data.task_id);
|
|
390
387
|
if (resolver) {
|
|
391
388
|
resolver(event.data);
|
package/dist/index.d.mts
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { AxiosInstance } from 'axios';
|
|
2
2
|
|
|
3
|
-
type TaskState = 'pending' | 'queued' | '
|
|
3
|
+
type TaskState = 'pending' | 'queued' | 'reviewed';
|
|
4
4
|
interface Task {
|
|
5
5
|
id: string;
|
|
6
6
|
organization_id: string;
|
|
@@ -12,7 +12,7 @@ interface Task {
|
|
|
12
12
|
metadata: Record<string, unknown>;
|
|
13
13
|
summary: string | null;
|
|
14
14
|
sla_deadline: string | null;
|
|
15
|
-
|
|
15
|
+
reviewed_at: string | null;
|
|
16
16
|
created_at: string;
|
|
17
17
|
updated_at: string;
|
|
18
18
|
queue?: Queue;
|
|
@@ -20,7 +20,7 @@ interface Task {
|
|
|
20
20
|
}
|
|
21
21
|
interface TaskStatus {
|
|
22
22
|
state: TaskState;
|
|
23
|
-
|
|
23
|
+
reviewed_at: string | null;
|
|
24
24
|
}
|
|
25
25
|
interface SubmitTaskInput {
|
|
26
26
|
queueKey: string;
|
|
@@ -88,7 +88,7 @@ interface ReviewResult {
|
|
|
88
88
|
task_id: string;
|
|
89
89
|
result: string[];
|
|
90
90
|
data: Record<string, unknown>;
|
|
91
|
-
|
|
91
|
+
reviewed_at: string;
|
|
92
92
|
review: Review;
|
|
93
93
|
}
|
|
94
94
|
|
|
@@ -106,7 +106,7 @@ declare class TaskResource {
|
|
|
106
106
|
/**
|
|
107
107
|
* Get task status
|
|
108
108
|
*/
|
|
109
|
-
getStatus
|
|
109
|
+
private getStatus;
|
|
110
110
|
/**
|
|
111
111
|
* List tasks with optional filters
|
|
112
112
|
*/
|
|
@@ -156,7 +156,7 @@ declare class ReviewResource {
|
|
|
156
156
|
* @example
|
|
157
157
|
* ```typescript
|
|
158
158
|
* const datashift = new DatashiftRestClient({
|
|
159
|
-
* apiKey: '
|
|
159
|
+
* apiKey: 'sk_...',
|
|
160
160
|
* });
|
|
161
161
|
*
|
|
162
162
|
* const task = await datashift.task.submit({
|
package/dist/index.d.ts
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { AxiosInstance } from 'axios';
|
|
2
2
|
|
|
3
|
-
type TaskState = 'pending' | 'queued' | '
|
|
3
|
+
type TaskState = 'pending' | 'queued' | 'reviewed';
|
|
4
4
|
interface Task {
|
|
5
5
|
id: string;
|
|
6
6
|
organization_id: string;
|
|
@@ -12,7 +12,7 @@ interface Task {
|
|
|
12
12
|
metadata: Record<string, unknown>;
|
|
13
13
|
summary: string | null;
|
|
14
14
|
sla_deadline: string | null;
|
|
15
|
-
|
|
15
|
+
reviewed_at: string | null;
|
|
16
16
|
created_at: string;
|
|
17
17
|
updated_at: string;
|
|
18
18
|
queue?: Queue;
|
|
@@ -20,7 +20,7 @@ interface Task {
|
|
|
20
20
|
}
|
|
21
21
|
interface TaskStatus {
|
|
22
22
|
state: TaskState;
|
|
23
|
-
|
|
23
|
+
reviewed_at: string | null;
|
|
24
24
|
}
|
|
25
25
|
interface SubmitTaskInput {
|
|
26
26
|
queueKey: string;
|
|
@@ -88,7 +88,7 @@ interface ReviewResult {
|
|
|
88
88
|
task_id: string;
|
|
89
89
|
result: string[];
|
|
90
90
|
data: Record<string, unknown>;
|
|
91
|
-
|
|
91
|
+
reviewed_at: string;
|
|
92
92
|
review: Review;
|
|
93
93
|
}
|
|
94
94
|
|
|
@@ -106,7 +106,7 @@ declare class TaskResource {
|
|
|
106
106
|
/**
|
|
107
107
|
* Get task status
|
|
108
108
|
*/
|
|
109
|
-
getStatus
|
|
109
|
+
private getStatus;
|
|
110
110
|
/**
|
|
111
111
|
* List tasks with optional filters
|
|
112
112
|
*/
|
|
@@ -156,7 +156,7 @@ declare class ReviewResource {
|
|
|
156
156
|
* @example
|
|
157
157
|
* ```typescript
|
|
158
158
|
* const datashift = new DatashiftRestClient({
|
|
159
|
-
* apiKey: '
|
|
159
|
+
* apiKey: 'sk_...',
|
|
160
160
|
* });
|
|
161
161
|
*
|
|
162
162
|
* const task = await datashift.task.submit({
|
package/dist/index.js
CHANGED
|
@@ -19,8 +19,8 @@ function validateApiKey(apiKey) {
|
|
|
19
19
|
if (!apiKey) {
|
|
20
20
|
throw new Error("API key is required");
|
|
21
21
|
}
|
|
22
|
-
if (!apiKey.startsWith("
|
|
23
|
-
throw new Error("Invalid API key format. Expected
|
|
22
|
+
if (!apiKey.startsWith("sk_")) {
|
|
23
|
+
throw new Error("Invalid API key format. Expected sk_");
|
|
24
24
|
}
|
|
25
25
|
}
|
|
26
26
|
|
|
@@ -136,14 +136,14 @@ var TaskResource = class {
|
|
|
136
136
|
let currentInterval = opts.pollInterval;
|
|
137
137
|
while (Date.now() - startTime < opts.timeout) {
|
|
138
138
|
const status = await this.getStatus(taskId);
|
|
139
|
-
if (status.state === "
|
|
139
|
+
if (status.state === "reviewed") {
|
|
140
140
|
return this.get(taskId);
|
|
141
141
|
}
|
|
142
142
|
await this.sleep(currentInterval);
|
|
143
143
|
currentInterval = Math.min(currentInterval * 1.5, opts.maxPollInterval);
|
|
144
144
|
}
|
|
145
145
|
throw new TimeoutError(
|
|
146
|
-
`Task ${taskId} was not
|
|
146
|
+
`Task ${taskId} was not reviewed within ${opts.timeout}ms`
|
|
147
147
|
);
|
|
148
148
|
}
|
|
149
149
|
sleep(ms) {
|
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_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"]}
|
|
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"]}
|
package/dist/index.mjs
CHANGED
|
@@ -13,8 +13,8 @@ function validateApiKey(apiKey) {
|
|
|
13
13
|
if (!apiKey) {
|
|
14
14
|
throw new Error("API key is required");
|
|
15
15
|
}
|
|
16
|
-
if (!apiKey.startsWith("
|
|
17
|
-
throw new Error("Invalid API key format. Expected
|
|
16
|
+
if (!apiKey.startsWith("sk_")) {
|
|
17
|
+
throw new Error("Invalid API key format. Expected sk_");
|
|
18
18
|
}
|
|
19
19
|
}
|
|
20
20
|
|
|
@@ -130,14 +130,14 @@ var TaskResource = class {
|
|
|
130
130
|
let currentInterval = opts.pollInterval;
|
|
131
131
|
while (Date.now() - startTime < opts.timeout) {
|
|
132
132
|
const status = await this.getStatus(taskId);
|
|
133
|
-
if (status.state === "
|
|
133
|
+
if (status.state === "reviewed") {
|
|
134
134
|
return this.get(taskId);
|
|
135
135
|
}
|
|
136
136
|
await this.sleep(currentInterval);
|
|
137
137
|
currentInterval = Math.min(currentInterval * 1.5, opts.maxPollInterval);
|
|
138
138
|
}
|
|
139
139
|
throw new TimeoutError(
|
|
140
|
-
`Task ${taskId} was not
|
|
140
|
+
`Task ${taskId} was not reviewed within ${opts.timeout}ms`
|
|
141
141
|
);
|
|
142
142
|
}
|
|
143
143
|
sleep(ms) {
|
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_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"]}
|
|
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"]}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@datashift/sdk",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.2.0",
|
|
4
4
|
"description": "Datashift SDK for human-in-the-loop AI agent workflows",
|
|
5
5
|
"main": "./dist/index.js",
|
|
6
6
|
"module": "./dist/index.mjs",
|
|
@@ -18,8 +18,8 @@
|
|
|
18
18
|
"scripts": {
|
|
19
19
|
"build": "tsup",
|
|
20
20
|
"dev": "tsup --watch",
|
|
21
|
-
"test": "jest",
|
|
22
|
-
"lint": "eslint src
|
|
21
|
+
"test": "jest --passWithNoTests",
|
|
22
|
+
"lint": "eslint src",
|
|
23
23
|
"typecheck": "tsc --noEmit",
|
|
24
24
|
"prepublishOnly": "npm run build"
|
|
25
25
|
},
|
|
@@ -44,17 +44,20 @@
|
|
|
44
44
|
"axios": "^1.7.0"
|
|
45
45
|
},
|
|
46
46
|
"devDependencies": {
|
|
47
|
-
"@
|
|
48
|
-
"@types/
|
|
49
|
-
"@
|
|
50
|
-
"
|
|
51
|
-
"
|
|
52
|
-
"jest": "^29.7.0",
|
|
47
|
+
"@eslint/js": "^10.0.1",
|
|
48
|
+
"@types/jest": "^30.0.0",
|
|
49
|
+
"@types/node": "^25.3.0",
|
|
50
|
+
"eslint": "^10.0.0",
|
|
51
|
+
"jest": "^30.2.0",
|
|
53
52
|
"ts-jest": "^29.1.0",
|
|
54
53
|
"tsup": "^8.0.0",
|
|
55
|
-
"typescript": "^5.4.0"
|
|
54
|
+
"typescript": "^5.4.0",
|
|
55
|
+
"typescript-eslint": "^8.56.0"
|
|
56
|
+
},
|
|
57
|
+
"overrides": {
|
|
58
|
+
"minimatch": ">=10.2.1"
|
|
56
59
|
},
|
|
57
60
|
"engines": {
|
|
58
|
-
"node": ">=
|
|
61
|
+
"node": ">=20.0.0"
|
|
59
62
|
}
|
|
60
63
|
}
|