13401 components dart (#18813)

* Implement CRUD operations for documents in Dart, including create, update, and delete functionalities. Add new properties for document management and update package version to 0.2.0. Enhance existing actions for task management with version updates.

* pnpm update

* Update API paths in Dart component and increment version numbers for task actions and document sources

* Refactor Dart component to enhance task management features

- Renamed and updated prop definitions for better clarity, including changing `dartboardId` to `dartboard`.
- Introduced new optional properties: `tags`, `priority`, `size`, `status`, `type`, and `customProperties` to support enhanced task attributes.
- Updated task creation and update methods to reflect new property structure and improved API paths.
- Added utility function `parseObject` for better handling of input data formats.
- Incremented version numbers for task-related actions to reflect changes.

* Update components/dart/actions/create-task/create-task.mjs

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>

* Update components/dart/actions/find-or-create-task/find-or-create-task.mjs

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>

---------

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>

Author: luancazarine

components/dart/actions/create-doc/create-doc.mjs

@@ -0,0 +1,50 @@
+import dart from "../../dart.app.mjs";
+
+export default {
+  key: "dart-create-doc",
+  name: "Create Doc",
+  description: "Record a new doc that the user intends to write down. This will save the doc in Dart for later access, search, etc. By default the created doc will be in the Docs folder. More information can be included in the text. [See the documentation](https://app.dartai.com/api/v0/public/docs/#/Doc/createDoc)",
+  version: "0.0.1",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: false,
+  },
+  type: "action",
+  props: {
+    dart,
+    title: {
+      propDefinition: [
+        dart,
+        "title",
+      ],
+    },
+    folder: {
+      propDefinition: [
+        dart,
+        "folder",
+      ],
+    },
+    text: {
+      propDefinition: [
+        dart,
+        "text",
+      ],
+    },
+  },
+  async run({ $ }) {
+    const response = await this.dart.createDoc({
+      $,
+      data: {
+        item: {
+          title: this.title,
+          folder: this.folder,
+          text: this.text,
+        },
+      },
+    });
+
+    $.export("$summary", `New doc successfully created with ID: ${response.item.id}`);
+    return response;
+  },
+};

components/dart/actions/create-task/create-task.mjs

@@ -1,10 +1,11 @@
+import { parseObject } from "../../common/utils.mjs";
 import dart from "../../dart.app.mjs";
 
 export default {
   key: "dart-create-task",
   name: "Create Task",
-  description: "Creates a new task within a dartboard. [See the documentation](https://app.itsdart.com/api/v0/docs/)",
-  version: "0.0.2",
+  description: "Creates a new task within a dartboard. [See the documentation](https://app.dartai.com/api/v0/public/docs/#/Task/createTask)",
+  version: "1.0.0",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
@@ -13,77 +14,128 @@ export default {
   type: "action",
   props: {
     dart,
-    dartboardId: {
+    title: {
       propDefinition: [
         dart,
-        "dartboardId",
+        "title",
       ],
     },
-    duid: {
-      type: "string",
-      label: "Task DUID",
-      description: "A unique identifier for the task. Must contain at least 12 characters.",
+    parentId: {
+      propDefinition: [
+        dart,
+        "taskId",
+      ],
+      label: "Parent Task ID",
+      description: "The universal, unique ID of the parent task. These tasks have a parent-child relationship where the current task is the child and this task ID corresponds to the parent. Subtasks inherit context from their parent and are typically smaller units of work",
     },
-    title: {
+    dartboard: {
       propDefinition: [
         dart,
-        "taskName",
+        "dartboard",
       ],
+      label: "Dartboard",
+      description: "The full title of the dartboard, which is a project or list of tasks",
     },
-    description: {
+    type: {
       propDefinition: [
         dart,
-        "taskDescription",
+        "type",
       ],
     },
-    dueAt: {
+    status: {
       propDefinition: [
         dart,
-        "dueAt",
+        "status",
+      ],
+      label: "Status",
+      description: "The status from the list of available statuses",
+    },
+    description: {
+      type: "string",
+      label: "Description",
+      description: "A longer description of the task, which can include markdown formatting",
+    },
+    assignees: {
+      propDefinition: [
+        dart,
+        "assigneeIds",
       ],
+      label: "Assignees",
+      description: "The names or emails of the users that the task is assigned to. Either this or assignee must be included, depending on whether the workspaces allows multiple assignees or not",
     },
-    assigneeIds: {
+    assignee: {
       propDefinition: [
         dart,
         "assigneeIds",
       ],
+      type: "string",
+      label: "Assignee",
+      description: "The name or email of the user that the task is assigned to. Either this or assignees must be included, depending on whether the workspaces allows multiple assignees or not",
+    },
+    tags: {
+      propDefinition: [
+        dart,
+        "tags",
+      ],
+      label: "Tags",
+      description: "Any tags that should be applied to the task, which can be used to filter and search for tasks. Tags are also known as labels or components and are strings that can be anything, but should be short and descriptive",
     },
     priority: {
       propDefinition: [
         dart,
         "priority",
       ],
+      label: "Priority",
+      description: "The priority, which is a string that can be one of the specified options. This is used to sort tasks and determine which tasks should be done first",
+    },
+    startAt: {
+      propDefinition: [
+        dart,
+        "startAt",
+      ],
+    },
+    dueAt: {
+      propDefinition: [
+        dart,
+        "dueAt",
+      ],
+    },
+    size: {
+      propDefinition: [
+        dart,
+        "size",
+      ],
+    },
+    customProperties: {
+      propDefinition: [
+        dart,
+        "customProperties",
+      ],
     },
   },
   async run({ $ }) {
-    const response = await this.dart.createTransaction({
+    const { item: response } = await this.dart.createTask({
       $,
       data: {
-        clientDuid: this.duid,
-        items: [
-          {
-            duid: this.duid,
-            operations: [
-              {
-                model: "task",
-                kind: "create",
-                data: {
-                  duid: this.duid,
-                  dartboardDuid: this.dartboardId,
-                  title: this.title,
-                  description: this.description,
-                  dueAt: this.dueAt,
-                  assigneeDuids: this.assigneeIds,
-                  priority: this.priority,
-                },
-              },
-            ],
-            kind: "task_create",
-          },
-        ],
+        item: {
+          title: this.title,
+          parentId: this.parentId,
+          dartboard: this.dartboard,
+          type: this.type,
+          status: this.status,
+          description: this.description,
+          assignees: parseObject(this.assignees),
+          assignee: this.assignee,
+          tags: parseObject(this.tags),
+          priority: this.priority,
+          startAt: this.startAt,
+          dueAt: this.dueAt,
+          size: this.size,
+          customProperties: parseObject(this.customProperties),
+        },
       },
     });
-    $.export("$summary", `Created task "${this.title}"`);
+    $.export("$summary", `Successfully created task with ID: ${response.id}`);
     return response;
   },
 };

components/dart/actions/delete-doc/delete-doc.mjs

@@ -0,0 +1,32 @@
+import dart from "../../dart.app.mjs";
+
+export default {
+  key: "dart-delete-doc",
+  name: "Delete Doc",
+  description: "Move an existing doc to the trash, where it can be recovered if needed. Nothing else about the doc will be changed. [See the documentation](https://app.dartai.com/api/v0/public/docs/#/Doc/deleteDoc)",
+  version: "0.0.1",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: false,
+  },
+  type: "action",
+  props: {
+    dart,
+    docId: {
+      propDefinition: [
+        dart,
+        "docId",
+      ],
+    },
+  },
+  async run({ $ }) {
+    const response = await this.dart.deleteDoc({
+      $,
+      docId: this.docId,
+    });
+
+    $.export("$summary", `Successfully deleted doc with ID: ${this.docId}`);
+    return response;
+  },
+};