Files
planka/server/api/controllers/card-labels/delete.js
2025-09-12 12:17:01 +02:00

135 lines
3.1 KiB
JavaScript
Executable File

/*!
* Copyright (c) 2024 PLANKA Software GmbH
* Licensed under the Fair Use License: https://github.com/plankanban/planka/blob/master/LICENSE.md
*/
/**
* @swagger
* /cards/{cardId}/labels/{labelId}:
* delete:
* summary: Remove label from card
* description: Removes a label from a card. Requires board editor permissions.
* tags:
* - Card Labels
* operationId: deleteCardLabel
* parameters:
* - name: cardId
* in: path
* required: true
* description: ID of the card to remove the label from
* schema:
* type: string
* example: "1357158568008091264"
* - name: labelId
* in: path
* required: true
* description: ID of the label to remove from the card
* schema:
* type: string
* example: "1357158568008091265"
* responses:
* 200:
* description: Label removed from card successfully
* content:
* application/json:
* schema:
* type: object
* required:
* - item
* properties:
* item:
* $ref: '#/components/schemas/CardLabel'
* 400:
* $ref: '#/components/responses/ValidationError'
* 401:
* $ref: '#/components/responses/Unauthorized'
* 403:
* $ref: '#/components/responses/Forbidden'
* 404:
* $ref: '#/components/responses/NotFound'
*/
const { idInput } = require('../../../utils/inputs');
const Errors = {
NOT_ENOUGH_RIGHTS: {
notEnoughRights: 'Not enough rights',
},
CARD_NOT_FOUND: {
cardNotFound: 'Card not found',
},
LABEL_NOT_IN_CARD: {
labelNotInCard: 'Label not in card',
},
};
module.exports = {
inputs: {
cardId: {
...idInput,
required: true,
},
labelId: {
...idInput,
required: true,
},
},
exits: {
notEnoughRights: {
responseType: 'forbidden',
},
cardNotFound: {
responseType: 'notFound',
},
labelNotInCard: {
responseType: 'notFound',
},
},
async fn(inputs) {
const { currentUser } = this.req;
const { card, list, board, project } = await sails.helpers.cards
.getPathToProjectById(inputs.cardId)
.intercept('pathNotFound', () => Errors.CARD_NOT_FOUND);
const boardMembership = await BoardMembership.qm.getOneByBoardIdAndUserId(
board.id,
currentUser.id,
);
if (!boardMembership) {
throw Errors.CARD_NOT_FOUND; // Forbidden
}
if (boardMembership.role !== BoardMembership.Roles.EDITOR) {
throw Errors.NOT_ENOUGH_RIGHTS;
}
let cardLabel = await CardLabel.qm.getOneByCardIdAndLabelId(card.id, inputs.labelId);
if (!cardLabel) {
throw Errors.LABEL_NOT_IN_CARD;
}
cardLabel = await sails.helpers.cardLabels.deleteOne.with({
project,
board,
list,
card,
record: cardLabel,
actorUser: currentUser,
request: this.req,
});
if (!cardLabel) {
throw Errors.LABEL_NOT_IN_CARD;
}
return {
item: cardLabel,
};
},
};