@flusys/nestjs-task-manager 7.1.0 → 8.0.0

package/cjs/controllers/task.controller.js

@@ -1,199 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "TaskController", {
-    enumerable: true,
-    get: function() {
-        return TaskController;
-    }
-});
-const _classes = require("@flusys/nestjs-shared/classes");
-const _decorators = require("@flusys/nestjs-shared/decorators");
-const _guards = require("@flusys/nestjs-shared/guards");
-const _interfaces = require("@flusys/nestjs-shared/interfaces");
-const _common = require("@nestjs/common");
-const _swagger = require("@nestjs/swagger");
-const _classtransformer = require("class-transformer");
-const _nestjsshared = require("@flusys/nestjs-shared");
-const _config = require("../config");
-const _dtos = require("../dtos");
-const _taskboardgateway = require("../gateways/task-board.gateway");
-const _taskservice = require("../services/task.service");
-function _define_property(obj, key, value) {
-    if (key in obj) {
-        Object.defineProperty(obj, key, {
-            value: value,
-            enumerable: true,
-            configurable: true,
-            writable: true
-        });
-    } else {
-        obj[key] = value;
-    }
-    return obj;
-}
-function _ts_decorate(decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for(var i = decorators.length - 1; i >= 0; i--)if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-}
-function _ts_metadata(k, v) {
-    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-}
-function _ts_param(paramIndex, decorator) {
-    return function(target, key) {
-        decorator(target, key, paramIndex);
-    };
-}
-let TaskController = class TaskController extends (0, _classes.createApiController)(_dtos.CreateTaskDto, _dtos.UpdateTaskDto, _dtos.TaskResponseDto, {
-    entityName: 'task',
-    enabledEndpoints: [
-        'insert',
-        'insertMany',
-        'getById',
-        'getAll',
-        'update',
-        'updateMany',
-        'delete'
-    ],
-    security: {
-        insert: {
-            level: 'permission',
-            permissions: [
-                _nestjsshared.TASK_PERMISSIONS.CREATE
-            ]
-        },
-        insertMany: {
-            level: 'permission',
-            permissions: [
-                _nestjsshared.TASK_PERMISSIONS.CREATE
-            ]
-        },
-        getById: {
-            level: 'permission',
-            permissions: [
-                _nestjsshared.TASK_PERMISSIONS.READ
-            ]
-        },
-        getAll: {
-            level: 'permission',
-            permissions: [
-                _nestjsshared.TASK_PERMISSIONS.READ
-            ]
-        },
-        update: {
-            level: 'permission',
-            permissions: [
-                _nestjsshared.TASK_PERMISSIONS.UPDATE
-            ]
-        },
-        updateMany: {
-            level: 'permission',
-            permissions: [
-                _nestjsshared.TASK_PERMISSIONS.UPDATE
-            ]
-        },
-        delete: {
-            level: 'permission',
-            permissions: [
-                _nestjsshared.TASK_PERMISSIONS.DELETE
-            ]
-        }
-    }
-}) {
-    async moveTask(dto, user) {
-        const task = await this.taskService.moveTask(dto, user);
-        const data = (0, _classtransformer.plainToInstance)(_dtos.TaskResponseDto, task, {
-            excludeExtraneousValues: true
-        });
-        this.gateway?.emitToBoardRoom(task.boardId, {
-            type: 'task:moved',
-            boardId: task.boardId,
-            payload: data
-        });
-        return {
-            success: true,
-            message: 'Task moved',
-            messageKey: _config.TASK_MESSAGES.MOVE_SUCCESS,
-            data
-        };
-    }
-    async assignTask(dto, user) {
-        const task = await this.taskService.assignTask(dto, user);
-        const data = (0, _classtransformer.plainToInstance)(_dtos.TaskResponseDto, task, {
-            excludeExtraneousValues: true
-        });
-        this.gateway?.emitToBoardRoom(task.boardId, {
-            type: 'task:updated',
-            boardId: task.boardId,
-            payload: data
-        });
-        return {
-            success: true,
-            message: 'Task assigned',
-            messageKey: _config.TASK_MESSAGES.ASSIGN_SUCCESS,
-            data
-        };
-    }
-    constructor(taskService, gateway){
-        super(taskService), _define_property(this, "taskService", void 0), _define_property(this, "gateway", void 0), this.taskService = taskService, this.gateway = gateway;
-    }
-};
-_ts_decorate([
-    (0, _common.Post)('move'),
-    (0, _common.UseGuards)(_guards.JwtAuthGuard, _guards.PermissionGuard),
-    (0, _swagger.ApiBearerAuth)(),
-    (0, _common.HttpCode)(_common.HttpStatus.OK),
-    (0, _decorators.RequirePermission)(_nestjsshared.TASK_PERMISSIONS.MOVE),
-    (0, _swagger.ApiOperation)({
-        summary: 'Move task to another list'
-    }),
-    (0, _swagger.ApiBody)({
-        type: _dtos.MoveTaskDto
-    }),
-    (0, _decorators.ApiResponseDto)(_dtos.TaskResponseDto),
-    _ts_param(0, (0, _common.Body)()),
-    _ts_param(1, (0, _decorators.CurrentUser)()),
-    _ts_metadata("design:type", Function),
-    _ts_metadata("design:paramtypes", [
-        typeof _dtos.MoveTaskDto === "undefined" ? Object : _dtos.MoveTaskDto,
-        typeof _interfaces.ILoggedUserInfo === "undefined" ? Object : _interfaces.ILoggedUserInfo
-    ]),
-    _ts_metadata("design:returntype", Promise)
-], TaskController.prototype, "moveTask", null);
-_ts_decorate([
-    (0, _common.Post)('assign'),
-    (0, _common.UseGuards)(_guards.JwtAuthGuard, _guards.PermissionGuard),
-    (0, _swagger.ApiBearerAuth)(),
-    (0, _common.HttpCode)(_common.HttpStatus.OK),
-    (0, _decorators.RequirePermission)(_nestjsshared.TASK_PERMISSIONS.ASSIGN),
-    (0, _swagger.ApiOperation)({
-        summary: 'Assign task to a board member'
-    }),
-    (0, _swagger.ApiBody)({
-        type: _dtos.AssignTaskDto
-    }),
-    (0, _decorators.ApiResponseDto)(_dtos.TaskResponseDto),
-    _ts_param(0, (0, _common.Body)()),
-    _ts_param(1, (0, _decorators.CurrentUser)()),
-    _ts_metadata("design:type", Function),
-    _ts_metadata("design:paramtypes", [
-        typeof _dtos.AssignTaskDto === "undefined" ? Object : _dtos.AssignTaskDto,
-        typeof _interfaces.ILoggedUserInfo === "undefined" ? Object : _interfaces.ILoggedUserInfo
-    ]),
-    _ts_metadata("design:returntype", Promise)
-], TaskController.prototype, "assignTask", null);
-TaskController = _ts_decorate([
-    (0, _swagger.ApiTags)('Task Manager - Tasks'),
-    (0, _common.Controller)('task-manager/task'),
-    _ts_param(0, (0, _common.Inject)(_taskservice.TaskService)),
-    _ts_param(1, (0, _common.Optional)()),
-    _ts_param(1, (0, _common.Inject)(_taskboardgateway.TaskBoardGateway)),
-    _ts_metadata("design:type", Function),
-    _ts_metadata("design:paramtypes", [
-        typeof _taskservice.TaskService === "undefined" ? Object : _taskservice.TaskService,
-        typeof _taskboardgateway.TaskBoardGateway === "undefined" ? Object : _taskboardgateway.TaskBoardGateway
-    ])
-], TaskController);

package/cjs/controllers/task.controller.spec.js

@@ -1,131 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-const _loggedusermock = require("@test-utils/mocks/logged-user.mock");
-const _entities = require("../entities");
-const _taskcontroller = require("./task.controller");
-function buildTask(overrides = {}) {
-    return {
-        id: 'task-uuid-1',
-        boardId: 'board-uuid-1',
-        listId: 'list-uuid-1',
-        title: 'Fix bug',
-        description: null,
-        priority: _entities.TaskPriority.MEDIUM,
-        dueDate: null,
-        position: 0,
-        assignees: [],
-        reporterId: 'user-uuid-1',
-        parentTaskId: null,
-        estimatedHours: null,
-        createdAt: new Date(),
-        updatedAt: new Date(),
-        ...overrides
-    };
-}
-describe('TaskController', ()=>{
-    let controller;
-    let mockTaskService;
-    let mockGateway;
-    beforeEach(async ()=>{
-        mockTaskService = {
-            moveTask: jest.fn(),
-            assignTask: jest.fn(),
-            insert: jest.fn(),
-            update: jest.fn(),
-            getAll: jest.fn(),
-            findById: jest.fn(),
-            delete: jest.fn()
-        };
-        mockGateway = {
-            emitToBoardRoom: jest.fn()
-        };
-        controller = new _taskcontroller.TaskController(mockTaskService, mockGateway);
-    });
-    describe('moveTask', ()=>{
-        it('moves the task and broadcasts a task:moved event to the board room', async ()=>{
-            const task = buildTask({
-                listId: 'list-new',
-                position: 2
-            });
-            mockTaskService.moveTask.mockResolvedValue(task);
-            const user = (0, _loggedusermock.buildMockUser)();
-            const result = await controller.moveTask({
-                taskId: 'task-uuid-1',
-                targetListId: 'list-new',
-                position: 2
-            }, user);
-            expect(mockTaskService.moveTask).toHaveBeenCalledWith({
-                taskId: 'task-uuid-1',
-                targetListId: 'list-new',
-                position: 2
-            }, user);
-            expect(result.success).toBe(true);
-            expect(result.data).toEqual(expect.objectContaining({
-                id: 'task-uuid-1',
-                listId: 'list-new'
-            }));
-            expect(mockGateway.emitToBoardRoom).toHaveBeenCalledWith('board-uuid-1', expect.objectContaining({
-                type: 'task:moved',
-                boardId: 'board-uuid-1'
-            }));
-        });
-        it('still returns successfully when no gateway is wired (optional dependency)', async ()=>{
-            const controllerNoGateway = new _taskcontroller.TaskController(mockTaskService, undefined);
-            mockTaskService.moveTask.mockResolvedValue(buildTask());
-            const result = await controllerNoGateway.moveTask({
-                taskId: 'task-uuid-1',
-                targetListId: 'list-1'
-            }, (0, _loggedusermock.buildMockUser)());
-            expect(result.success).toBe(true);
-        });
-        it('propagates a NotFoundException from the service when the task does not exist', async ()=>{
-            mockTaskService.moveTask.mockRejectedValue(new Error('Task not found'));
-            await expect(controller.moveTask({
-                taskId: 'missing',
-                targetListId: 'list-1'
-            }, (0, _loggedusermock.buildMockUser)())).rejects.toThrow('Task not found');
-            expect(mockGateway.emitToBoardRoom).not.toHaveBeenCalled();
-        });
-    });
-    describe('assignTask', ()=>{
-        it('assigns the task and broadcasts a task:updated event to the board room', async ()=>{
-            const task = buildTask({
-                assignees: [
-                    {
-                        userId: 'user-2',
-                        userName: 'Bob'
-                    }
-                ]
-            });
-            mockTaskService.assignTask.mockResolvedValue(task);
-            const user = (0, _loggedusermock.buildMockUser)();
-            const result = await controller.assignTask({
-                taskId: 'task-uuid-1',
-                assigneeIds: [
-                    'user-2'
-                ]
-            }, user);
-            expect(mockTaskService.assignTask).toHaveBeenCalledWith({
-                taskId: 'task-uuid-1',
-                assigneeIds: [
-                    'user-2'
-                ]
-            }, user);
-            expect(result.success).toBe(true);
-            expect(mockGateway.emitToBoardRoom).toHaveBeenCalledWith('board-uuid-1', expect.objectContaining({
-                type: 'task:updated'
-            }));
-        });
-        it('propagates a BadRequestException when an assignee is not a board member', async ()=>{
-            mockTaskService.assignTask.mockRejectedValue(new Error('Assignee is not a board member'));
-            await expect(controller.assignTask({
-                taskId: 'task-uuid-1',
-                assigneeIds: [
-                    'stranger'
-                ]
-            }, (0, _loggedusermock.buildMockUser)())).rejects.toThrow('Assignee is not a board member');
-        });
-    });
-});

package/cjs/docs/index.js

@@ -1,18 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-_export_star(require("./task-manager-swagger.config"), exports);
-function _export_star(from, to) {
-    Object.keys(from).forEach(function(k) {
-        if (k !== "default" && !Object.prototype.hasOwnProperty.call(to, k)) {
-            Object.defineProperty(to, k, {
-                enumerable: true,
-                get: function() {
-                    return from[k];
-                }
-            });
-        }
-    });
-    return from;
-}

package/cjs/docs/task-manager-swagger.config.js

@@ -1,43 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "taskManagerSwaggerConfig", {
-    enumerable: true,
-    get: function() {
-        return taskManagerSwaggerConfig;
-    }
-});
-function taskManagerSwaggerConfig() {
-    return {
-        title: 'Task Manager API',
-        description: `
-## Task Manager API
-
-Manages kanban boards, task lists, tasks, labels, comments, and real-time board collaboration.
-
-### Features
-- Board management with member access control
-- Drag-and-drop task lists with position ordering
-- Tasks with priority, due date, assignee, and label support
-- Label assignment via junction table (many-to-many)
-- Task comments and activity log
-- Real-time updates via WebSocket (Socket.IO)
-
-### Endpoints
-
-- \`POST /task-manager/board/*\` — Board CRUD + member management
-
-- \`POST /task-manager/list/*\` — List CRUD + reorder
-
-- \`POST /task-manager/task/*\` — Task CRUD + move + assign
-
-- \`POST /task-manager/label/*\` — Label CRUD
-
-- \`POST /task-manager/comment/*\` — Comment CRUD
-`,
-        version: '1.0',
-        path: 'api/docs/task-manager',
-        bearerAuth: true
-    };
-}

package/cjs/docs/task-manager-swagger.config.spec.js

@@ -1,28 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-const _taskmanagerswaggerconfig = require("./task-manager-swagger.config");
-describe('taskManagerSwaggerConfig', ()=>{
-    it('should build a static swagger config with the expected identity fields', ()=>{
-        const config = (0, _taskmanagerswaggerconfig.taskManagerSwaggerConfig)();
-        expect(config.title).toBe('Task Manager API');
-        expect(config.path).toBe('api/docs/task-manager');
-        expect(config.version).toBe('1.0');
-        expect(config.bearerAuth).toBe(true);
-    });
-    it('should describe every top-level resource endpoint group', ()=>{
-        const config = (0, _taskmanagerswaggerconfig.taskManagerSwaggerConfig)();
-        expect(config.description).toContain('/task-manager/board/*');
-        expect(config.description).toContain('/task-manager/list/*');
-        expect(config.description).toContain('/task-manager/task/*');
-        expect(config.description).toContain('/task-manager/label/*');
-        expect(config.description).toContain('/task-manager/comment/*');
-    });
-    it('should return a fresh object on every call rather than a shared mutable singleton', ()=>{
-        const first = (0, _taskmanagerswaggerconfig.taskManagerSwaggerConfig)();
-        const second = (0, _taskmanagerswaggerconfig.taskManagerSwaggerConfig)();
-        expect(first).not.toBe(second);
-        expect(first).toEqual(second);
-    });
-});

package/cjs/dtos/index.js

@@ -1,22 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-_export_star(require("./task-board.dto"), exports);
-_export_star(require("./task-list.dto"), exports);
-_export_star(require("./task.dto"), exports);
-_export_star(require("./task-label.dto"), exports);
-_export_star(require("./task-comment.dto"), exports);
-function _export_star(from, to) {
-    Object.keys(from).forEach(function(k) {
-        if (k !== "default" && !Object.prototype.hasOwnProperty.call(to, k)) {
-            Object.defineProperty(to, k, {
-                enumerable: true,
-                get: function() {
-                    return from[k];
-                }
-            });
-        }
-    });
-    return from;
-}