@datashift/sdk 0.3.0 → 0.4.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 CHANGED
@@ -1,10 +1,13 @@
1
1
  # @datashift/sdk
2
2
 
3
+ [![npm version](https://img.shields.io/npm/v/@datashift/sdk)](https://www.npmjs.com/package/@datashift/sdk)
4
+ [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
5
+
3
6
  TypeScript SDK for integrating human-in-the-loop checkpoints into AI agent workflows.
4
7
 
5
8
  ## Overview
6
9
 
7
- Datashift enables AI agents to submit tasks for human review before committing changes.
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).
8
11
 
9
12
  ## Installation
10
13
 
@@ -229,6 +232,8 @@ interface WebhookTaskData {
229
232
  summary: string | null;
230
233
  data: Record<string, unknown>;
231
234
  metadata: Record<string, unknown>;
235
+ choices: TaskChoice[] | null; // multiple_choice queues only
236
+ max_selections: number | null; // per-task override; multiple_choice only
232
237
  sla_deadline: string | null;
233
238
  reviewed_at: string | null;
234
239
  created_at: string;
@@ -243,7 +248,7 @@ interface WebhookQueueData {
243
248
  interface WebhookReviewData {
244
249
  result: string[];
245
250
  data: Record<string, unknown>;
246
- comment: string | null;
251
+ feedback: string | null;
247
252
  reviewer: { name: string; type: string };
248
253
  created_at: string;
249
254
  }
@@ -265,6 +270,8 @@ interface Task {
265
270
  data: Record<string, unknown>;
266
271
  context: Record<string, unknown>;
267
272
  metadata: Record<string, unknown>;
273
+ choices: TaskChoice[] | null; // multiple_choice queues only
274
+ max_selections: number | null; // per-task override; multiple_choice only
268
275
  summary: string | null;
269
276
  sla_deadline: string | null;
270
277
  reviewed_at: string | null;
@@ -272,6 +279,15 @@ interface Task {
272
279
  updated_at: string;
273
280
  reviews?: Review[];
274
281
  }
282
+
283
+ interface TaskChoice {
284
+ key: string;
285
+ label: string;
286
+ description?: string | null;
287
+ // Structured per-choice fields the viewer can render alongside the label
288
+ // (e.g., address/EIN for an entity-match candidate).
289
+ data?: Record<string, unknown> | null;
290
+ }
275
291
  ```
276
292
 
277
293
  ### Queue
@@ -282,14 +298,59 @@ interface Queue {
282
298
  key: string;
283
299
  name: string;
284
300
  description: string | null;
285
- review_type: 'approval' | 'labeling' | 'classification' | 'scoring' | 'augmentation';
301
+ review_type:
302
+ | 'approval'
303
+ | 'labeling'
304
+ | 'classification'
305
+ | 'multiple_choice'
306
+ | 'scoring'
307
+ | 'augmentation';
286
308
  review_options: ReviewOption[];
309
+ // Selection primitives. review_type sets sensible defaults; explicit
310
+ // values override.
311
+ max_selections: number | null; // 1 = single-select, null = unbounded
312
+ result_required: boolean; // if false, empty selection is valid
313
+ feedback_required: 'never' | 'always' | 'when_empty';
287
314
  assignment: 'manual' | 'round_robin' | 'ai_first';
288
315
  sla_minutes: number | null;
289
316
  deleted_at: string | null;
290
317
  }
291
318
  ```
292
319
 
320
+ #### Multiple choice
321
+
322
+ Use `review_type: 'multiple_choice'` when the candidate list varies per
323
+ task (e.g., entity matching, output ranking, picking the best of N
324
+ generated drafts). Ship the candidates with the task instead of the
325
+ queue:
326
+
327
+ ```typescript
328
+ await datashift.task.submit({
329
+ queueKey: 'entity-match',
330
+ summary: 'Verify business identity',
331
+ data: { name: 'ACME Plumbing LLC', ein: '12-3456789' },
332
+ choices: [
333
+ {
334
+ key: 'cand_1',
335
+ label: 'ACME Plumbing LLC',
336
+ description: 'EIN 12-3456789',
337
+ data: { address: '100 Main St, Austin TX', confidence: 0.92 },
338
+ },
339
+ {
340
+ key: 'cand_2',
341
+ label: 'Acme Plumbing Inc',
342
+ description: 'EIN 11-2233445',
343
+ data: { address: '220 Oak St, Houston TX', confidence: 0.71 },
344
+ },
345
+ ],
346
+ });
347
+ ```
348
+
349
+ If none of the candidates is a real match, the reviewer can submit an
350
+ empty result. Configure the queue with `result_required: false` and
351
+ `feedback_required: 'when_empty'` to require an explanation in that case;
352
+ no reserved `__none__` key needed.
353
+
293
354
  ### Review
294
355
 
295
356
  ```typescript
@@ -299,7 +360,7 @@ interface Review {
299
360
  reviewer_id: string | null;
300
361
  result: string[];
301
362
  data: Record<string, unknown>;
302
- comment: string | null;
363
+ feedback: string | null;
303
364
  created_at: string;
304
365
  }
305
366
  ```
@@ -446,6 +507,14 @@ app.listen(3000);
446
507
  - Node.js 18+
447
508
  - TypeScript 5.0+ (for type definitions)
448
509
 
510
+ ## Resources
511
+
512
+ - [Datashift Website](https://datashift.io) — Product overview and sign up
513
+ - [Documentation](https://datashift.io/docs) — Guides, API reference, and examples
514
+ - [MCP Server](https://datashift.io/docs/mcp) — Connect AI agents via Model Context Protocol
515
+ - [Console](https://console.datashift.io) — Manage queues, reviewers, and API keys
516
+ - [GitHub](https://github.com/datashift-io) — SDKs and sample projects
517
+
449
518
  ## License
450
519
 
451
520
  MIT
package/dist/index.d.mts CHANGED
@@ -1,6 +1,12 @@
1
1
  import { AxiosInstance } from 'axios';
2
2
 
3
3
  type TaskState = 'pending' | 'queued' | 'reviewed';
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,6 +16,8 @@ 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;
@@ -29,8 +37,11 @@ interface SubmitTaskInput {
29
37
  metadata?: Record<string, unknown>;
30
38
  summary?: string;
31
39
  externalId?: string;
40
+ choices?: TaskChoice[];
41
+ maxSelections?: number;
32
42
  }
33
- type ReviewType = 'approval' | 'labeling' | 'classification' | 'scoring' | 'augmentation';
43
+ type ReviewType = 'approval' | 'labeling' | 'classification' | 'multiple_choice' | 'scoring' | 'augmentation';
44
+ type FeedbackRequired = 'never' | 'always' | 'when_empty';
34
45
  type AssignmentStrategy = 'manual' | 'round_robin' | 'ai_first' | 'ai_last';
35
46
  interface ReviewOption {
36
47
  id: string;
@@ -45,7 +56,9 @@ interface Queue {
45
56
  description: string | null;
46
57
  review_type: ReviewType;
47
58
  review_options: ReviewOption[];
48
- multi_select: boolean;
59
+ max_selections: number | null;
60
+ result_required: boolean;
61
+ feedback_required: FeedbackRequired;
49
62
  assignment: AssignmentStrategy;
50
63
  sla_minutes: number | null;
51
64
  deleted_at: string | null;
@@ -59,7 +72,7 @@ interface Review {
59
72
  reviewer_id: string | null;
60
73
  result: string[];
61
74
  data: Record<string, unknown>;
62
- comment: string | null;
75
+ feedback: string | null;
63
76
  created_at: string;
64
77
  }
65
78
  interface ListReviewsFilters {
@@ -99,6 +112,8 @@ interface WebhookTaskData {
99
112
  summary: string | null;
100
113
  data: Record<string, unknown>;
101
114
  metadata: Record<string, unknown>;
115
+ choices: TaskChoice[] | null;
116
+ max_selections: number | null;
102
117
  sla_deadline: string | null;
103
118
  reviewed_at: string | null;
104
119
  created_at: string;
@@ -111,7 +126,7 @@ interface WebhookQueueData {
111
126
  interface WebhookReviewData {
112
127
  result: string[];
113
128
  data: Record<string, unknown>;
114
- comment: string | null;
129
+ feedback: string | null;
115
130
  reviewer: {
116
131
  name: string;
117
132
  type: string;
package/dist/index.d.ts CHANGED
@@ -1,6 +1,12 @@
1
1
  import { AxiosInstance } from 'axios';
2
2
 
3
3
  type TaskState = 'pending' | 'queued' | 'reviewed';
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,6 +16,8 @@ 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;
@@ -29,8 +37,11 @@ interface SubmitTaskInput {
29
37
  metadata?: Record<string, unknown>;
30
38
  summary?: string;
31
39
  externalId?: string;
40
+ choices?: TaskChoice[];
41
+ maxSelections?: number;
32
42
  }
33
- type ReviewType = 'approval' | 'labeling' | 'classification' | 'scoring' | 'augmentation';
43
+ type ReviewType = 'approval' | 'labeling' | 'classification' | 'multiple_choice' | 'scoring' | 'augmentation';
44
+ type FeedbackRequired = 'never' | 'always' | 'when_empty';
34
45
  type AssignmentStrategy = 'manual' | 'round_robin' | 'ai_first' | 'ai_last';
35
46
  interface ReviewOption {
36
47
  id: string;
@@ -45,7 +56,9 @@ interface Queue {
45
56
  description: string | null;
46
57
  review_type: ReviewType;
47
58
  review_options: ReviewOption[];
48
- multi_select: boolean;
59
+ max_selections: number | null;
60
+ result_required: boolean;
61
+ feedback_required: FeedbackRequired;
49
62
  assignment: AssignmentStrategy;
50
63
  sla_minutes: number | null;
51
64
  deleted_at: string | null;
@@ -59,7 +72,7 @@ interface Review {
59
72
  reviewer_id: string | null;
60
73
  result: string[];
61
74
  data: Record<string, unknown>;
62
- comment: string | null;
75
+ feedback: string | null;
63
76
  created_at: string;
64
77
  }
65
78
  interface ListReviewsFilters {
@@ -99,6 +112,8 @@ interface WebhookTaskData {
99
112
  summary: string | null;
100
113
  data: Record<string, unknown>;
101
114
  metadata: Record<string, unknown>;
115
+ choices: TaskChoice[] | null;
116
+ max_selections: number | null;
102
117
  sla_deadline: string | null;
103
118
  reviewed_at: string | null;
104
119
  created_at: string;
@@ -111,7 +126,7 @@ interface WebhookQueueData {
111
126
  interface WebhookReviewData {
112
127
  result: string[];
113
128
  data: Record<string, unknown>;
114
- comment: string | null;
129
+ feedback: string | null;
115
130
  reviewer: {
116
131
  name: string;
117
132
  type: string;
package/dist/index.js CHANGED
@@ -98,7 +98,9 @@ var TaskResource = class {
98
98
  context: input.context ?? {},
99
99
  metadata: input.metadata ?? {},
100
100
  summary: input.summary,
101
- external_id: input.externalId
101
+ external_id: input.externalId,
102
+ choices: input.choices,
103
+ max_selections: input.maxSelections
102
104
  });
103
105
  return response.data;
104
106
  }
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","/**\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 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 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
@@ -92,7 +92,9 @@ var TaskResource = class {
92
92
  context: input.context ?? {},
93
93
  metadata: input.metadata ?? {},
94
94
  summary: input.summary,
95
- external_id: input.externalId
95
+ external_id: input.externalId,
96
+ choices: input.choices,
97
+ max_selections: input.maxSelections
96
98
  });
97
99
  return response.data;
98
100
  }
@@ -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","/**\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 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 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.0",
3
+ "version": "0.4.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",
@@ -26,9 +26,17 @@
26
26
  "keywords": [
27
27
  "datashift",
28
28
  "ai",
29
+ "ai-agents",
29
30
  "agents",
30
31
  "human-in-the-loop",
31
- "hitl"
32
+ "hitl",
33
+ "llm",
34
+ "review-workflow",
35
+ "model-context-protocol",
36
+ "mcp",
37
+ "automation",
38
+ "content-moderation",
39
+ "approval-workflow"
32
40
  ],
33
41
  "author": "Datashift",
34
42
  "license": "MIT",