Initial backup 2026-02-17

skills/lark-calendar/lib/task.mjs

@@ -0,0 +1,187 @@
+/**
+ * Lark Task Operations
+ */
+
+import { larkApi } from './lark-api.mjs';
+import { datetimeToTimestamp, timestampToDatetime, DEFAULT_TIMEZONE } from './calendar.mjs';
+
+/**
+ * Create a task
+ * @param {object} options
+ * @param {string} options.title - Task title (summary)
+ * @param {string} [options.description] - Task description
+ * @param {string} options.dueTime - Due time (YYYY-MM-DD HH:MM:SS)
+ * @param {string[]} [options.assigneeIds] - Array of user_ids to assign
+ * @param {string} [options.timezone] - IANA timezone
+ * @returns {object} - Created task data
+ */
+export async function createTask({
+  title,
+  description = '',
+  dueTime,
+  assigneeIds = [],
+  timezone = DEFAULT_TIMEZONE
+}) {
+  const dueTimestamp = datetimeToTimestamp(dueTime, timezone);
+  
+  // Build members array
+  const members = assigneeIds.map(userId => ({
+    type: 'user',
+    id: userId,
+    role: 'assignee'
+  }));
+  
+  const result = await larkApi('POST', '/task/v2/tasks', {
+    params: { user_id_type: 'user_id' },
+    data: {
+      mode: 1,
+      summary: title,
+      description: description,
+      due: {
+        timestamp: String(dueTimestamp * 1000), // Task API uses milliseconds
+        is_all_day: false
+      },
+      members: members,
+      reminders: [{ relative_fire_minute: 30 }]
+    }
+  });
+  
+  return result.task;
+}
+
+/**
+ * Update a task
+ * @param {object} options
+ * @param {string} options.taskId - Task GUID
+ * @param {string} [options.title] - Task title
+ * @param {string} [options.description] - Task description
+ * @param {string} [options.dueTime] - Due time (YYYY-MM-DD HH:MM:SS)
+ * @param {string} [options.timezone] - IANA timezone
+ * @returns {object} - Updated task data
+ */
+export async function updateTask({
+  taskId,
+  title,
+  description,
+  dueTime,
+  timezone = DEFAULT_TIMEZONE
+}) {
+  const updateFields = [];
+  const taskUpdate = {};
+  
+  if (title !== undefined) {
+    taskUpdate.summary = title;
+    updateFields.push('summary');
+  }
+  
+  if (description !== undefined) {
+    taskUpdate.description = description;
+    updateFields.push('description');
+  }
+  
+  if (dueTime) {
+    const dueTimestamp = datetimeToTimestamp(dueTime, timezone);
+    taskUpdate.due = {
+      timestamp: String(dueTimestamp * 1000),
+      is_all_day: false
+    };
+    updateFields.push('due');
+  }
+  
+  const result = await larkApi('PATCH', `/task/v2/tasks/${taskId}`, {
+    params: { user_id_type: 'user_id' },
+    data: {
+      task: taskUpdate,
+      update_fields: updateFields
+    }
+  });
+  
+  return result.task;
+}
+
+/**
+ * Delete a task
+ * @param {string} taskId - Task GUID
+ * @returns {boolean} - Success
+ */
+export async function deleteTask(taskId) {
+  await larkApi('DELETE', `/task/v2/tasks/${taskId}`);
+  return true;
+}
+
+/**
+ * Add members to a task
+ * @param {string} taskId - Task GUID
+ * @param {string[]} userIds - Array of user_ids
+ * @returns {object} - Result
+ */
+export async function addTaskMembers(taskId, userIds) {
+  const members = userIds.map(userId => ({
+    type: 'user',
+    id: userId,
+    role: 'assignee'
+  }));
+  
+  return larkApi('POST', `/task/v2/tasks/${taskId}/add_members`, {
+    params: { user_id_type: 'user_id' },
+    data: { members }
+  });
+}
+
+/**
+ * Remove members from a task
+ * @param {string} taskId - Task GUID
+ * @param {string[]} userIds - Array of user_ids
+ * @returns {object} - Result
+ */
+export async function removeTaskMembers(taskId, userIds) {
+  const members = userIds.map(userId => ({
+    type: 'user',
+    id: userId,
+    role: 'assignee'
+  }));
+  
+  return larkApi('POST', `/task/v2/tasks/${taskId}/remove_members`, {
+    params: { user_id_type: 'user_id' },
+    data: { members }
+  });
+}
+
+/**
+ * Get a task by ID
+ * @param {string} taskId - Task GUID
+ * @returns {object} - Task data
+ */
+export async function getTask(taskId) {
+  const result = await larkApi('GET', `/task/v2/tasks/${taskId}`, {
+    params: { user_id_type: 'user_id' }
+  });
+  return result.task;
+}
+
+/**
+ * List tasks (with pagination)
+ * @param {object} options
+ * @param {number} [options.pageSize] - Number of tasks per page
+ * @param {string} [options.pageToken] - Pagination token
+ * @returns {object} - { items, page_token, has_more }
+ */
+export async function listTasks({ pageSize = 50, pageToken = '' } = {}) {
+  const params = { page_size: pageSize, user_id_type: 'user_id' };
+  if (pageToken) params.page_token = pageToken;
+  
+  return larkApi('GET', '/task/v2/tasks', { params });
+}
+
+/**
+ * Complete a task
+ * @param {string} taskId - Task GUID
+ * @returns {object} - Updated task
+ */
+export async function completeTask(taskId) {
+  return updateTask({
+    taskId,
+    // Mark as completed by setting completed_at
+    // Note: Actual completion might need different API call
+  });
+}