feat: Version 2

Closes #627, closes #1047

server/api/helpers/task-lists/create-one.js

@@ -0,0 +1,99 @@
+/*!
+ * Copyright (c) 2024 PLANKA Software GmbH
+ * Licensed under the Fair Use License: https://github.com/plankanban/planka/blob/master/LICENSE.md
+ */
+
+module.exports = {
+  inputs: {
+    values: {
+      type: 'json',
+      required: true,
+    },
+    project: {
+      type: 'ref',
+      required: true,
+    },
+    board: {
+      type: 'ref',
+      required: true,
+    },
+    list: {
+      type: 'ref',
+      required: true,
+    },
+    actorUser: {
+      type: 'ref',
+      required: true,
+    },
+    request: {
+      type: 'ref',
+    },
+  },
+
+  async fn(inputs) {
+    const { values } = inputs;
+
+    const taskLists = await TaskList.qm.getByCardId(values.card.id);
+
+    const { position, repositions } = sails.helpers.utils.insertToPositionables(
+      values.position,
+      taskLists,
+    );
+
+    if (repositions.length > 0) {
+      // eslint-disable-next-line no-restricted-syntax
+      for (const reposition of repositions) {
+        // eslint-disable-next-line no-await-in-loop
+        await TaskList.qm.updateOne(
+          {
+            id: reposition.record.id,
+            cardId: reposition.record.cardId,
+          },
+          {
+            position: reposition.position,
+          },
+        );
+
+        sails.sockets.broadcast(`board:${inputs.board.id}`, 'taskListUpdate', {
+          item: {
+            id: reposition.record.id,
+            position: reposition.position,
+          },
+        });
+
+        // TODO: send webhooks
+      }
+    }
+
+    const taskList = await TaskList.qm.createOne({
+      ...values,
+      position,
+      cardId: values.card.id,
+    });
+
+    sails.sockets.broadcast(
+      `board:${inputs.board.id}`,
+      'taskListCreate',
+      {
+        item: taskList,
+      },
+      inputs.request,
+    );
+
+    sails.helpers.utils.sendWebhooks.with({
+      event: 'taskListCreate',
+      buildData: () => ({
+        item: taskList,
+        included: {
+          projects: [inputs.project],
+          boards: [inputs.board],
+          lists: [inputs.list],
+          cards: [values.card],
+        },
+      }),
+      user: inputs.actorUser,
+    });
+
+    return taskList;
+  },
+};

server/api/helpers/task-lists/delete-one.js

@@ -0,0 +1,69 @@
+/*!
+ * Copyright (c) 2024 PLANKA Software GmbH
+ * Licensed under the Fair Use License: https://github.com/plankanban/planka/blob/master/LICENSE.md
+ */
+
+module.exports = {
+  inputs: {
+    record: {
+      type: 'ref',
+      required: true,
+    },
+    project: {
+      type: 'ref',
+      required: true,
+    },
+    board: {
+      type: 'ref',
+      required: true,
+    },
+    list: {
+      type: 'ref',
+      required: true,
+    },
+    card: {
+      type: 'ref',
+      required: true,
+    },
+    actorUser: {
+      type: 'ref',
+      required: true,
+    },
+    request: {
+      type: 'ref',
+    },
+  },
+
+  async fn(inputs) {
+    await sails.helpers.taskLists.deleteRelated(inputs.record);
+
+    const taskList = await TaskList.qm.deleteOne(inputs.record.id);
+
+    if (taskList) {
+      sails.sockets.broadcast(
+        `board:${inputs.board.id}`,
+        'taskListDelete',
+        {
+          item: taskList,
+        },
+        inputs.request,
+      );
+
+      sails.helpers.utils.sendWebhooks.with({
+        event: 'taskListDelete',
+        buildData: () => ({
+          item: taskList,
+          included: {
+            projects: [inputs.project],
+            boards: [inputs.board],
+            lists: [inputs.list],
+            cards: [inputs.card],
+          },
+        }),
+        user: inputs.actorUser,
+      });
+    }
+
+    return taskList;
+  },
+};

server/api/helpers/task-lists/delete-related.js

@@ -0,0 +1,28 @@
+/*!
+ * Copyright (c) 2024 PLANKA Software GmbH
+ * Licensed under the Fair Use License: https://github.com/plankanban/planka/blob/master/LICENSE.md
+ */
+
+module.exports = {
+  inputs: {
+    recordOrRecords: {
+      type: 'ref',
+      required: true,
+    },
+  },
+
+  async fn(inputs) {
+    let taskListIdOrIds;
+    if (_.isPlainObject(inputs.recordOrRecords)) {
+      ({
+        recordOrRecords: { id: taskListIdOrIds },
+      } = inputs);
+    } else if (_.every(inputs.recordOrRecords, _.isPlainObject)) {
+      taskListIdOrIds = sails.helpers.utils.mapRecords(inputs.recordOrRecords);
+    }
+
+    await Task.qm.delete({
+      taskListId: taskListIdOrIds,
+    });
+  },
+};

server/api/helpers/task-lists/get-path-to-project-by-id.js

@@ -0,0 +1,39 @@
+/*!
+ * Copyright (c) 2024 PLANKA Software GmbH
+ * Licensed under the Fair Use License: https://github.com/plankanban/planka/blob/master/LICENSE.md
+ */
+
+module.exports = {
+  inputs: {
+    id: {
+      type: 'string',
+      required: true,
+    },
+  },
+
+  exits: {
+    pathNotFound: {},
+  },
+
+  async fn(inputs) {
+    const taskList = await TaskList.qm.getOneById(inputs.id);
+
+    if (!taskList) {
+      throw 'pathNotFound';
+    }
+
+    const pathToProject = await sails.helpers.cards
+      .getPathToProjectById(taskList.cardId)
+      .intercept('pathNotFound', (nodes) => ({
+        pathNotFound: {
+          taskList,
+          ...nodes,
+        },
+      }));
+
+    return {
+      taskList,
+      ...pathToProject,
+    };
+  },
+};

server/api/helpers/task-lists/update-one.js

@@ -0,0 +1,114 @@
+/*!
+ * Copyright (c) 2024 PLANKA Software GmbH
+ * Licensed under the Fair Use License: https://github.com/plankanban/planka/blob/master/LICENSE.md
+ */
+
+module.exports = {
+  inputs: {
+    record: {
+      type: 'ref',
+      required: true,
+    },
+    values: {
+      type: 'json',
+      required: true,
+    },
+    project: {
+      type: 'ref',
+      required: true,
+    },
+    board: {
+      type: 'ref',
+      required: true,
+    },
+    list: {
+      type: 'ref',
+      required: true,
+    },
+    card: {
+      type: 'ref',
+      required: true,
+    },
+    actorUser: {
+      type: 'ref',
+      required: true,
+    },
+    request: {
+      type: 'ref',
+    },
+  },
+
+  async fn(inputs) {
+    const { values } = inputs;
+
+    if (!_.isUndefined(values.position)) {
+      const taskLists = await TaskList.qm.getByCardId(inputs.record.cardId, {
+        exceptIdOrIds: inputs.record.id,
+      });
+
+      const { position, repositions } = sails.helpers.utils.insertToPositionables(
+        values.position,
+        taskLists,
+      );
+
+      values.position = position;
+
+      if (repositions.length > 0) {
+        // eslint-disable-next-line no-restricted-syntax
+        for (const reposition of repositions) {
+          // eslint-disable-next-line no-await-in-loop
+          await TaskList.qm.updateOne(
+            {
+              id: reposition.record.id,
+              cardId: reposition.record.cardId,
+            },
+            {
+              position: reposition.position,
+            },
+          );
+
+          sails.sockets.broadcast(`board:${inputs.board.id}`, 'taskListUpdate', {
+            item: {
+              id: reposition.record.id,
+              position: reposition.position,
+            },
+          });
+
+          // TODO: send webhooks
+        }
+      }
+    }
+
+    const taskList = await TaskList.qm.updateOne(inputs.record.id, values);
+
+    if (taskList) {
+      sails.sockets.broadcast(
+        `board:${inputs.board.id}`,
+        'taskListUpdate',
+        {
+          item: taskList,
+        },
+        inputs.request,
+      );
+
+      sails.helpers.utils.sendWebhooks.with({
+        event: 'taskListUpdate',
+        buildData: () => ({
+          item: taskList,
+          included: {
+            projects: [inputs.project],
+            boards: [inputs.board],
+            lists: [inputs.list],
+            cards: [inputs.card],
+          },
+        }),
+        buildPrevData: () => ({
+          item: inputs.record,
+        }),
+        user: inputs.actorUser,
+      });
+    }
+
+    return taskList;
+  },
+};