@datashift/sdk 0.4.0 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -85,7 +85,7 @@ const task = await datashift.task.get(taskId);
85
85
  // List tasks
86
86
  const tasks = await datashift.task.list({
87
87
  queueId?: string;
88
- state?: 'pending' | 'queued' | 'reviewed';
88
+ state?: 'pending' | 'queued' | 'reviewed' | 'canceled';
89
89
  });
90
90
 
91
91
  // Wait for review
@@ -96,6 +96,8 @@ const reviewed = await datashift.task.waitForReview(taskId, {
96
96
  });
97
97
  ```
98
98
 
99
+ `waitForReview` throws `TaskCanceledError` if the task is canceled before it is reviewed, and `TimeoutError` if no review arrives within `timeout`.
100
+
99
101
  ### Queue Operations
100
102
 
101
103
  ```typescript
@@ -266,7 +268,7 @@ interface Task {
266
268
  id: string;
267
269
  queue_id: string;
268
270
  external_id: string | null;
269
- state: 'pending' | 'queued' | 'reviewed';
271
+ state: 'pending' | 'queued' | 'reviewed' | 'canceled';
270
272
  data: Record<string, unknown>;
271
273
  context: Record<string, unknown>;
272
274
  metadata: Record<string, unknown>;
@@ -275,6 +277,7 @@ interface Task {
275
277
  summary: string | null;
276
278
  sla_deadline: string | null;
277
279
  reviewed_at: string | null;
280
+ canceled_at: string | null;
278
281
  created_at: string;
279
282
  updated_at: string;
280
283
  reviews?: Review[];
@@ -403,6 +406,7 @@ import {
403
406
  NotFoundError,
404
407
  ValidationError,
405
408
  TimeoutError,
409
+ TaskCanceledError,
406
410
  RateLimitError,
407
411
  ServerError,
408
412
  } from '@datashift/sdk';
@@ -412,6 +416,8 @@ try {
412
416
  } catch (error) {
413
417
  if (error instanceof TimeoutError) {
414
418
  console.log('Review not finished in time');
419
+ } else if (error instanceof TaskCanceledError) {
420
+ console.log(`Task canceled at ${error.task.canceled_at}`);
415
421
  } else if (error instanceof AuthenticationError) {
416
422
  console.log('Invalid credentials');
417
423
  } else if (error instanceof NotFoundError) {
package/dist/index.d.mts CHANGED
@@ -1,6 +1,6 @@
1
1
  import { AxiosInstance } from 'axios';
2
2
 
3
- type TaskState = 'pending' | 'queued' | 'reviewed';
3
+ type TaskState = 'pending' | 'queued' | 'reviewed' | 'canceled';
4
4
  interface TaskChoice {
5
5
  key: string;
6
6
  label: string;
@@ -21,6 +21,7 @@ interface Task {
21
21
  summary: string | null;
22
22
  sla_deadline: string | null;
23
23
  reviewed_at: string | null;
24
+ canceled_at: string | null;
24
25
  created_at: string;
25
26
  updated_at: string;
26
27
  queue?: Queue;
@@ -175,7 +176,10 @@ declare class TaskResource {
175
176
  state?: string;
176
177
  }): Promise<Task[]>;
177
178
  /**
178
- * Wait for a task to be reviewed
179
+ * Wait for a task to be reviewed.
180
+ *
181
+ * @throws {TaskCanceledError} If the task is canceled before it is reviewed.
182
+ * @throws {TimeoutError} If the task is not reviewed within `timeout`.
179
183
  */
180
184
  waitForReview(taskId: string, options?: WaitOptions): Promise<Task>;
181
185
  private sleep;
@@ -275,6 +279,13 @@ declare class ValidationError extends DatashiftError {
275
279
  declare class TimeoutError extends DatashiftError {
276
280
  constructor(message?: string);
277
281
  }
282
+ /**
283
+ * Thrown by `waitForReview` when the task is canceled before it is reviewed
284
+ */
285
+ declare class TaskCanceledError extends DatashiftError {
286
+ task: Task;
287
+ constructor(task: Task);
288
+ }
278
289
  /**
279
290
  * Thrown when rate limited
280
291
  */
@@ -289,4 +300,4 @@ declare class ServerError extends DatashiftError {
289
300
  constructor(message?: string);
290
301
  }
291
302
 
292
- export { type AssignmentStrategy, AuthenticationError, DatashiftError, DatashiftRestClient, type ListReviewsFilters, NotFoundError, type Queue, RateLimitError, type RestClientConfig, type Review, type ReviewOption, type ReviewResult, type ReviewType, ServerError, type SubmitTaskInput, type Task, type TaskCreatedWebhookEvent, type TaskReviewedWebhookEvent, type TaskState, type TaskStatus, TimeoutError, ValidationError, type WaitOptions, type WebhookEvent, type WebhookEventType, type WebhookQueueData, type WebhookReviewData, type WebhookTaskData };
303
+ export { type AssignmentStrategy, AuthenticationError, DatashiftError, DatashiftRestClient, type ListReviewsFilters, NotFoundError, type Queue, RateLimitError, type RestClientConfig, type Review, type ReviewOption, type ReviewResult, type ReviewType, ServerError, type SubmitTaskInput, type Task, TaskCanceledError, type TaskCreatedWebhookEvent, type TaskReviewedWebhookEvent, type TaskState, type TaskStatus, TimeoutError, ValidationError, type WaitOptions, type WebhookEvent, type WebhookEventType, type WebhookQueueData, type WebhookReviewData, type WebhookTaskData };
package/dist/index.d.ts CHANGED
@@ -1,6 +1,6 @@
1
1
  import { AxiosInstance } from 'axios';
2
2
 
3
- type TaskState = 'pending' | 'queued' | 'reviewed';
3
+ type TaskState = 'pending' | 'queued' | 'reviewed' | 'canceled';
4
4
  interface TaskChoice {
5
5
  key: string;
6
6
  label: string;
@@ -21,6 +21,7 @@ interface Task {
21
21
  summary: string | null;
22
22
  sla_deadline: string | null;
23
23
  reviewed_at: string | null;
24
+ canceled_at: string | null;
24
25
  created_at: string;
25
26
  updated_at: string;
26
27
  queue?: Queue;
@@ -175,7 +176,10 @@ declare class TaskResource {
175
176
  state?: string;
176
177
  }): Promise<Task[]>;
177
178
  /**
178
- * Wait for a task to be reviewed
179
+ * Wait for a task to be reviewed.
180
+ *
181
+ * @throws {TaskCanceledError} If the task is canceled before it is reviewed.
182
+ * @throws {TimeoutError} If the task is not reviewed within `timeout`.
179
183
  */
180
184
  waitForReview(taskId: string, options?: WaitOptions): Promise<Task>;
181
185
  private sleep;
@@ -275,6 +279,13 @@ declare class ValidationError extends DatashiftError {
275
279
  declare class TimeoutError extends DatashiftError {
276
280
  constructor(message?: string);
277
281
  }
282
+ /**
283
+ * Thrown by `waitForReview` when the task is canceled before it is reviewed
284
+ */
285
+ declare class TaskCanceledError extends DatashiftError {
286
+ task: Task;
287
+ constructor(task: Task);
288
+ }
278
289
  /**
279
290
  * Thrown when rate limited
280
291
  */
@@ -289,4 +300,4 @@ declare class ServerError extends DatashiftError {
289
300
  constructor(message?: string);
290
301
  }
291
302
 
292
- export { type AssignmentStrategy, AuthenticationError, DatashiftError, DatashiftRestClient, type ListReviewsFilters, NotFoundError, type Queue, RateLimitError, type RestClientConfig, type Review, type ReviewOption, type ReviewResult, type ReviewType, ServerError, type SubmitTaskInput, type Task, type TaskCreatedWebhookEvent, type TaskReviewedWebhookEvent, type TaskState, type TaskStatus, TimeoutError, ValidationError, type WaitOptions, type WebhookEvent, type WebhookEventType, type WebhookQueueData, type WebhookReviewData, type WebhookTaskData };
303
+ export { type AssignmentStrategy, AuthenticationError, DatashiftError, DatashiftRestClient, type ListReviewsFilters, NotFoundError, type Queue, RateLimitError, type RestClientConfig, type Review, type ReviewOption, type ReviewResult, type ReviewType, ServerError, type SubmitTaskInput, type Task, TaskCanceledError, type TaskCreatedWebhookEvent, type TaskReviewedWebhookEvent, type TaskState, type TaskStatus, TimeoutError, ValidationError, type WaitOptions, type WebhookEvent, type WebhookEventType, type WebhookQueueData, type WebhookReviewData, type WebhookTaskData };
package/dist/index.js CHANGED
@@ -61,6 +61,13 @@ var TimeoutError = class extends DatashiftError {
61
61
  this.name = "TimeoutError";
62
62
  }
63
63
  };
64
+ var TaskCanceledError = class extends DatashiftError {
65
+ constructor(task) {
66
+ super(`Task ${task.id} was canceled before it was reviewed`, 409, "TASK_CANCELED", task);
67
+ this.task = task;
68
+ this.name = "TaskCanceledError";
69
+ }
70
+ };
64
71
  var RateLimitError = class extends DatashiftError {
65
72
  constructor(retryAfter) {
66
73
  super("Rate limit exceeded", 429, "RATE_LIMITED");
@@ -130,7 +137,10 @@ var TaskResource = class {
130
137
  return response.data;
131
138
  }
132
139
  /**
133
- * Wait for a task to be reviewed
140
+ * Wait for a task to be reviewed.
141
+ *
142
+ * @throws {TaskCanceledError} If the task is canceled before it is reviewed.
143
+ * @throws {TimeoutError} If the task is not reviewed within `timeout`.
134
144
  */
135
145
  async waitForReview(taskId, options) {
136
146
  const opts = { ...DEFAULT_WAIT_OPTIONS, ...options };
@@ -141,6 +151,9 @@ var TaskResource = class {
141
151
  if (status.state === "reviewed") {
142
152
  return this.get(taskId);
143
153
  }
154
+ if (status.state === "canceled") {
155
+ throw new TaskCanceledError(await this.get(taskId));
156
+ }
144
157
  await this.sleep(currentInterval);
145
158
  currentInterval = Math.min(currentInterval * 1.5, opts.maxPollInterval);
146
159
  }
@@ -301,6 +314,7 @@ exports.DatashiftRestClient = DatashiftRestClient;
301
314
  exports.NotFoundError = NotFoundError;
302
315
  exports.RateLimitError = RateLimitError;
303
316
  exports.ServerError = ServerError;
317
+ exports.TaskCanceledError = TaskCanceledError;
304
318
  exports.TimeoutError = TimeoutError;
305
319
  exports.ValidationError = ValidationError;
306
320
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/auth/api-key.ts","../src/errors.ts","../src/resources/task.ts","../src/resources/queue.ts","../src/resources/review.ts","../src/rest-client.ts"],"names":["axios"],"mappings":"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","file":"index.js","sourcesContent":["import type { AxiosInstance } from 'axios';\n\n/**\n * Configures axios instance with API key authentication\n */\nexport function configureApiKeyAuth(client: AxiosInstance, apiKey: string): void {\n client.interceptors.request.use((config) => {\n config.headers.Authorization = `Bearer ${apiKey}`;\n return config;\n });\n}\n\n/**\n * Validates API key format\n */\nexport function validateApiKey(apiKey: string): void {\n if (!apiKey) {\n throw new Error('API key is required');\n }\n\n if (!apiKey.startsWith('sk_')) {\n throw new Error('Invalid API key format. Expected sk_');\n }\n}\n\n","/**\n * Base error class for all Datashift SDK errors\n */\nexport class DatashiftError extends Error {\n constructor(\n message: string,\n public status?: number,\n public code?: string,\n public data?: unknown,\n ) {\n super(message);\n this.name = 'DatashiftError';\n Error.captureStackTrace?.(this, this.constructor);\n }\n}\n\n/**\n * Thrown when authentication fails (invalid API key, expired token, etc.)\n */\nexport class AuthenticationError extends DatashiftError {\n constructor(message = 'Authentication failed') {\n super(message, 401, 'AUTHENTICATION_ERROR');\n this.name = 'AuthenticationError';\n }\n}\n\n/**\n * Thrown when a requested resource is not found\n */\nexport class NotFoundError extends DatashiftError {\n constructor(resource: string, id?: string) {\n const message = id ? `${resource} '${id}' not found` : `${resource} not found`;\n super(message, 404, 'NOT_FOUND');\n this.name = 'NotFoundError';\n }\n}\n\n/**\n * Thrown when request validation fails\n */\nexport class ValidationError extends DatashiftError {\n constructor(\n message: string,\n public errors?: Record<string, string[]>,\n ) {\n super(message, 400, 'VALIDATION_ERROR', errors);\n this.name = 'ValidationError';\n }\n}\n\n/**\n * Thrown when an operation times out\n */\nexport class TimeoutError extends DatashiftError {\n constructor(message = 'Operation timed out') {\n super(message, 408, 'TIMEOUT');\n this.name = 'TimeoutError';\n }\n}\n\n/**\n * Thrown when rate limited\n */\nexport class RateLimitError extends DatashiftError {\n constructor(\n public retryAfter?: number,\n ) {\n super('Rate limit exceeded', 429, 'RATE_LIMITED');\n this.name = 'RateLimitError';\n }\n}\n\n/**\n * Thrown when the server returns an error\n */\nexport class ServerError extends DatashiftError {\n constructor(message = 'Internal server error') {\n super(message, 500, 'SERVER_ERROR');\n this.name = 'ServerError';\n }\n}\n","import type { AxiosInstance } from 'axios';\nimport type {\n Task,\n TaskStatus,\n SubmitTaskInput,\n WaitOptions,\n} from '../types/index.js';\nimport { TimeoutError } from '../errors.js';\n\nconst DEFAULT_WAIT_OPTIONS: Required<WaitOptions> = {\n timeout: 300000, // 5 minutes\n pollInterval: 2000, // 2 seconds\n maxPollInterval: 30000, // 30 seconds\n};\n\nexport class TaskResource {\n constructor(private client: AxiosInstance) {}\n\n /**\n * Submit a task for human review\n */\n async submit(input: SubmitTaskInput): Promise<Task> {\n const response = await this.client.post<Task>('/task', {\n queue_key: input.queueKey,\n data: input.data,\n context: input.context ?? {},\n metadata: input.metadata ?? {},\n summary: input.summary,\n external_id: input.externalId,\n 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"]}
1
+ {"version":3,"sources":["../src/auth/api-key.ts","../src/errors.ts","../src/resources/task.ts","../src/resources/queue.ts","../src/resources/review.ts","../src/rest-client.ts"],"names":["axios"],"mappings":"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","file":"index.js","sourcesContent":["import type { AxiosInstance } from 'axios';\n\n/**\n * Configures axios instance with API key authentication\n */\nexport function configureApiKeyAuth(client: AxiosInstance, apiKey: string): void {\n client.interceptors.request.use((config) => {\n config.headers.Authorization = `Bearer ${apiKey}`;\n return config;\n });\n}\n\n/**\n * Validates API key format\n */\nexport function validateApiKey(apiKey: string): void {\n if (!apiKey) {\n throw new Error('API key is required');\n }\n\n if (!apiKey.startsWith('sk_')) {\n throw new Error('Invalid API key format. Expected sk_');\n }\n}\n\n","import type { Task } from './types/index.js';\n\n/**\n * Base error class for all Datashift SDK errors\n */\nexport class DatashiftError extends Error {\n constructor(\n message: string,\n public status?: number,\n public code?: string,\n public data?: unknown,\n ) {\n super(message);\n this.name = 'DatashiftError';\n Error.captureStackTrace?.(this, this.constructor);\n }\n}\n\n/**\n * Thrown when authentication fails (invalid API key, expired token, etc.)\n */\nexport class AuthenticationError extends DatashiftError {\n constructor(message = 'Authentication failed') {\n super(message, 401, 'AUTHENTICATION_ERROR');\n this.name = 'AuthenticationError';\n }\n}\n\n/**\n * Thrown when a requested resource is not found\n */\nexport class NotFoundError extends DatashiftError {\n constructor(resource: string, id?: string) {\n const message = id ? `${resource} '${id}' not found` : `${resource} not found`;\n super(message, 404, 'NOT_FOUND');\n this.name = 'NotFoundError';\n }\n}\n\n/**\n * Thrown when request validation fails\n */\nexport class ValidationError extends DatashiftError {\n constructor(\n message: string,\n public errors?: Record<string, string[]>,\n ) {\n super(message, 400, 'VALIDATION_ERROR', errors);\n this.name = 'ValidationError';\n }\n}\n\n/**\n * Thrown when an operation times out\n */\nexport class TimeoutError extends DatashiftError {\n constructor(message = 'Operation timed out') {\n super(message, 408, 'TIMEOUT');\n this.name = 'TimeoutError';\n }\n}\n\n/**\n * Thrown by `waitForReview` when the task is canceled before it is reviewed\n */\nexport class TaskCanceledError extends DatashiftError {\n constructor(public task: Task) {\n super(`Task ${task.id} was canceled before it was reviewed`, 409, 'TASK_CANCELED', task);\n this.name = 'TaskCanceledError';\n }\n}\n\n/**\n * Thrown when rate limited\n */\nexport class RateLimitError extends DatashiftError {\n constructor(\n public retryAfter?: number,\n ) {\n super('Rate limit exceeded', 429, 'RATE_LIMITED');\n this.name = 'RateLimitError';\n }\n}\n\n/**\n * Thrown when the server returns an error\n */\nexport class ServerError extends DatashiftError {\n constructor(message = 'Internal server error') {\n super(message, 500, 'SERVER_ERROR');\n this.name = 'ServerError';\n }\n}\n","import type { AxiosInstance } from 'axios';\nimport type {\n Task,\n TaskStatus,\n SubmitTaskInput,\n WaitOptions,\n} from '../types/index.js';\nimport { TaskCanceledError, TimeoutError } from '../errors.js';\n\nconst DEFAULT_WAIT_OPTIONS: Required<WaitOptions> = {\n timeout: 300000, // 5 minutes\n pollInterval: 2000, // 2 seconds\n maxPollInterval: 30000, // 30 seconds\n};\n\nexport class TaskResource {\n constructor(private client: AxiosInstance) {}\n\n /**\n * Submit a task for human review\n */\n async submit(input: SubmitTaskInput): Promise<Task> {\n const response = await this.client.post<Task>('/task', {\n queue_key: input.queueKey,\n data: input.data,\n context: input.context ?? {},\n metadata: input.metadata ?? {},\n summary: input.summary,\n external_id: input.externalId,\n choices: input.choices,\n max_selections: input.maxSelections,\n });\n return response.data;\n }\n\n /**\n * Get a task by ID with full details\n */\n async get(taskId: string): Promise<Task> {\n const response = await this.client.get<Task>(`/task/${taskId}`);\n return response.data;\n }\n\n /**\n * Get task status\n */\n private async getStatus(taskId: string): Promise<TaskStatus> {\n const response = await this.client.get<TaskStatus>(`/task/${taskId}/status`);\n return response.data;\n }\n\n /**\n * List tasks with optional filters\n */\n async list(filters?: { queueId?: string; state?: string }): Promise<Task[]> {\n const params = new URLSearchParams();\n if (filters?.queueId) params.append('queue_id', filters.queueId);\n if (filters?.state) params.append('state', filters.state);\n\n const query = params.toString();\n const response = await this.client.get<Task[]>(`/task${query ? `?${query}` : ''}`);\n return response.data;\n }\n\n /**\n * Wait for a task to be reviewed.\n *\n * @throws {TaskCanceledError} If the task is canceled before it is reviewed.\n * @throws {TimeoutError} If the task is not reviewed within `timeout`.\n */\n async waitForReview(taskId: string, options?: WaitOptions): Promise<Task> {\n const opts = { ...DEFAULT_WAIT_OPTIONS, ...options };\n const startTime = Date.now();\n let currentInterval = opts.pollInterval;\n\n while (Date.now() - startTime < opts.timeout) {\n const status = await this.getStatus(taskId);\n\n if (status.state === 'reviewed') {\n // Fetch full task with reviews\n return this.get(taskId);\n }\n\n if (status.state === 'canceled') {\n throw new TaskCanceledError(await this.get(taskId));\n }\n\n // Wait before next poll\n await this.sleep(currentInterval);\n\n // Exponential backoff (double interval, cap at max)\n currentInterval = Math.min(currentInterval * 1.5, opts.maxPollInterval);\n }\n\n throw new TimeoutError(\n `Task ${taskId} was not reviewed within ${opts.timeout}ms`,\n );\n }\n\n private sleep(ms: number): Promise<void> {\n return new Promise((resolve) => setTimeout(resolve, ms));\n }\n}\n","import type { AxiosInstance } from 'axios';\nimport type { Queue } from '../types/index.js';\n\nexport class QueueResource {\n constructor(private client: AxiosInstance) {}\n\n /**\n * List all queues available to the organization\n */\n async list(): Promise<Queue[]> {\n const response = await this.client.get<Queue[]>('/queue');\n return response.data;\n }\n\n /**\n * Get a queue by key\n */\n async get(key: string): Promise<Queue> {\n const response = await this.client.get<Queue>(`/queue/${key}`);\n return response.data;\n }\n}\n","import type { AxiosInstance } from 'axios';\nimport type { Review, ListReviewsFilters } from '../types/index.js';\n\nexport class ReviewResource {\n constructor(private client: AxiosInstance) {}\n\n /**\n * List reviews with optional filters\n */\n async list(filters?: ListReviewsFilters): Promise<Review[]> {\n const params = new URLSearchParams();\n\n if (filters?.taskId) params.append('task_id', filters.taskId);\n if (filters?.reviewerId) params.append('reviewer_id', filters.reviewerId);\n if (filters?.queueKey) params.append('queue_key', filters.queueKey);\n if (filters?.reviewerType) params.append('reviewer_type', filters.reviewerType);\n if (filters?.from) {\n const date = filters.from instanceof Date\n ? filters.from.toISOString()\n : filters.from;\n params.append('created_after', date);\n }\n if (filters?.to) {\n const date = filters.to instanceof Date\n ? filters.to.toISOString()\n : filters.to;\n params.append('created_before', date);\n }\n if (filters?.limit) params.append('limit', filters.limit.toString());\n if (filters?.offset) params.append('offset', filters.offset.toString());\n\n const query = params.toString();\n const response = await this.client.get<Review[]>(`/review${query ? `?${query}` : ''}`);\n return response.data;\n }\n\n /**\n * Get a review by ID\n */\n async get(reviewId: string): Promise<Review> {\n const response = await this.client.get<Review>(`/review/${reviewId}`);\n return response.data;\n }\n}\n","import axios, { AxiosInstance, AxiosError } from 'axios';\nimport type { RestClientConfig } from './types/index.js';\nimport { configureApiKeyAuth, validateApiKey } from './auth/api-key.js';\nimport { TaskResource } from './resources/task.js';\nimport { QueueResource } from './resources/queue.js';\nimport { ReviewResource } from './resources/review.js';\nimport {\n DatashiftError,\n AuthenticationError,\n NotFoundError,\n ValidationError,\n RateLimitError,\n ServerError,\n} from './errors.js';\n\nconst DEFAULT_BASE_URL = 'https://api.datashift.io';\nconst DEFAULT_TIMEOUT = 30000;\nconst DEFAULT_RETRIES = 3;\nconst DEFAULT_RETRY_DELAY = 1000;\n\n/**\n * Datashift REST API client\n *\n * Use this client for backend service integrations with API key authentication.\n * For AI agents with real-time push notifications, use DatashiftMcpClient instead.\n *\n * @example\n * ```typescript\n * const datashift = new DatashiftRestClient({\n * apiKey: 'sk_...',\n * });\n *\n * const task = await datashift.task.submit({\n * queueKey: 'approvals',\n * data: { action: 'delete-account' },\n * });\n *\n * const result = await datashift.task.waitForReview(task.id);\n * ```\n */\nexport class DatashiftRestClient {\n private client: AxiosInstance;\n private retries: number;\n private retryDelay: number;\n\n public readonly task: TaskResource;\n public readonly queue: QueueResource;\n public readonly review: ReviewResource;\n\n constructor(config: RestClientConfig) {\n validateApiKey(config.apiKey);\n\n this.retries = config.retries ?? DEFAULT_RETRIES;\n this.retryDelay = config.retryDelay ?? DEFAULT_RETRY_DELAY;\n\n this.client = axios.create({\n baseURL: config.baseUrl ?? DEFAULT_BASE_URL,\n timeout: config.timeout ?? DEFAULT_TIMEOUT,\n headers: {\n 'Content-Type': 'application/json',\n },\n });\n\n // Configure API key authentication\n configureApiKeyAuth(this.client, config.apiKey);\n\n // Configure error handling\n this.setupErrorInterceptor();\n\n // Initialize resources\n this.task = new TaskResource(this.client);\n this.queue = new QueueResource(this.client);\n this.review = new ReviewResource(this.client);\n }\n\n private setupErrorInterceptor(): void {\n this.client.interceptors.response.use(\n (response) => response,\n async (error: AxiosError) => {\n // Handle retry logic for transient errors\n const config = error.config;\n if (config && this.shouldRetry(error)) {\n const retryCount = (config as any).__retryCount || 0;\n if (retryCount < this.retries) {\n (config as any).__retryCount = retryCount + 1;\n await this.sleep(this.retryDelay * Math.pow(2, retryCount));\n return this.client.request(config);\n }\n }\n\n // Transform to SDK errors\n throw this.transformError(error);\n },\n );\n }\n\n private shouldRetry(error: AxiosError): boolean {\n // Retry on network errors or 5xx server errors\n if (!error.response) return true;\n return error.response.status >= 500 && error.response.status < 600;\n }\n\n private transformError(error: AxiosError): DatashiftError {\n if (!error.response) {\n return new DatashiftError(\n 'Network error: Unable to reach Datashift API',\n undefined,\n 'NETWORK_ERROR',\n );\n }\n\n const status = error.response.status;\n const data = error.response.data as any;\n const message = data?.message || error.message;\n\n switch (status) {\n case 401:\n return new AuthenticationError(message);\n case 404:\n return new NotFoundError('Resource', data?.entityId);\n case 400:\n return new ValidationError(message, data?.errors);\n case 429:\n return new RateLimitError(data?.retryAfter);\n case 500:\n case 502:\n case 503:\n case 504:\n return new ServerError(message);\n default:\n return new DatashiftError(message, status, data?.code, data);\n }\n }\n\n private sleep(ms: number): Promise<void> {\n return new Promise((resolve) => setTimeout(resolve, ms));\n }\n}\n"]}
package/dist/index.mjs CHANGED
@@ -55,6 +55,13 @@ var TimeoutError = class extends DatashiftError {
55
55
  this.name = "TimeoutError";
56
56
  }
57
57
  };
58
+ var TaskCanceledError = class extends DatashiftError {
59
+ constructor(task) {
60
+ super(`Task ${task.id} was canceled before it was reviewed`, 409, "TASK_CANCELED", task);
61
+ this.task = task;
62
+ this.name = "TaskCanceledError";
63
+ }
64
+ };
58
65
  var RateLimitError = class extends DatashiftError {
59
66
  constructor(retryAfter) {
60
67
  super("Rate limit exceeded", 429, "RATE_LIMITED");
@@ -124,7 +131,10 @@ var TaskResource = class {
124
131
  return response.data;
125
132
  }
126
133
  /**
127
- * Wait for a task to be reviewed
134
+ * Wait for a task to be reviewed.
135
+ *
136
+ * @throws {TaskCanceledError} If the task is canceled before it is reviewed.
137
+ * @throws {TimeoutError} If the task is not reviewed within `timeout`.
128
138
  */
129
139
  async waitForReview(taskId, options) {
130
140
  const opts = { ...DEFAULT_WAIT_OPTIONS, ...options };
@@ -135,6 +145,9 @@ var TaskResource = class {
135
145
  if (status.state === "reviewed") {
136
146
  return this.get(taskId);
137
147
  }
148
+ if (status.state === "canceled") {
149
+ throw new TaskCanceledError(await this.get(taskId));
150
+ }
138
151
  await this.sleep(currentInterval);
139
152
  currentInterval = Math.min(currentInterval * 1.5, opts.maxPollInterval);
140
153
  }
@@ -289,6 +302,6 @@ var DatashiftRestClient = class {
289
302
  }
290
303
  };
291
304
 
292
- export { AuthenticationError, DatashiftError, DatashiftRestClient, NotFoundError, RateLimitError, ServerError, TimeoutError, ValidationError };
305
+ export { AuthenticationError, DatashiftError, DatashiftRestClient, NotFoundError, RateLimitError, ServerError, TaskCanceledError, TimeoutError, ValidationError };
293
306
  //# sourceMappingURL=index.mjs.map
294
307
  //# sourceMappingURL=index.mjs.map
@@ -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 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"]}
1
+ {"version":3,"sources":["../src/auth/api-key.ts","../src/errors.ts","../src/resources/task.ts","../src/resources/queue.ts","../src/resources/review.ts","../src/rest-client.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["import type { AxiosInstance } from 'axios';\n\n/**\n * Configures axios instance with API key authentication\n */\nexport function configureApiKeyAuth(client: AxiosInstance, apiKey: string): void {\n client.interceptors.request.use((config) => {\n config.headers.Authorization = `Bearer ${apiKey}`;\n return config;\n });\n}\n\n/**\n * Validates API key format\n */\nexport function validateApiKey(apiKey: string): void {\n if (!apiKey) {\n throw new Error('API key is required');\n }\n\n if (!apiKey.startsWith('sk_')) {\n throw new Error('Invalid API key format. Expected sk_');\n }\n}\n\n","import type { Task } from './types/index.js';\n\n/**\n * Base error class for all Datashift SDK errors\n */\nexport class DatashiftError extends Error {\n constructor(\n message: string,\n public status?: number,\n public code?: string,\n public data?: unknown,\n ) {\n super(message);\n this.name = 'DatashiftError';\n Error.captureStackTrace?.(this, this.constructor);\n }\n}\n\n/**\n * Thrown when authentication fails (invalid API key, expired token, etc.)\n */\nexport class AuthenticationError extends DatashiftError {\n constructor(message = 'Authentication failed') {\n super(message, 401, 'AUTHENTICATION_ERROR');\n this.name = 'AuthenticationError';\n }\n}\n\n/**\n * Thrown when a requested resource is not found\n */\nexport class NotFoundError extends DatashiftError {\n constructor(resource: string, id?: string) {\n const message = id ? `${resource} '${id}' not found` : `${resource} not found`;\n super(message, 404, 'NOT_FOUND');\n this.name = 'NotFoundError';\n }\n}\n\n/**\n * Thrown when request validation fails\n */\nexport class ValidationError extends DatashiftError {\n constructor(\n message: string,\n public errors?: Record<string, string[]>,\n ) {\n super(message, 400, 'VALIDATION_ERROR', errors);\n this.name = 'ValidationError';\n }\n}\n\n/**\n * Thrown when an operation times out\n */\nexport class TimeoutError extends DatashiftError {\n constructor(message = 'Operation timed out') {\n super(message, 408, 'TIMEOUT');\n this.name = 'TimeoutError';\n }\n}\n\n/**\n * Thrown by `waitForReview` when the task is canceled before it is reviewed\n */\nexport class TaskCanceledError extends DatashiftError {\n constructor(public task: Task) {\n super(`Task ${task.id} was canceled before it was reviewed`, 409, 'TASK_CANCELED', task);\n this.name = 'TaskCanceledError';\n }\n}\n\n/**\n * Thrown when rate limited\n */\nexport class RateLimitError extends DatashiftError {\n constructor(\n public retryAfter?: number,\n ) {\n super('Rate limit exceeded', 429, 'RATE_LIMITED');\n this.name = 'RateLimitError';\n }\n}\n\n/**\n * Thrown when the server returns an error\n */\nexport class ServerError extends DatashiftError {\n constructor(message = 'Internal server error') {\n super(message, 500, 'SERVER_ERROR');\n this.name = 'ServerError';\n }\n}\n","import type { AxiosInstance } from 'axios';\nimport type {\n Task,\n TaskStatus,\n SubmitTaskInput,\n WaitOptions,\n} from '../types/index.js';\nimport { TaskCanceledError, TimeoutError } from '../errors.js';\n\nconst DEFAULT_WAIT_OPTIONS: Required<WaitOptions> = {\n timeout: 300000, // 5 minutes\n pollInterval: 2000, // 2 seconds\n maxPollInterval: 30000, // 30 seconds\n};\n\nexport class TaskResource {\n constructor(private client: AxiosInstance) {}\n\n /**\n * Submit a task for human review\n */\n async submit(input: SubmitTaskInput): Promise<Task> {\n const response = await this.client.post<Task>('/task', {\n queue_key: input.queueKey,\n data: input.data,\n context: input.context ?? {},\n metadata: input.metadata ?? {},\n summary: input.summary,\n external_id: input.externalId,\n choices: input.choices,\n max_selections: input.maxSelections,\n });\n return response.data;\n }\n\n /**\n * Get a task by ID with full details\n */\n async get(taskId: string): Promise<Task> {\n const response = await this.client.get<Task>(`/task/${taskId}`);\n return response.data;\n }\n\n /**\n * Get task status\n */\n private async getStatus(taskId: string): Promise<TaskStatus> {\n const response = await this.client.get<TaskStatus>(`/task/${taskId}/status`);\n return response.data;\n }\n\n /**\n * List tasks with optional filters\n */\n async list(filters?: { queueId?: string; state?: string }): Promise<Task[]> {\n const params = new URLSearchParams();\n if (filters?.queueId) params.append('queue_id', filters.queueId);\n if (filters?.state) params.append('state', filters.state);\n\n const query = params.toString();\n const response = await this.client.get<Task[]>(`/task${query ? `?${query}` : ''}`);\n return response.data;\n }\n\n /**\n * Wait for a task to be reviewed.\n *\n * @throws {TaskCanceledError} If the task is canceled before it is reviewed.\n * @throws {TimeoutError} If the task is not reviewed within `timeout`.\n */\n async waitForReview(taskId: string, options?: WaitOptions): Promise<Task> {\n const opts = { ...DEFAULT_WAIT_OPTIONS, ...options };\n const startTime = Date.now();\n let currentInterval = opts.pollInterval;\n\n while (Date.now() - startTime < opts.timeout) {\n const status = await this.getStatus(taskId);\n\n if (status.state === 'reviewed') {\n // Fetch full task with reviews\n return this.get(taskId);\n }\n\n if (status.state === 'canceled') {\n throw new TaskCanceledError(await this.get(taskId));\n }\n\n // Wait before next poll\n await this.sleep(currentInterval);\n\n // Exponential backoff (double interval, cap at max)\n currentInterval = Math.min(currentInterval * 1.5, opts.maxPollInterval);\n }\n\n throw new TimeoutError(\n `Task ${taskId} was not reviewed within ${opts.timeout}ms`,\n );\n }\n\n private sleep(ms: number): Promise<void> {\n return new Promise((resolve) => setTimeout(resolve, ms));\n }\n}\n","import type { AxiosInstance } from 'axios';\nimport type { Queue } from '../types/index.js';\n\nexport class QueueResource {\n constructor(private client: AxiosInstance) {}\n\n /**\n * List all queues available to the organization\n */\n async list(): Promise<Queue[]> {\n const response = await this.client.get<Queue[]>('/queue');\n return response.data;\n }\n\n /**\n * Get a queue by key\n */\n async get(key: string): Promise<Queue> {\n const response = await this.client.get<Queue>(`/queue/${key}`);\n return response.data;\n }\n}\n","import type { AxiosInstance } from 'axios';\nimport type { Review, ListReviewsFilters } from '../types/index.js';\n\nexport class ReviewResource {\n constructor(private client: AxiosInstance) {}\n\n /**\n * List reviews with optional filters\n */\n async list(filters?: ListReviewsFilters): Promise<Review[]> {\n const params = new URLSearchParams();\n\n if (filters?.taskId) params.append('task_id', filters.taskId);\n if (filters?.reviewerId) params.append('reviewer_id', filters.reviewerId);\n if (filters?.queueKey) params.append('queue_key', filters.queueKey);\n if (filters?.reviewerType) params.append('reviewer_type', filters.reviewerType);\n if (filters?.from) {\n const date = filters.from instanceof Date\n ? filters.from.toISOString()\n : filters.from;\n params.append('created_after', date);\n }\n if (filters?.to) {\n const date = filters.to instanceof Date\n ? filters.to.toISOString()\n : filters.to;\n params.append('created_before', date);\n }\n if (filters?.limit) params.append('limit', filters.limit.toString());\n if (filters?.offset) params.append('offset', filters.offset.toString());\n\n const query = params.toString();\n const response = await this.client.get<Review[]>(`/review${query ? `?${query}` : ''}`);\n return response.data;\n }\n\n /**\n * Get a review by ID\n */\n async get(reviewId: string): Promise<Review> {\n const response = await this.client.get<Review>(`/review/${reviewId}`);\n return response.data;\n }\n}\n","import axios, { AxiosInstance, AxiosError } from 'axios';\nimport type { RestClientConfig } from './types/index.js';\nimport { configureApiKeyAuth, validateApiKey } from './auth/api-key.js';\nimport { TaskResource } from './resources/task.js';\nimport { QueueResource } from './resources/queue.js';\nimport { ReviewResource } from './resources/review.js';\nimport {\n DatashiftError,\n AuthenticationError,\n NotFoundError,\n ValidationError,\n RateLimitError,\n ServerError,\n} from './errors.js';\n\nconst DEFAULT_BASE_URL = 'https://api.datashift.io';\nconst DEFAULT_TIMEOUT = 30000;\nconst DEFAULT_RETRIES = 3;\nconst DEFAULT_RETRY_DELAY = 1000;\n\n/**\n * Datashift REST API client\n *\n * Use this client for backend service integrations with API key authentication.\n * For AI agents with real-time push notifications, use DatashiftMcpClient instead.\n *\n * @example\n * ```typescript\n * const datashift = new DatashiftRestClient({\n * apiKey: 'sk_...',\n * });\n *\n * const task = await datashift.task.submit({\n * queueKey: 'approvals',\n * data: { action: 'delete-account' },\n * });\n *\n * const result = await datashift.task.waitForReview(task.id);\n * ```\n */\nexport class DatashiftRestClient {\n private client: AxiosInstance;\n private retries: number;\n private retryDelay: number;\n\n public readonly task: TaskResource;\n public readonly queue: QueueResource;\n public readonly review: ReviewResource;\n\n constructor(config: RestClientConfig) {\n validateApiKey(config.apiKey);\n\n this.retries = config.retries ?? DEFAULT_RETRIES;\n this.retryDelay = config.retryDelay ?? DEFAULT_RETRY_DELAY;\n\n this.client = axios.create({\n baseURL: config.baseUrl ?? DEFAULT_BASE_URL,\n timeout: config.timeout ?? DEFAULT_TIMEOUT,\n headers: {\n 'Content-Type': 'application/json',\n },\n });\n\n // Configure API key authentication\n configureApiKeyAuth(this.client, config.apiKey);\n\n // Configure error handling\n this.setupErrorInterceptor();\n\n // Initialize resources\n this.task = new TaskResource(this.client);\n this.queue = new QueueResource(this.client);\n this.review = new ReviewResource(this.client);\n }\n\n private setupErrorInterceptor(): void {\n this.client.interceptors.response.use(\n (response) => response,\n async (error: AxiosError) => {\n // Handle retry logic for transient errors\n const config = error.config;\n if (config && this.shouldRetry(error)) {\n const retryCount = (config as any).__retryCount || 0;\n if (retryCount < this.retries) {\n (config as any).__retryCount = retryCount + 1;\n await this.sleep(this.retryDelay * Math.pow(2, retryCount));\n return this.client.request(config);\n }\n }\n\n // Transform to SDK errors\n throw this.transformError(error);\n },\n );\n }\n\n private shouldRetry(error: AxiosError): boolean {\n // Retry on network errors or 5xx server errors\n if (!error.response) return true;\n return error.response.status >= 500 && error.response.status < 600;\n }\n\n private transformError(error: AxiosError): DatashiftError {\n if (!error.response) {\n return new DatashiftError(\n 'Network error: Unable to reach Datashift API',\n undefined,\n 'NETWORK_ERROR',\n );\n }\n\n const status = error.response.status;\n const data = error.response.data as any;\n const message = data?.message || error.message;\n\n switch (status) {\n case 401:\n return new AuthenticationError(message);\n case 404:\n return new NotFoundError('Resource', data?.entityId);\n case 400:\n return new ValidationError(message, data?.errors);\n case 429:\n return new RateLimitError(data?.retryAfter);\n case 500:\n case 502:\n case 503:\n case 504:\n return new ServerError(message);\n default:\n return new DatashiftError(message, status, data?.code, data);\n }\n }\n\n private sleep(ms: number): Promise<void> {\n return new Promise((resolve) => setTimeout(resolve, ms));\n }\n}\n"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@datashift/sdk",
3
- "version": "0.4.0",
3
+ "version": "0.5.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",