@datashift/sdk 0.3.2 → 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
@@ -7,7 +7,7 @@ TypeScript SDK for integrating human-in-the-loop checkpoints into AI agent workf
7
7
 
8
8
  ## Overview
9
9
 
10
- [Datashift](https://datashift.io) enables AI agents to submit tasks for human review before committing changes. Create review queues, define review types (approval, classification, labeling, scoring, augmentation), and integrate human oversight into any AI workflow — via [REST API](https://datashift.io/docs/api) or [MCP](https://datashift.io/docs/mcp).
10
+ [Datashift](https://datashift.io) enables AI agents to submit tasks for human review before committing changes. Create review queues, define review types (approval, classification, labeling, multiple_choice, scoring, augmentation), and integrate human oversight into any AI workflow — via [REST API](https://datashift.io/docs/api) or [MCP](https://datashift.io/docs/mcp).
11
11
 
12
12
  ## Installation
13
13
 
@@ -232,6 +232,8 @@ interface WebhookTaskData {
232
232
  summary: string | null;
233
233
  data: Record<string, unknown>;
234
234
  metadata: Record<string, unknown>;
235
+ choices: TaskChoice[] | null; // multiple_choice queues only
236
+ max_selections: number | null; // per-task override; multiple_choice only
235
237
  sla_deadline: string | null;
236
238
  reviewed_at: string | null;
237
239
  created_at: string;
@@ -246,7 +248,7 @@ interface WebhookQueueData {
246
248
  interface WebhookReviewData {
247
249
  result: string[];
248
250
  data: Record<string, unknown>;
249
- comment: string | null;
251
+ feedback: string | null;
250
252
  reviewer: { name: string; type: string };
251
253
  created_at: string;
252
254
  }
@@ -268,6 +270,8 @@ interface Task {
268
270
  data: Record<string, unknown>;
269
271
  context: Record<string, unknown>;
270
272
  metadata: Record<string, unknown>;
273
+ choices: TaskChoice[] | null; // multiple_choice queues only
274
+ max_selections: number | null; // per-task override; multiple_choice only
271
275
  summary: string | null;
272
276
  sla_deadline: string | null;
273
277
  reviewed_at: string | null;
@@ -275,6 +279,15 @@ interface Task {
275
279
  updated_at: string;
276
280
  reviews?: Review[];
277
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
+ }
278
291
  ```
279
292
 
280
293
  ### Queue
@@ -285,14 +298,59 @@ interface Queue {
285
298
  key: string;
286
299
  name: string;
287
300
  description: string | null;
288
- review_type: 'approval' | 'labeling' | 'classification' | 'scoring' | 'augmentation';
301
+ review_type:
302
+ | 'approval'
303
+ | 'labeling'
304
+ | 'classification'
305
+ | 'multiple_choice'
306
+ | 'scoring'
307
+ | 'augmentation';
289
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';
290
314
  assignment: 'manual' | 'round_robin' | 'ai_first';
291
315
  sla_minutes: number | null;
292
316
  deleted_at: string | null;
293
317
  }
294
318
  ```
295
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
+
296
354
  ### Review
297
355
 
298
356
  ```typescript
@@ -302,7 +360,7 @@ interface Review {
302
360
  reviewer_id: string | null;
303
361
  result: string[];
304
362
  data: Record<string, unknown>;
305
- comment: string | null;
363
+ feedback: string | null;
306
364
  created_at: string;
307
365
  }
308
366
  ```
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;
@@ -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;
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;
@@ -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;
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":";;;;;;;;;;;AAKO,SAAS,mBAAA,CAAoB,QAAuB,MAAA,EAAsB;AAC/E,EAAA,MAAA,CAAO,YAAA,CAAa,OAAA,CAAQ,GAAA,CAAI,CAAC,MAAA,KAAW;AAC1C,IAAA,MAAA,CAAO,OAAA,CAAQ,aAAA,GAAgB,CAAA,OAAA,EAAU,MAAM,CAAA,CAAA;AAC/C,IAAA,OAAO,MAAA;AAAA,EACT,CAAC,CAAA;AACH;AAKO,SAAS,eAAe,MAAA,EAAsB;AACnD,EAAA,IAAI,CAAC,MAAA,EAAQ;AACX,IAAA,MAAM,IAAI,MAAM,qBAAqB,CAAA;AAAA,EACvC;AAEA,EAAA,IAAI,CAAC,MAAA,CAAO,UAAA,CAAW,KAAK,CAAA,EAAG;AAC7B,IAAA,MAAM,IAAI,MAAM,sCAAsC,CAAA;AAAA,EACxD;AACF;;;ACpBO,IAAM,cAAA,GAAN,cAA6B,KAAA,CAAM;AAAA,EACxC,WAAA,CACE,OAAA,EACO,MAAA,EACA,IAAA,EACA,IAAA,EACP;AACA,IAAA,KAAA,CAAM,OAAO,CAAA;AAJN,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AACA,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AACA,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAGP,IAAA,IAAA,CAAK,IAAA,GAAO,gBAAA;AACZ,IAAA,KAAA,CAAM,iBAAA,GAAoB,IAAA,EAAM,IAAA,CAAK,WAAW,CAAA;AAAA,EAClD;AACF;AAKO,IAAM,mBAAA,GAAN,cAAkC,cAAA,CAAe;AAAA,EACtD,WAAA,CAAY,UAAU,uBAAA,EAAyB;AAC7C,IAAA,KAAA,CAAM,OAAA,EAAS,KAAK,sBAAsB,CAAA;AAC1C,IAAA,IAAA,CAAK,IAAA,GAAO,qBAAA;AAAA,EACd;AACF;AAKO,IAAM,aAAA,GAAN,cAA4B,cAAA,CAAe;AAAA,EAChD,WAAA,CAAY,UAAkB,EAAA,EAAa;AACzC,IAAA,MAAM,OAAA,GAAU,KAAK,CAAA,EAAG,QAAQ,KAAK,EAAE,CAAA,WAAA,CAAA,GAAgB,GAAG,QAAQ,CAAA,UAAA,CAAA;AAClE,IAAA,KAAA,CAAM,OAAA,EAAS,KAAK,WAAW,CAAA;AAC/B,IAAA,IAAA,CAAK,IAAA,GAAO,eAAA;AAAA,EACd;AACF;AAKO,IAAM,eAAA,GAAN,cAA8B,cAAA,CAAe;AAAA,EAClD,WAAA,CACE,SACO,MAAA,EACP;AACA,IAAA,KAAA,CAAM,OAAA,EAAS,GAAA,EAAK,kBAAA,EAAoB,MAAM,CAAA;AAFvC,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAGP,IAAA,IAAA,CAAK,IAAA,GAAO,iBAAA;AAAA,EACd;AACF;AAKO,IAAM,YAAA,GAAN,cAA2B,cAAA,CAAe;AAAA,EAC/C,WAAA,CAAY,UAAU,qBAAA,EAAuB;AAC3C,IAAA,KAAA,CAAM,OAAA,EAAS,KAAK,SAAS,CAAA;AAC7B,IAAA,IAAA,CAAK,IAAA,GAAO,cAAA;AAAA,EACd;AACF;AAKO,IAAM,cAAA,GAAN,cAA6B,cAAA,CAAe;AAAA,EACjD,YACS,UAAA,EACP;AACA,IAAA,KAAA,CAAM,qBAAA,EAAuB,KAAK,cAAc,CAAA;AAFzC,IAAA,IAAA,CAAA,UAAA,GAAA,UAAA;AAGP,IAAA,IAAA,CAAK,IAAA,GAAO,gBAAA;AAAA,EACd;AACF;AAKO,IAAM,WAAA,GAAN,cAA0B,cAAA,CAAe;AAAA,EAC9C,WAAA,CAAY,UAAU,uBAAA,EAAyB;AAC7C,IAAA,KAAA,CAAM,OAAA,EAAS,KAAK,cAAc,CAAA;AAClC,IAAA,IAAA,CAAK,IAAA,GAAO,aAAA;AAAA,EACd;AACF;;;ACvEA,IAAM,oBAAA,GAA8C;AAAA,EAClD,OAAA,EAAS,GAAA;AAAA;AAAA,EACT,YAAA,EAAc,GAAA;AAAA;AAAA,EACd,eAAA,EAAiB;AAAA;AACnB,CAAA;AAEO,IAAM,eAAN,MAAmB;AAAA,EACxB,YAAoB,MAAA,EAAuB;AAAvB,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAAwB;AAAA;AAAA;AAAA;AAAA,EAK5C,MAAM,OAAO,KAAA,EAAuC;AAClD,IAAA,MAAM,QAAA,GAAW,MAAM,IAAA,CAAK,MAAA,CAAO,KAAW,OAAA,EAAS;AAAA,MACrD,WAAW,KAAA,CAAM,QAAA;AAAA,MACjB,MAAM,KAAA,CAAM,IAAA;AAAA,MACZ,OAAA,EAAS,KAAA,CAAM,OAAA,IAAW,EAAC;AAAA,MAC3B,QAAA,EAAU,KAAA,CAAM,QAAA,IAAY,EAAC;AAAA,MAC7B,SAAS,KAAA,CAAM,OAAA;AAAA,MACf,aAAa,KAAA,CAAM,UAAA;AAAA,MACnB,SAAS,KAAA,CAAM,OAAA;AAAA,MACf,gBAAgB,KAAA,CAAM;AAAA,KACvB,CAAA;AACD,IAAA,OAAO,QAAA,CAAS,IAAA;AAAA,EAClB;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,IAAI,MAAA,EAA+B;AACvC,IAAA,MAAM,WAAW,MAAM,IAAA,CAAK,OAAO,GAAA,CAAU,CAAA,MAAA,EAAS,MAAM,CAAA,CAAE,CAAA;AAC9D,IAAA,OAAO,QAAA,CAAS,IAAA;AAAA,EAClB;AAAA;AAAA;AAAA;AAAA,EAKA,MAAc,UAAU,MAAA,EAAqC;AAC3D,IAAA,MAAM,WAAW,MAAM,IAAA,CAAK,OAAO,GAAA,CAAgB,CAAA,MAAA,EAAS,MAAM,CAAA,OAAA,CAAS,CAAA;AAC3E,IAAA,OAAO,QAAA,CAAS,IAAA;AAAA,EAClB;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,KAAK,OAAA,EAAiE;AAC1E,IAAA,MAAM,MAAA,GAAS,IAAI,eAAA,EAAgB;AACnC,IAAA,IAAI,SAAS,OAAA,EAAS,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,QAAQ,OAAO,CAAA;AAC/D,IAAA,IAAI,SAAS,KAAA,EAAO,MAAA,CAAO,MAAA,CAAO,OAAA,EAAS,QAAQ,KAAK,CAAA;AAExD,IAAA,MAAM,KAAA,GAAQ,OAAO,QAAA,EAAS;AAC9B,IAAA,MAAM,QAAA,GAAW,MAAM,IAAA,CAAK,MAAA,CAAO,GAAA,CAAY,CAAA,KAAA,EAAQ,KAAA,GAAQ,CAAA,CAAA,EAAI,KAAK,CAAA,CAAA,GAAK,EAAE,CAAA,CAAE,CAAA;AACjF,IAAA,OAAO,QAAA,CAAS,IAAA;AAAA,EAClB;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,aAAA,CAAc,MAAA,EAAgB,OAAA,EAAsC;AACxE,IAAA,MAAM,IAAA,GAAO,EAAE,GAAG,oBAAA,EAAsB,GAAG,OAAA,EAAQ;AACnD,IAAA,MAAM,SAAA,GAAY,KAAK,GAAA,EAAI;AAC3B,IAAA,IAAI,kBAAkB,IAAA,CAAK,YAAA;AAE3B,IAAA,OAAO,IAAA,CAAK,GAAA,EAAI,GAAI,SAAA,GAAY,KAAK,OAAA,EAAS;AAC5C,MAAA,MAAM,MAAA,GAAS,MAAM,IAAA,CAAK,SAAA,CAAU,MAAM,CAAA;AAE1C,MAAA,IAAI,MAAA,CAAO,UAAU,UAAA,EAAY;AAE/B,QAAA,OAAO,IAAA,CAAK,IAAI,MAAM,CAAA;AAAA,MACxB;AAGA,MAAA,MAAM,IAAA,CAAK,MAAM,eAAe,CAAA;AAGhC,MAAA,eAAA,GAAkB,IAAA,CAAK,GAAA,CAAI,eAAA,GAAkB,GAAA,EAAK,KAAK,eAAe,CAAA;AAAA,IACxE;AAEA,IAAA,MAAM,IAAI,YAAA;AAAA,MACR,CAAA,KAAA,EAAQ,MAAM,CAAA,yBAAA,EAA4B,IAAA,CAAK,OAAO,CAAA,EAAA;AAAA,KACxD;AAAA,EACF;AAAA,EAEQ,MAAM,EAAA,EAA2B;AACvC,IAAA,OAAO,IAAI,OAAA,CAAQ,CAAC,YAAY,UAAA,CAAW,OAAA,EAAS,EAAE,CAAC,CAAA;AAAA,EACzD;AACF,CAAA;;;AC5FO,IAAM,gBAAN,MAAoB;AAAA,EACzB,YAAoB,MAAA,EAAuB;AAAvB,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAAwB;AAAA;AAAA;AAAA;AAAA,EAK5C,MAAM,IAAA,GAAyB;AAC7B,IAAA,MAAM,QAAA,GAAW,MAAM,IAAA,CAAK,MAAA,CAAO,IAAa,QAAQ,CAAA;AACxD,IAAA,OAAO,QAAA,CAAS,IAAA;AAAA,EAClB;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,IAAI,GAAA,EAA6B;AACrC,IAAA,MAAM,WAAW,MAAM,IAAA,CAAK,OAAO,GAAA,CAAW,CAAA,OAAA,EAAU,GAAG,CAAA,CAAE,CAAA;AAC7D,IAAA,OAAO,QAAA,CAAS,IAAA;AAAA,EAClB;AACF,CAAA;;;AClBO,IAAM,iBAAN,MAAqB;AAAA,EAC1B,YAAoB,MAAA,EAAuB;AAAvB,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAAwB;AAAA;AAAA;AAAA;AAAA,EAK5C,MAAM,KAAK,OAAA,EAAiD;AAC1D,IAAA,MAAM,MAAA,GAAS,IAAI,eAAA,EAAgB;AAEnC,IAAA,IAAI,SAAS,MAAA,EAAQ,MAAA,CAAO,MAAA,CAAO,SAAA,EAAW,QAAQ,MAAM,CAAA;AAC5D,IAAA,IAAI,SAAS,UAAA,EAAY,MAAA,CAAO,MAAA,CAAO,aAAA,EAAe,QAAQ,UAAU,CAAA;AACxE,IAAA,IAAI,SAAS,QAAA,EAAU,MAAA,CAAO,MAAA,CAAO,WAAA,EAAa,QAAQ,QAAQ,CAAA;AAClE,IAAA,IAAI,SAAS,YAAA,EAAc,MAAA,CAAO,MAAA,CAAO,eAAA,EAAiB,QAAQ,YAAY,CAAA;AAC9E,IAAA,IAAI,SAAS,IAAA,EAAM;AACjB,MAAA,MAAM,IAAA,GAAO,QAAQ,IAAA,YAAgB,IAAA,GACjC,QAAQ,IAAA,CAAK,WAAA,KACb,OAAA,CAAQ,IAAA;AACZ,MAAA,MAAA,CAAO,MAAA,CAAO,iBAAiB,IAAI,CAAA;AAAA,IACrC;AACA,IAAA,IAAI,SAAS,EAAA,EAAI;AACf,MAAA,MAAM,IAAA,GAAO,QAAQ,EAAA,YAAc,IAAA,GAC/B,QAAQ,EAAA,CAAG,WAAA,KACX,OAAA,CAAQ,EAAA;AACZ,MAAA,MAAA,CAAO,MAAA,CAAO,kBAAkB,IAAI,CAAA;AAAA,IACtC;AACA,IAAA,IAAI,OAAA,EAAS,OAAO,MAAA,CAAO,MAAA,CAAO,SAAS,OAAA,CAAQ,KAAA,CAAM,UAAU,CAAA;AACnE,IAAA,IAAI,OAAA,EAAS,QAAQ,MAAA,CAAO,MAAA,CAAO,UAAU,OAAA,CAAQ,MAAA,CAAO,UAAU,CAAA;AAEtE,IAAA,MAAM,KAAA,GAAQ,OAAO,QAAA,EAAS;AAC9B,IAAA,MAAM,QAAA,GAAW,MAAM,IAAA,CAAK,MAAA,CAAO,GAAA,CAAc,CAAA,OAAA,EAAU,KAAA,GAAQ,CAAA,CAAA,EAAI,KAAK,CAAA,CAAA,GAAK,EAAE,CAAA,CAAE,CAAA;AACrF,IAAA,OAAO,QAAA,CAAS,IAAA;AAAA,EAClB;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,IAAI,QAAA,EAAmC;AAC3C,IAAA,MAAM,WAAW,MAAM,IAAA,CAAK,OAAO,GAAA,CAAY,CAAA,QAAA,EAAW,QAAQ,CAAA,CAAE,CAAA;AACpE,IAAA,OAAO,QAAA,CAAS,IAAA;AAAA,EAClB;AACF,CAAA;;;AC5BA,IAAM,gBAAA,GAAmB,0BAAA;AACzB,IAAM,eAAA,GAAkB,GAAA;AACxB,IAAM,eAAA,GAAkB,CAAA;AACxB,IAAM,mBAAA,GAAsB,GAAA;AAsBrB,IAAM,sBAAN,MAA0B;AAAA,EACvB,MAAA;AAAA,EACA,OAAA;AAAA,EACA,UAAA;AAAA,EAEQ,IAAA;AAAA,EACA,KAAA;AAAA,EACA,MAAA;AAAA,EAEhB,YAAY,MAAA,EAA0B;AACpC,IAAA,cAAA,CAAe,OAAO,MAAM,CAAA;AAE5B,IAAA,IAAA,CAAK,OAAA,GAAU,OAAO,OAAA,IAAW,eAAA;AACjC,IAAA,IAAA,CAAK,UAAA,GAAa,OAAO,UAAA,IAAc,mBAAA;AAEvC,IAAA,IAAA,CAAK,MAAA,GAASA,uBAAM,MAAA,CAAO;AAAA,MACzB,OAAA,EAAS,OAAO,OAAA,IAAW,gBAAA;AAAA,MAC3B,OAAA,EAAS,OAAO,OAAA,IAAW,eAAA;AAAA,MAC3B,OAAA,EAAS;AAAA,QACP,cAAA,EAAgB;AAAA;AAClB,KACD,CAAA;AAGD,IAAA,mBAAA,CAAoB,IAAA,CAAK,MAAA,EAAQ,MAAA,CAAO,MAAM,CAAA;AAG9C,IAAA,IAAA,CAAK,qBAAA,EAAsB;AAG3B,IAAA,IAAA,CAAK,IAAA,GAAO,IAAI,YAAA,CAAa,IAAA,CAAK,MAAM,CAAA;AACxC,IAAA,IAAA,CAAK,KAAA,GAAQ,IAAI,aAAA,CAAc,IAAA,CAAK,MAAM,CAAA;AAC1C,IAAA,IAAA,CAAK,MAAA,GAAS,IAAI,cAAA,CAAe,IAAA,CAAK,MAAM,CAAA;AAAA,EAC9C;AAAA,EAEQ,qBAAA,GAA8B;AACpC,IAAA,IAAA,CAAK,MAAA,CAAO,aAAa,QAAA,CAAS,GAAA;AAAA,MAChC,CAAC,QAAA,KAAa,QAAA;AAAA,MACd,OAAO,KAAA,KAAsB;AAE3B,QAAA,MAAM,SAAS,KAAA,CAAM,MAAA;AACrB,QAAA,IAAI,MAAA,IAAU,IAAA,CAAK,WAAA,CAAY,KAAK,CAAA,EAAG;AACrC,UAAA,MAAM,UAAA,GAAc,OAAe,YAAA,IAAgB,CAAA;AACnD,UAAA,IAAI,UAAA,GAAa,KAAK,OAAA,EAAS;AAC7B,YAAC,MAAA,CAAe,eAAe,UAAA,GAAa,CAAA;AAC5C,YAAA,MAAM,IAAA,CAAK,MAAM,IAAA,CAAK,UAAA,GAAa,KAAK,GAAA,CAAI,CAAA,EAAG,UAAU,CAAC,CAAA;AAC1D,YAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,MAAM,CAAA;AAAA,UACnC;AAAA,QACF;AAGA,QAAA,MAAM,IAAA,CAAK,eAAe,KAAK,CAAA;AAAA,MACjC;AAAA,KACF;AAAA,EACF;AAAA,EAEQ,YAAY,KAAA,EAA4B;AAE9C,IAAA,IAAI,CAAC,KAAA,CAAM,QAAA,EAAU,OAAO,IAAA;AAC5B,IAAA,OAAO,MAAM,QAAA,CAAS,MAAA,IAAU,GAAA,IAAO,KAAA,CAAM,SAAS,MAAA,GAAS,GAAA;AAAA,EACjE;AAAA,EAEQ,eAAe,KAAA,EAAmC;AACxD,IAAA,IAAI,CAAC,MAAM,QAAA,EAAU;AACnB,MAAA,OAAO,IAAI,cAAA;AAAA,QACT,8CAAA;AAAA,QACA,MAAA;AAAA,QACA;AAAA,OACF;AAAA,IACF;AAEA,IAAA,MAAM,MAAA,GAAS,MAAM,QAAA,CAAS,MAAA;AAC9B,IAAA,MAAM,IAAA,GAAO,MAAM,QAAA,CAAS,IAAA;AAC5B,IAAA,MAAM,OAAA,GAAU,IAAA,EAAM,OAAA,IAAW,KAAA,CAAM,OAAA;AAEvC,IAAA,QAAQ,MAAA;AAAQ,MACd,KAAK,GAAA;AACH,QAAA,OAAO,IAAI,oBAAoB,OAAO,CAAA;AAAA,MACxC,KAAK,GAAA;AACH,QAAA,OAAO,IAAI,aAAA,CAAc,UAAA,EAAY,IAAA,EAAM,QAAQ,CAAA;AAAA,MACrD,KAAK,GAAA;AACH,QAAA,OAAO,IAAI,eAAA,CAAgB,OAAA,EAAS,IAAA,EAAM,MAAM,CAAA;AAAA,MAClD,KAAK,GAAA;AACH,QAAA,OAAO,IAAI,cAAA,CAAe,IAAA,EAAM,UAAU,CAAA;AAAA,MAC5C,KAAK,GAAA;AAAA,MACL,KAAK,GAAA;AAAA,MACL,KAAK,GAAA;AAAA,MACL,KAAK,GAAA;AACH,QAAA,OAAO,IAAI,YAAY,OAAO,CAAA;AAAA,MAChC;AACE,QAAA,OAAO,IAAI,cAAA,CAAe,OAAA,EAAS,MAAA,EAAQ,IAAA,EAAM,MAAM,IAAI,CAAA;AAAA;AAC/D,EACF;AAAA,EAEQ,MAAM,EAAA,EAA2B;AACvC,IAAA,OAAO,IAAI,OAAA,CAAQ,CAAC,YAAY,UAAA,CAAW,OAAA,EAAS,EAAE,CAAC,CAAA;AAAA,EACzD;AACF","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.2",
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",