/*! * Copyright (c) 2024 PLANKA Software GmbH * Licensed under the Fair Use License: https://github.com/plankanban/planka/blob/master/LICENSE.md */ /** * @swagger * /api/projects/{id}: * delete: * summary: Delete project * description: Deletes a project. The project must not have any boards. Requires project manager permissions. * tags: * - Projects * parameters: * - name: id * in: path * required: true * description: ID of the project to delete * schema: * type: string * example: 1357158568008091264 * responses: * 200: * description: Project deleted successfully * content: * application/json: * schema: * type: object * required: * - item * properties: * item: * $ref: '#/components/schemas/Project' * 400: * $ref: '#/components/responses/ValidationError' * 401: * $ref: '#/components/responses/Unauthorized' * 404: * $ref: '#/components/responses/NotFound' * 422: * $ref: '#/components/responses/UnprocessableEntity' */ const { idInput } = require('../../../utils/inputs'); const Errors = { PROJECT_NOT_FOUND: { projectNotFound: 'Project not found', }, MUST_NOT_HAVE_BOARDS: { mustNotHaveBoards: 'Must not have boards', }, }; module.exports = { inputs: { id: { ...idInput, required: true, }, }, exits: { projectNotFound: { responseType: 'notFound', }, mustNotHaveBoards: { responseType: 'unprocessableEntity', }, }, async fn(inputs) { const { currentUser } = this.req; let project = await Project.qm.getOneById(inputs.id); if (!project) { throw Errors.PROJECT_NOT_FOUND; } const isProjectManager = await sails.helpers.users.isProjectManager(currentUser.id, project.id); if (!isProjectManager) { throw Errors.PROJECT_NOT_FOUND; // Forbidden } project = await sails.helpers.projects.deleteOne .with({ record: project, actorUser: currentUser, request: this.req, }) .intercept('mustNotHaveBoards', () => Errors.MUST_NOT_HAVE_BOARDS); if (!project) { throw Errors.PROJECT_NOT_FOUND; } return { item: project, }; }, };