@turinhub/tale-js-sdk 1.3.0 → 2.0.0

package/dist/task/index.js

@@ -24,20 +24,10 @@ function getBaseUrl(options) {
     return String(base).replace(/\/+$/, "");
 }
 // ==================== UserTask CRUD Operations ====================
-/**
- * Creates a new user task.
- *
- * @param request - Task creation request
- * @param options - Optional configuration
- * @returns Promise resolving to created task
- * @throws {ConfigurationError} When required environment variables are missing
- * @throws {ApiError} When API request fails
- * @throws {NetworkError} When network request fails
- */
 export async function createUserTask(request, options) {
     const token = options?.appToken ?? (await getAppToken(options));
     const base = getBaseUrl(options);
-    const url = new URL(base + "/user-task/v1/tasks");
+    const url = new URL(base + "/user-task/v2/tasks");
     let response;
     try {
         response = await globalThis.fetch(url.toString(), {
@@ -55,16 +45,6 @@ export async function createUserTask(request, options) {
     const json = await response.json();
     return parseApiResponse(json, "Failed to create user task", response.status);
 }
-/**
- * Batch creates user tasks.
- *
- * @param request - Batch creation request
- * @param options - Optional configuration
- * @returns Promise resolving to batch creation response
- * @throws {ConfigurationError} When required environment variables are missing
- * @throws {ApiError} When API request fails
- * @throws {NetworkError} When network request fails
- */
 export async function batchCreateUserTasks(request, options) {
     const token = options?.appToken ?? (await getAppToken(options));
     const base = getBaseUrl(options);
@@ -86,26 +66,16 @@ export async function batchCreateUserTasks(request, options) {
     const json = await response.json();
     return parseApiResponse(json, "Failed to batch create user tasks", response.status);
 }
-/**
- * Gets a user task by ID.
- *
- * @param taskId - Task ID
- * @param options - Optional configuration (include_attachments, include_sub_tasks)
- * @returns Promise resolving to task
- * @throws {ConfigurationError} When required environment variables are missing
- * @throws {ApiError} When API request fails
- * @throws {NetworkError} When network request fails
- */
 export async function getUserTask(taskId, options) {
     const token = options?.appToken ?? (await getAppToken(options));
     const base = getBaseUrl(options);
-    const url = new URL(base + `/user-task/v1/tasks/${encodeURIComponent(taskId)}`);
+    const url = new URL(base + `/user-task/v2/tasks/${encodeURIComponent(taskId)}`);
     const { appToken, baseUrl, ...queryParams } = options || {};
-    if (queryParams.include_attachments !== undefined) {
-        url.searchParams.append("include_attachments", String(queryParams.include_attachments));
+    if (queryParams.includeAttachments !== undefined) {
+        url.searchParams.append("includeAttachments", String(queryParams.includeAttachments));
     }
-    if (queryParams.include_sub_tasks !== undefined) {
-        url.searchParams.append("include_sub_tasks", String(queryParams.include_sub_tasks));
+    if (queryParams.includeSubTasks !== undefined) {
+        url.searchParams.append("includeSubTasks", String(queryParams.includeSubTasks));
     }
     let response;
     try {
@@ -123,20 +93,10 @@ export async function getUserTask(taskId, options) {
     const json = await response.json();
     return parseApiResponse(json, "Failed to get user task", response.status);
 }
-/**
- * Batch gets user tasks by IDs.
- *
- * @param request - Batch query request
- * @param options - Optional configuration
- * @returns Promise resolving to array of tasks
- * @throws {ConfigurationError} When required environment variables are missing
- * @throws {ApiError} When API request fails
- * @throws {NetworkError} When network request fails
- */
 export async function batchGetUserTasks(request, options) {
     const token = options?.appToken ?? (await getAppToken(options));
     const base = getBaseUrl(options);
-    const url = new URL(base + "/user-task/v1/tasks/batch");
+    const url = new URL(base + "/user-task/v2/tasks/batch-get");
     let response;
     try {
         response = await globalThis.fetch(url.toString(), {
@@ -158,16 +118,6 @@ export async function batchGetUserTasks(request, options) {
     }
     return result;
 }
-/**
- * Lists user tasks with pagination and optional filtering.
- *
- * @param request - List request parameters
- * @param options - Optional configuration
- * @returns Promise resolving to paginated list of tasks
- * @throws {ConfigurationError} When required environment variables are missing
- * @throws {ApiError} When API request fails
- * @throws {NetworkError} When network request fails
- */
 export async function listUserTasks(request) {
     const token = request?.appToken ?? (await getAppToken(request));
     const base = getBaseUrl(request);
@@ -200,21 +150,10 @@ export async function listUserTasks(request) {
     const json = await response.json();
     return parseApiResponse(json, "Failed to list user tasks", response.status);
 }
-/**
- * Updates a user task.
- *
- * @param taskId - Task ID
- * @param request - Update request
- * @param options - Optional configuration
- * @returns Promise resolving to updated task
- * @throws {ConfigurationError} When required environment variables are missing
- * @throws {ApiError} When API request fails
- * @throws {NetworkError} When network request fails
- */
 export async function updateUserTask(taskId, request, options) {
     const token = options?.appToken ?? (await getAppToken(options));
     const base = getBaseUrl(options);
-    const url = new URL(base + `/user-task/v1/tasks/${encodeURIComponent(taskId)}`);
+    const url = new URL(base + `/user-task/v2/tasks/${encodeURIComponent(taskId)}`);
     let response;
     try {
         response = await globalThis.fetch(url.toString(), {
@@ -232,19 +171,10 @@ export async function updateUserTask(taskId, request, options) {
     const json = await response.json();
     return parseApiResponse(json, "Failed to update user task", response.status);
 }
-/**
- * Deletes a user task.
- *
- * @param taskId - Task ID
- * @param options - Optional configuration
- * @throws {ConfigurationError} When required environment variables are missing
- * @throws {ApiError} When API request fails
- * @throws {NetworkError} When network request fails
- */
 export async function deleteUserTask(taskId, options) {
     const token = options?.appToken ?? (await getAppToken(options));
     const base = getBaseUrl(options);
-    const url = new URL(base + `/user-task/v1/tasks/${encodeURIComponent(taskId)}`);
+    const url = new URL(base + `/user-task/v2/tasks/${encodeURIComponent(taskId)}`);
     let response;
     try {
         response = await globalThis.fetch(url.toString(), {
@@ -271,20 +201,10 @@ export async function deleteUserTask(taskId, options) {
     }
 }
 // ==================== Task Input/Output Operations ====================
-/**
- * Gets task input data.
- *
- * @param taskId - Task ID
- * @param options - Optional configuration
- * @returns Promise resolving to task input data
- * @throws {ConfigurationError} When required environment variables are missing
- * @throws {ApiError} When API request fails
- * @throws {NetworkError} When network request fails
- */
 export async function getTaskInput(taskId, options) {
     const token = options?.appToken ?? (await getAppToken(options));
     const base = getBaseUrl(options);
-    const url = new URL(base + `/user-task/v1/tasks/${encodeURIComponent(taskId)}/input`);
+    const url = new URL(base + `/user-task/v2/tasks/${encodeURIComponent(taskId)}/input`);
     let response;
     try {
         response = await globalThis.fetch(url.toString(), {
@@ -301,20 +221,10 @@ export async function getTaskInput(taskId, options) {
     const json = await response.json();
     return parseApiResponse(json, "Failed to get task input", response.status);
 }
-/**
- * Gets task output data.
- *
- * @param taskId - Task ID
- * @param options - Optional configuration
- * @returns Promise resolving to task output data
- * @throws {ConfigurationError} When required environment variables are missing
- * @throws {ApiError} When API request fails
- * @throws {NetworkError} When network request fails
- */
 export async function getTaskOutput(taskId, options) {
     const token = options?.appToken ?? (await getAppToken(options));
     const base = getBaseUrl(options);
-    const url = new URL(base + `/user-task/v1/tasks/${encodeURIComponent(taskId)}/output`);
+    const url = new URL(base + `/user-task/v2/tasks/${encodeURIComponent(taskId)}/output`);
     let response;
     try {
         response = await globalThis.fetch(url.toString(), {
@@ -331,21 +241,10 @@ export async function getTaskOutput(taskId, options) {
     const json = await response.json();
     return parseApiResponse(json, "Failed to get task output", response.status);
 }
-/**
- * Updates task input data.
- *
- * @param taskId - Task ID
- * @param taskInput - New task input data
- * @param options - Optional configuration
- * @returns Promise resolving to updated task
- * @throws {ConfigurationError} When required environment variables are missing
- * @throws {ApiError} When API request fails
- * @throws {NetworkError} When network request fails
- */
 export async function updateTaskInput(taskId, taskInput, options) {
     const token = options?.appToken ?? (await getAppToken(options));
     const base = getBaseUrl(options);
-    const url = new URL(base + `/user-task/v1/tasks/${encodeURIComponent(taskId)}/input`);
+    const url = new URL(base + `/user-task/v2/tasks/${encodeURIComponent(taskId)}/input`);
     let response;
     try {
         response = await globalThis.fetch(url.toString(), {
@@ -363,21 +262,10 @@ export async function updateTaskInput(taskId, taskInput, options) {
     const json = await response.json();
     return parseApiResponse(json, "Failed to update task input", response.status);
 }
-/**
- * Updates task output data.
- *
- * @param taskId - Task ID
- * @param taskOutput - New task output data
- * @param options - Optional configuration
- * @returns Promise resolving to updated task
- * @throws {ConfigurationError} When required environment variables are missing
- * @throws {ApiError} When API request fails
- * @throws {NetworkError} When network request fails
- */
 export async function updateTaskOutput(taskId, taskOutput, options) {
     const token = options?.appToken ?? (await getAppToken(options));
     const base = getBaseUrl(options);
-    const url = new URL(base + `/user-task/v1/tasks/${encodeURIComponent(taskId)}/output`);
+    const url = new URL(base + `/user-task/v2/tasks/${encodeURIComponent(taskId)}/output`);
     let response;
     try {
         response = await globalThis.fetch(url.toString(), {
@@ -396,20 +284,10 @@ export async function updateTaskOutput(taskId, taskOutput, options) {
     return parseApiResponse(json, "Failed to update task output", response.status);
 }
 // ==================== Task Status Operations ====================
-/**
- * Gets task status.
- *
- * @param taskId - Task ID
- * @param options - Optional configuration
- * @returns Promise resolving to task status
- * @throws {ConfigurationError} When required environment variables are missing
- * @throws {ApiError} When API request fails
- * @throws {NetworkError} When network request fails
- */
 export async function getTaskStatus(taskId, options) {
     const token = options?.appToken ?? (await getAppToken(options));
     const base = getBaseUrl(options);
-    const url = new URL(base + `/user-task/v1/tasks/${encodeURIComponent(taskId)}/status`);
+    const url = new URL(base + `/user-task/v2/tasks/${encodeURIComponent(taskId)}/status`);
     let response;
     try {
         response = await globalThis.fetch(url.toString(), {
@@ -425,23 +303,12 @@ export async function getTaskStatus(taskId, options) {
     }
     const json = await response.json();
     const result = parseApiResponse(json, "Failed to get task status", response.status);
-    return result.task_status;
+    return result.taskStatus;
 }
-/**
- * Updates task status.
- *
- * @param taskId - Task ID
- * @param request - Status update request
- * @param options - Optional configuration
- * @returns Promise resolving to updated task
- * @throws {ConfigurationError} When required environment variables are missing
- * @throws {ApiError} When API request fails
- * @throws {NetworkError} When network request fails
- */
 export async function updateTaskStatus(taskId, request, options) {
     const token = options?.appToken ?? (await getAppToken(options));
     const base = getBaseUrl(options);
-    const url = new URL(base + `/user-task/v1/tasks/${encodeURIComponent(taskId)}/status`);
+    const url = new URL(base + `/user-task/v2/tasks/${encodeURIComponent(taskId)}/status`);
     let response;
     try {
         response = await globalThis.fetch(url.toString(), {
@@ -460,22 +327,12 @@ export async function updateTaskStatus(taskId, request, options) {
     return parseApiResponse(json, "Failed to update task status", response.status);
 }
 // ==================== Task Statistics ====================
-/**
- * Gets task statistics.
- *
- * @param userId - Optional user ID filter
- * @param options - Optional configuration
- * @returns Promise resolving to task statistics
- * @throws {ConfigurationError} When required environment variables are missing
- * @throws {ApiError} When API request fails
- * @throws {NetworkError} When network request fails
- */
 export async function getTaskStatistics(userId, options) {
     const token = options?.appToken ?? (await getAppToken(options));
     const base = getBaseUrl(options);
-    const url = new URL(base + "/user-task/v1/tasks/statistics");
+    const url = new URL(base + "/user-task/v2/tasks/statistics");
     if (userId !== undefined) {
-        url.searchParams.append("user_id", userId);
+        url.searchParams.append("userId", userId);
     }
     let response;
     try {
@@ -493,3 +350,155 @@ export async function getTaskStatistics(userId, options) {
     const json = await response.json();
     return parseApiResponse(json, "Failed to get task statistics", response.status);
 }
+// ==================== Task Frozen Status ====================
+export async function getTaskFrozenStatus(taskId, options) {
+    const token = options?.appToken ?? (await getAppToken(options));
+    const base = getBaseUrl(options);
+    const url = new URL(base + `/user-task/v2/tasks/${encodeURIComponent(taskId)}/frozen-status`);
+    let response;
+    try {
+        response = await globalThis.fetch(url.toString(), {
+            method: "GET",
+            headers: {
+                "Content-Type": "application/json",
+                "x-t-token": token,
+            },
+        });
+    }
+    catch (error) {
+        throw new NetworkError(`Failed to get task frozen status: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+    const json = await response.json();
+    return parseApiResponse(json, "Failed to get task frozen status", response.status);
+}
+export async function updateTaskFrozenStatus(taskId, request, options) {
+    const token = options?.appToken ?? (await getAppToken(options));
+    const base = getBaseUrl(options);
+    const url = new URL(base + `/user-task/v2/tasks/${encodeURIComponent(taskId)}/frozen-status`);
+    let response;
+    try {
+        response = await globalThis.fetch(url.toString(), {
+            method: "PUT",
+            headers: {
+                "Content-Type": "application/json",
+                "x-t-token": token,
+            },
+            body: JSON.stringify(request),
+        });
+    }
+    catch (error) {
+        throw new NetworkError(`Failed to update task frozen status: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+    const json = await response.json();
+    return parseApiResponse(json, "Failed to update task frozen status", response.status);
+}
+// ==================== Task Attachments ====================
+export async function listTaskAttachments(taskId, options) {
+    const token = options?.appToken ?? (await getAppToken(options));
+    const base = getBaseUrl(options);
+    const url = new URL(base + `/user-task/v2/tasks/${encodeURIComponent(taskId)}/attachments`);
+    const { appToken, baseUrl, ...requestParams } = options || {};
+    const queryParams = {
+        page: 0,
+        size: 20,
+        ...requestParams,
+    };
+    Object.entries(queryParams).forEach(([key, value]) => {
+        if (value !== undefined) {
+            url.searchParams.append(key, String(value));
+        }
+    });
+    let response;
+    try {
+        response = await globalThis.fetch(url.toString(), {
+            method: "GET",
+            headers: {
+                "Content-Type": "application/json",
+                "x-t-token": token,
+            },
+        });
+    }
+    catch (error) {
+        throw new NetworkError(`Failed to list task attachments: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+    const json = await response.json();
+    return parseApiResponse(json, "Failed to list task attachments", response.status);
+}
+export async function getTaskAttachment(taskId, attachmentId, options) {
+    const token = options?.appToken ?? (await getAppToken(options));
+    const base = getBaseUrl(options);
+    const url = new URL(base +
+        `/user-task/v2/tasks/${encodeURIComponent(taskId)}/attachments/${encodeURIComponent(attachmentId)}`);
+    let response;
+    try {
+        response = await globalThis.fetch(url.toString(), {
+            method: "GET",
+            headers: {
+                "Content-Type": "application/json",
+                "x-t-token": token,
+            },
+        });
+    }
+    catch (error) {
+        throw new NetworkError(`Failed to get task attachment: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+    const json = await response.json();
+    return parseApiResponse(json, "Failed to get task attachment", response.status);
+}
+export async function uploadTaskAttachment(taskId, attachmentTypeId, file, remark, options) {
+    const token = options?.appToken ?? (await getAppToken(options));
+    const base = getBaseUrl(options);
+    const url = new URL(base +
+        `/user-task/v2/tasks/${encodeURIComponent(taskId)}/attachments/${encodeURIComponent(attachmentTypeId)}`);
+    const formData = new FormData();
+    if (typeof File !== "undefined" && file instanceof File) {
+        formData.append("file", file, file.name);
+    }
+    else {
+        formData.append("file", file);
+    }
+    if (remark) {
+        formData.append("remark", remark);
+    }
+    let response;
+    try {
+        response = await globalThis.fetch(url.toString(), {
+            method: "POST",
+            headers: {
+                "x-t-token": token,
+            },
+            body: formData,
+        });
+    }
+    catch (error) {
+        throw new NetworkError(`Failed to upload task attachment: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+    const json = await response.json();
+    return parseApiResponse(json, "Failed to upload task attachment", response.status);
+}
+export async function deleteTaskAttachment(taskId, attachmentId, options) {
+    const token = options?.appToken ?? (await getAppToken(options));
+    const base = getBaseUrl(options);
+    const url = new URL(base +
+        `/user-task/v2/tasks/${encodeURIComponent(taskId)}/attachments/${encodeURIComponent(attachmentId)}`);
+    let response;
+    try {
+        response = await globalThis.fetch(url.toString(), {
+            method: "DELETE",
+            headers: {
+                "Content-Type": "application/json",
+                "x-t-token": token,
+            },
+        });
+    }
+    catch (error) {
+        throw new NetworkError(`Failed to delete task attachment: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+    const json = (await response.json());
+    if (json.code !== 200) {
+        const errorMsg = typeof json.msg === "string"
+            ? json.msg
+            : "Failed to delete task attachment";
+        throw new ApiError(errorMsg, response.status, json.code);
+    }
+}

package/dist/task/types.d.ts

@@ -1,116 +1,92 @@
-import type { CommonOptions, Attachment } from "../common/types.js";
-/**
- * UserTask entity (matches backend UserTaskVO)
- */
+import type { CommonOptions } from "../common/types.js";
+import type { Attachment } from "../attachment/types.js";
 export interface UserTask {
-    task_id: string;
-    app_id: string;
-    user_id: string;
-    task_title: string;
-    task_input: Record<string, unknown>;
-    task_output: Record<string, unknown>;
-    task_type: string;
-    task_status: string;
-    parent_task_id?: string;
-    created_at: string;
-    updated_at: string;
+    taskId: string;
+    appId: string;
+    userId: string;
+    taskTitle: string;
+    taskInput: Record<string, unknown>;
+    taskOutput: Record<string, unknown>;
+    taskType: string;
+    taskStatus: string;
+    parentTaskId?: string;
+    isFrozen?: boolean;
+    createdAt: string;
+    updatedAt: string;
     attachments?: Attachment[];
-    sub_tasks?: UserTask[];
+    subTasks?: UserTask[];
 }
-/**
- * Request for creating a user task
- */
 export interface CreateUserTaskRequest {
-    user_id: string;
-    task_title: string;
-    task_input?: Record<string, unknown>;
-    task_output?: Record<string, unknown>;
-    task_type?: string;
-    task_status?: string;
-    parent_task_id?: string;
+    userId: string;
+    taskTitle: string;
+    taskInput?: Record<string, unknown>;
+    taskOutput?: Record<string, unknown>;
+    taskType?: string;
+    taskStatus?: string;
+    parentTaskId?: string;
     remark?: string;
 }
-/**
- * Request for updating a user task
- */
 export interface UpdateUserTaskRequest {
-    task_title?: string;
-    task_input?: Record<string, unknown>;
-    task_output?: Record<string, unknown>;
-    task_status?: string;
+    taskTitle?: string;
+    taskInput?: Record<string, unknown>;
+    taskOutput?: Record<string, unknown>;
+    taskStatus?: string;
     remark?: string;
 }
-/**
- * Request for batch creating user tasks
- */
 export interface BatchCreateUserTasksRequest {
     tasks: CreateUserTaskRequest[];
 }
-/**
- * Request for batch querying user tasks
- */
 export interface BatchQueryUserTasksRequest {
-    task_ids: string[];
-    user_ids?: string[];
-    task_status?: string;
-    include_attachments?: boolean;
-    include_sub_tasks?: boolean;
+    taskIds: string[];
+    userIds?: string[];
+    taskStatus?: string;
+    includeAttachments?: boolean;
+    includeSubTasks?: boolean;
 }
-/**
- * Request for listing user tasks
- */
 export interface ListUserTasksRequest {
     page?: number;
     size?: number;
     sort?: string;
-    user_ids?: string;
-    task_status?: string;
-    task_type?: string;
-    include_attachments?: boolean;
-    include_sub_tasks?: boolean;
+    userIds?: string;
+    taskStatus?: string;
+    taskType?: string;
+    includeAttachments?: boolean;
+    includeSubTasks?: boolean;
 }
-/**
- * Request for updating task status
- */
 export interface UpdateTaskStatusRequest {
-    task_status: string;
+    taskStatus: string;
 }
-/**
- * Result of a single task creation in batch
- */
 export interface UserTaskCreateResult {
     index: number;
     success: boolean;
-    task_id?: string;
+    taskId?: string;
     message?: string;
 }
-/**
- * Response for batch task creation
- */
 export interface BatchCreateUserTasksResponse {
-    success_count: number;
-    failure_count: number;
+    successCount: number;
+    failureCount: number;
     results: UserTaskCreateResult[];
 }
-/**
- * Task statistics response
- */
 export interface TaskStatistics {
-    pending_count: number;
-    running_count: number;
-    completed_count: number;
-    failed_count: number;
-    cancelled_count: number;
-    total_count: number;
+    pendingCount: number;
+    runningCount: number;
+    completedCount: number;
+    failedCount: number;
+    cancelledCount: number;
+    totalCount: number;
 }
-/**
- * Task status response
- */
 export interface TaskStatusResponse {
-    task_status: string;
+    taskStatus: string;
+}
+export interface TaskFrozenStatusResponse {
+    taskId: string;
+    isFrozen: boolean;
+    frozenRemark?: string;
+    updatedAt?: string;
+}
+export interface UpdateTaskFrozenStatusRequest {
+    isFrozen: boolean;
+    remark?: string;
 }
-/**
- * Options for user task operations
- */
 export interface UserTaskOptions extends CommonOptions {
 }

package/dist/task-type/index.d.ts

@@ -14,11 +14,11 @@ export type { TaskType, CreateTaskTypeRequest, UpdateTaskTypeRequest, ListTaskTy
  * @example
  * ```typescript
  * const taskType = await createTaskType({
- *   type_code: "daily_review",
- *   type_name: "Daily Review",
+ *   typeCode: "daily_review",
+ *   typeName: "Daily Review",
  *   description: "Daily review tasks",
- *   allow_multiple: true,
- *   is_enabled: true,
+ *   allowMultiple: true,
+ *   isEnabled: true,
  * });
  * ```
  */
@@ -71,9 +71,9 @@ export declare function getTaskType(typeId: string, options?: TaskTypeOptions):
  * const result = await listTaskTypes({
  *   page: 0,
  *   size: 20,
- *   is_enabled: true,
- *   sort_by: "createdAt",
- *   sort_direction: "desc",
+ *   isEnabled: true,
+ *   sort: "createdAt",
+ *   sortDirection: "desc",
  * });
  * console.log(result.content); // Array of task types
  * console.log(result.total); // Total count