/*! * Copyright (c) 2024 PLANKA Software GmbH * Licensed under the Fair Use License: https://github.com/plankanban/planka/blob/master/LICENSE.md */ /** * @swagger * /boards/{id}: * delete: * summary: Delete board * description: Deletes a board and all its contents (lists, cards, etc.). Requires project manager permissions. * tags: * - Boards * parameters: * - name: id * in: path * required: true * description: ID of the board to delete * schema: * type: string * example: "1357158568008091264" * responses: * 200: * description: Board deleted successfully * content: * application/json: * schema: * type: object * required: * - item * properties: * item: * $ref: '#/components/schemas/Board' * 400: * $ref: '#/components/responses/ValidationError' * 401: * $ref: '#/components/responses/Unauthorized' * 404: * $ref: '#/components/responses/NotFound' */ const { idInput } = require('../../../utils/inputs'); const Errors = { BOARD_NOT_FOUND: { boardNotFound: 'Board not found', }, }; module.exports = { inputs: { id: { ...idInput, required: true, }, }, exits: { boardNotFound: { responseType: 'notFound', }, }, async fn(inputs) { const { currentUser } = this.req; const pathToProject = await sails.helpers.boards .getPathToProjectById(inputs.id) .intercept('pathNotFound', () => Errors.BOARD_NOT_FOUND); let { board } = pathToProject; const { project } = pathToProject; const isProjectManager = await sails.helpers.users.isProjectManager(currentUser.id, project.id); if (!isProjectManager) { throw Errors.BOARD_NOT_FOUND; // Forbidden } board = await sails.helpers.boards.deleteOne.with({ project, record: board, actorUser: currentUser, request: this.req, }); if (!board) { throw Errors.BOARD_NOT_FOUND; } return { item: board, }; }, };