/*! * Copyright (c) 2024 PLANKA Software GmbH * Licensed under the Fair Use License: https://github.com/plankanban/planka/blob/master/LICENSE.md */ /** * @swagger * /api/cards/{id}/duplicate: * post: * summary: Duplicate card * description: Creates a duplicate of a card with all its contents (tasks, attachments, etc.). Requires board editor permissions. * tags: * - Cards * parameters: * - name: id * in: path * required: true * description: ID of the card to duplicate * schema: * type: string * example: 1357158568008091264 * requestBody: * required: true * content: * application/json: * schema: * type: object * required: * - position * - name * properties: * position: * type: number * minimum: 0 * description: Position for the duplicated card within the list * example: 65536 * name: * type: string * maxLength: 1024 * description: Name/title for the duplicated card * example: Implement user authentication (copy) * responses: * 200: * description: Card duplicated successfully * content: * application/json: * schema: * type: object * required: * - item * - included * properties: * item: * $ref: '#/components/schemas/Card' * included: * type: object * required: * - cardMemberships * - cardLabels * - taskLists * - tasks * - attachments * - customFieldGroups * - customFields * - customFieldValues * properties: * cardMemberships: * type: array * description: Related card-membership associations * items: * $ref: '#/components/schemas/CardMembership' * cardLabels: * type: array * description: Related card-label associations * items: * $ref: '#/components/schemas/CardLabel' * taskLists: * type: array * description: Related task lists * items: * $ref: '#/components/schemas/TaskList' * tasks: * type: array * description: Related tasks * items: * $ref: '#/components/schemas/Task' * attachments: * type: array * description: Related attachments * items: * $ref: '#/components/schemas/Attachment' * customFieldGroups: * type: array * description: Related custom field groups * items: * $ref: '#/components/schemas/CustomFieldGroup' * customFields: * type: array * description: Related custom fields * items: * $ref: '#/components/schemas/CustomField' * customFieldValues: * type: array * description: Related custom field values * items: * $ref: '#/components/schemas/CustomFieldValue' * 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', }, }; module.exports = { inputs: { id: { ...idInput, required: true, }, position: { type: 'number', min: 0, required: true, }, name: { type: 'string', maxLength: 1024, required: true, }, }, exits: { notEnoughRights: { responseType: 'forbidden', }, cardNotFound: { responseType: 'notFound', }, }, async fn(inputs) { const { currentUser } = this.req; const { card, list, board, project } = await sails.helpers.cards .getPathToProjectById(inputs.id) .intercept('pathNotFound', () => Errors.CARD_NOT_FOUND); const boardMembership = await BoardMembership.qm.getOneByBoardIdAndUserId( board.id, currentUser.id, ); if (!boardMembership) { throw Errors.CARD_NOT_FOUND; // Forbidden } // TODO: allow for endless lists? if (!sails.helpers.lists.isFinite(list)) { throw Errors.NOT_ENOUGH_RIGHTS; } if (boardMembership.role !== BoardMembership.Roles.EDITOR) { throw Errors.NOT_ENOUGH_RIGHTS; } const values = _.pick(inputs, ['position', 'name']); const { card: nextCard, cardMemberships, cardLabels, taskLists, tasks, attachments, customFieldGroups, customFields, customFieldValues, } = await sails.helpers.cards.duplicateOne.with({ project, board, list, record: card, values: { ...values, creatorUser: currentUser, }, request: this.req, }); return { item: nextCard, included: { cardMemberships, cardLabels, taskLists, tasks, customFieldGroups, customFields, customFieldValues, attachments: sails.helpers.attachments.presentMany(attachments), }, }; }, };