@flusys/nestjs-task-manager 5.3.0

package/fesm/controllers/task.controller.js

@@ -0,0 +1,189 @@
+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);
+    };
+}
+import { createApiController } from '@flusys/nestjs-shared/classes';
+import { ApiResponseDto, CurrentUser, RequirePermission } from '@flusys/nestjs-shared/decorators';
+import { JwtAuthGuard, PermissionGuard } from '@flusys/nestjs-shared/guards';
+import { ILoggedUserInfo } from '@flusys/nestjs-shared/interfaces';
+import { Body, Controller, HttpCode, HttpStatus, Inject, Optional, Post, UseGuards } from '@nestjs/common';
+import { ApiBearerAuth, ApiBody, ApiOperation, ApiTags } from '@nestjs/swagger';
+import { plainToInstance } from 'class-transformer';
+import { TASK_PERMISSIONS } from '@flusys/nestjs-shared';
+import { TASK_MESSAGES } from '../config';
+import { AssignTaskDto, CreateTaskDto, MoveTaskDto, TaskResponseDto, UpdateTaskDto } from '../dtos';
+import { TaskBoardGateway } from '../gateways/task-board.gateway';
+import { TaskService } from '../services/task.service';
+export class TaskController extends createApiController(CreateTaskDto, UpdateTaskDto, TaskResponseDto, {
+    entityName: 'task',
+    enabledEndpoints: [
+        'insert',
+        'insertMany',
+        'getById',
+        'getAll',
+        'update',
+        'updateMany',
+        'delete'
+    ],
+    security: {
+        insert: {
+            level: 'permission',
+            permissions: [
+                TASK_PERMISSIONS.CREATE
+            ]
+        },
+        insertMany: {
+            level: 'permission',
+            permissions: [
+                TASK_PERMISSIONS.CREATE
+            ]
+        },
+        getById: {
+            level: 'permission',
+            permissions: [
+                TASK_PERMISSIONS.READ
+            ]
+        },
+        getAll: {
+            level: 'permission',
+            permissions: [
+                TASK_PERMISSIONS.READ
+            ]
+        },
+        update: {
+            level: 'permission',
+            permissions: [
+                TASK_PERMISSIONS.UPDATE
+            ]
+        },
+        updateMany: {
+            level: 'permission',
+            permissions: [
+                TASK_PERMISSIONS.UPDATE
+            ]
+        },
+        delete: {
+            level: 'permission',
+            permissions: [
+                TASK_PERMISSIONS.DELETE
+            ]
+        }
+    }
+}) {
+    async moveTask(dto, user) {
+        const task = await this.taskService.moveTask(dto, user);
+        const data = plainToInstance(TaskResponseDto, task, {
+            excludeExtraneousValues: true
+        });
+        this.gateway?.emitToBoardRoom(task.boardId, {
+            type: 'task:moved',
+            boardId: task.boardId,
+            payload: data
+        });
+        return {
+            success: true,
+            message: 'Task moved',
+            messageKey: TASK_MESSAGES.MOVE_SUCCESS,
+            data
+        };
+    }
+    async assignTask(dto, user) {
+        const task = await this.taskService.assignTask(dto, user);
+        const data = plainToInstance(TaskResponseDto, task, {
+            excludeExtraneousValues: true
+        });
+        this.gateway?.emitToBoardRoom(task.boardId, {
+            type: 'task:updated',
+            boardId: task.boardId,
+            payload: data
+        });
+        return {
+            success: true,
+            message: 'Task assigned',
+            messageKey: 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([
+    Post('move'),
+    UseGuards(JwtAuthGuard, PermissionGuard),
+    ApiBearerAuth(),
+    HttpCode(HttpStatus.OK),
+    RequirePermission(TASK_PERMISSIONS.MOVE),
+    ApiOperation({
+        summary: 'Move task to another list'
+    }),
+    ApiBody({
+        type: MoveTaskDto
+    }),
+    ApiResponseDto(TaskResponseDto),
+    _ts_param(0, Body()),
+    _ts_param(1, CurrentUser()),
+    _ts_metadata("design:type", Function),
+    _ts_metadata("design:paramtypes", [
+        typeof MoveTaskDto === "undefined" ? Object : MoveTaskDto,
+        typeof ILoggedUserInfo === "undefined" ? Object : ILoggedUserInfo
+    ]),
+    _ts_metadata("design:returntype", Promise)
+], TaskController.prototype, "moveTask", null);
+_ts_decorate([
+    Post('assign'),
+    UseGuards(JwtAuthGuard, PermissionGuard),
+    ApiBearerAuth(),
+    HttpCode(HttpStatus.OK),
+    RequirePermission(TASK_PERMISSIONS.ASSIGN),
+    ApiOperation({
+        summary: 'Assign task to a board member'
+    }),
+    ApiBody({
+        type: AssignTaskDto
+    }),
+    ApiResponseDto(TaskResponseDto),
+    _ts_param(0, Body()),
+    _ts_param(1, CurrentUser()),
+    _ts_metadata("design:type", Function),
+    _ts_metadata("design:paramtypes", [
+        typeof AssignTaskDto === "undefined" ? Object : AssignTaskDto,
+        typeof ILoggedUserInfo === "undefined" ? Object : ILoggedUserInfo
+    ]),
+    _ts_metadata("design:returntype", Promise)
+], TaskController.prototype, "assignTask", null);
+TaskController = _ts_decorate([
+    ApiTags('Task Manager - Tasks'),
+    Controller('task-manager/task'),
+    _ts_param(0, Inject(TaskService)),
+    _ts_param(1, Optional()),
+    _ts_param(1, Inject(TaskBoardGateway)),
+    _ts_metadata("design:type", Function),
+    _ts_metadata("design:paramtypes", [
+        typeof TaskService === "undefined" ? Object : TaskService,
+        typeof TaskBoardGateway === "undefined" ? Object : TaskBoardGateway
+    ])
+], TaskController);

package/fesm/docs/index.js

@@ -0,0 +1 @@
+export * from './task-manager-swagger.config';

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

@@ -0,0 +1,33 @@
+export 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/fesm/dtos/index.js

@@ -0,0 +1,5 @@
+export * from './task-board.dto';
+export * from './task-list.dto';
+export * from './task.dto';
+export * from './task-label.dto';
+export * from './task-comment.dto';

package/fesm/dtos/task-board.dto.js

@@ -0,0 +1,277 @@
+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);
+}
+import { ApiProperty, ApiPropertyOptional, PartialType } from '@nestjs/swagger';
+import { Expose } from 'class-transformer';
+import { IsBoolean, IsNotEmpty, IsOptional, IsString, IsUUID, MaxLength, IsEnum } from 'class-validator';
+import { IdentityResponseDto } from '@flusys/nestjs-shared/dtos';
+import { BoardMemberRole } from '../entities/task-board-member.entity';
+export class CreateTaskBoardDto {
+    constructor(){
+        _define_property(this, "name", void 0);
+        _define_property(this, "description", void 0);
+        _define_property(this, "color", void 0);
+        _define_property(this, "memberIds", void 0);
+    }
+}
+_ts_decorate([
+    ApiProperty({
+        description: 'Board name',
+        maxLength: 255
+    }),
+    IsNotEmpty(),
+    IsString(),
+    MaxLength(255),
+    _ts_metadata("design:type", String)
+], CreateTaskBoardDto.prototype, "name", void 0);
+_ts_decorate([
+    ApiPropertyOptional({
+        description: 'Board description'
+    }),
+    IsOptional(),
+    IsString(),
+    _ts_metadata("design:type", String)
+], CreateTaskBoardDto.prototype, "description", void 0);
+_ts_decorate([
+    ApiPropertyOptional({
+        description: 'Board color hex',
+        example: '#3B82F6',
+        default: '#3B82F6'
+    }),
+    IsOptional(),
+    IsString(),
+    MaxLength(7),
+    _ts_metadata("design:type", String)
+], CreateTaskBoardDto.prototype, "color", void 0);
+_ts_decorate([
+    ApiPropertyOptional({
+        description: 'Initial member user IDs',
+        type: [
+            String
+        ]
+    }),
+    IsOptional(),
+    IsUUID('4', {
+        each: true
+    }),
+    _ts_metadata("design:type", Array)
+], CreateTaskBoardDto.prototype, "memberIds", void 0);
+export class UpdateTaskBoardDto extends PartialType(CreateTaskBoardDto) {
+    constructor(...args){
+        super(...args), _define_property(this, "id", void 0), _define_property(this, "isActive", void 0);
+    }
+}
+_ts_decorate([
+    ApiProperty(),
+    IsUUID(),
+    _ts_metadata("design:type", String)
+], UpdateTaskBoardDto.prototype, "id", void 0);
+_ts_decorate([
+    ApiPropertyOptional(),
+    IsOptional(),
+    IsBoolean(),
+    _ts_metadata("design:type", Boolean)
+], UpdateTaskBoardDto.prototype, "isActive", void 0);
+export class AddBoardMemberDto {
+    constructor(){
+        _define_property(this, "boardId", void 0);
+        _define_property(this, "userId", void 0);
+        _define_property(this, "role", void 0);
+    }
+}
+_ts_decorate([
+    ApiProperty(),
+    IsUUID(),
+    _ts_metadata("design:type", String)
+], AddBoardMemberDto.prototype, "boardId", void 0);
+_ts_decorate([
+    ApiProperty(),
+    IsUUID(),
+    _ts_metadata("design:type", String)
+], AddBoardMemberDto.prototype, "userId", void 0);
+_ts_decorate([
+    ApiPropertyOptional({
+        enum: BoardMemberRole,
+        default: BoardMemberRole.MEMBER
+    }),
+    IsOptional(),
+    IsEnum(BoardMemberRole),
+    _ts_metadata("design:type", typeof BoardMemberRole === "undefined" ? Object : BoardMemberRole)
+], AddBoardMemberDto.prototype, "role", void 0);
+export class RemoveBoardMemberDto {
+    constructor(){
+        _define_property(this, "boardId", void 0);
+        _define_property(this, "userId", void 0);
+    }
+}
+_ts_decorate([
+    ApiProperty(),
+    IsUUID(),
+    _ts_metadata("design:type", String)
+], RemoveBoardMemberDto.prototype, "boardId", void 0);
+_ts_decorate([
+    ApiProperty(),
+    IsUUID(),
+    _ts_metadata("design:type", String)
+], RemoveBoardMemberDto.prototype, "userId", void 0);
+export class GetBoardMembersDto {
+    constructor(){
+        _define_property(this, "boardId", void 0);
+    }
+}
+_ts_decorate([
+    ApiProperty(),
+    IsUUID(),
+    _ts_metadata("design:type", String)
+], GetBoardMembersDto.prototype, "boardId", void 0);
+export class TaskBoardResponseDto extends IdentityResponseDto {
+    constructor(...args){
+        super(...args), _define_property(this, "name", void 0), _define_property(this, "description", void 0), _define_property(this, "color", void 0), _define_property(this, "isActive", void 0), _define_property(this, "settings", void 0), _define_property(this, "companyId", void 0), _define_property(this, "totalMembers", void 0), _define_property(this, "totalLists", void 0), _define_property(this, "totalTasks", void 0);
+    }
+}
+_ts_decorate([
+    Expose(),
+    ApiProperty({
+        type: String,
+        description: 'Board name',
+        maxLength: 255
+    }),
+    _ts_metadata("design:type", String)
+], TaskBoardResponseDto.prototype, "name", void 0);
+_ts_decorate([
+    Expose(),
+    ApiPropertyOptional({
+        type: String,
+        description: 'Board description',
+        nullable: true
+    }),
+    _ts_metadata("design:type", Object)
+], TaskBoardResponseDto.prototype, "description", void 0);
+_ts_decorate([
+    Expose(),
+    ApiProperty({
+        type: String,
+        description: 'Board color hex',
+        example: '#3B82F6'
+    }),
+    _ts_metadata("design:type", String)
+], TaskBoardResponseDto.prototype, "color", void 0);
+_ts_decorate([
+    Expose(),
+    ApiProperty({
+        type: Boolean,
+        description: 'Whether the board is active'
+    }),
+    _ts_metadata("design:type", Boolean)
+], TaskBoardResponseDto.prototype, "isActive", void 0);
+_ts_decorate([
+    Expose(),
+    ApiPropertyOptional({
+        type: Object,
+        description: 'Board settings JSON',
+        nullable: true
+    }),
+    _ts_metadata("design:type", Object)
+], TaskBoardResponseDto.prototype, "settings", void 0);
+_ts_decorate([
+    Expose(),
+    ApiPropertyOptional({
+        type: String,
+        format: 'uuid',
+        description: 'Company ID',
+        nullable: true
+    }),
+    _ts_metadata("design:type", Object)
+], TaskBoardResponseDto.prototype, "companyId", void 0);
+_ts_decorate([
+    Expose(),
+    ApiPropertyOptional({
+        type: Number,
+        description: 'Total number of board members'
+    }),
+    _ts_metadata("design:type", Number)
+], TaskBoardResponseDto.prototype, "totalMembers", void 0);
+_ts_decorate([
+    Expose(),
+    ApiPropertyOptional({
+        type: Number,
+        description: 'Total number of task lists'
+    }),
+    _ts_metadata("design:type", Number)
+], TaskBoardResponseDto.prototype, "totalLists", void 0);
+_ts_decorate([
+    Expose(),
+    ApiPropertyOptional({
+        type: Number,
+        description: 'Total number of tasks'
+    }),
+    _ts_metadata("design:type", Number)
+], TaskBoardResponseDto.prototype, "totalTasks", void 0);
+export class TaskBoardMemberResponseDto extends IdentityResponseDto {
+    constructor(...args){
+        super(...args), _define_property(this, "boardId", void 0), _define_property(this, "userId", void 0), _define_property(this, "role", void 0), _define_property(this, "userName", void 0), _define_property(this, "userEmail", void 0);
+    }
+}
+_ts_decorate([
+    Expose(),
+    ApiProperty({
+        type: String,
+        format: 'uuid',
+        description: 'Board ID'
+    }),
+    _ts_metadata("design:type", String)
+], TaskBoardMemberResponseDto.prototype, "boardId", void 0);
+_ts_decorate([
+    Expose(),
+    ApiProperty({
+        type: String,
+        format: 'uuid',
+        description: 'User ID'
+    }),
+    _ts_metadata("design:type", String)
+], TaskBoardMemberResponseDto.prototype, "userId", void 0);
+_ts_decorate([
+    Expose(),
+    ApiProperty({
+        enum: BoardMemberRole,
+        description: 'Member role on the board'
+    }),
+    _ts_metadata("design:type", typeof BoardMemberRole === "undefined" ? Object : BoardMemberRole)
+], TaskBoardMemberResponseDto.prototype, "role", void 0);
+_ts_decorate([
+    Expose(),
+    ApiPropertyOptional({
+        type: String,
+        description: 'User display name',
+        nullable: true
+    }),
+    _ts_metadata("design:type", Object)
+], TaskBoardMemberResponseDto.prototype, "userName", void 0);
+_ts_decorate([
+    Expose(),
+    ApiPropertyOptional({
+        type: String,
+        description: 'User email',
+        nullable: true
+    }),
+    _ts_metadata("design:type", Object)
+], TaskBoardMemberResponseDto.prototype, "userEmail", void 0);

package/fesm/dtos/task-comment.dto.js

@@ -0,0 +1,110 @@
+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);
+}
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { Expose } from 'class-transformer';
+import { IsNotEmpty, IsOptional, IsString, IsUUID } from 'class-validator';
+import { IdentityResponseDto } from '@flusys/nestjs-shared/dtos';
+export class CreateTaskCommentDto {
+    constructor(){
+        _define_property(this, "taskId", void 0);
+        _define_property(this, "content", void 0);
+        _define_property(this, "parentCommentId", void 0);
+    }
+}
+_ts_decorate([
+    ApiProperty(),
+    IsUUID(),
+    _ts_metadata("design:type", String)
+], CreateTaskCommentDto.prototype, "taskId", void 0);
+_ts_decorate([
+    ApiProperty(),
+    IsNotEmpty(),
+    IsString(),
+    _ts_metadata("design:type", String)
+], CreateTaskCommentDto.prototype, "content", void 0);
+_ts_decorate([
+    ApiPropertyOptional({
+        description: 'Reply to comment ID'
+    }),
+    IsOptional(),
+    IsUUID(),
+    _ts_metadata("design:type", Object)
+], CreateTaskCommentDto.prototype, "parentCommentId", void 0);
+export class UpdateTaskCommentDto {
+    constructor(){
+        _define_property(this, "id", void 0);
+        _define_property(this, "content", void 0);
+    }
+}
+_ts_decorate([
+    ApiProperty(),
+    IsUUID(),
+    _ts_metadata("design:type", String)
+], UpdateTaskCommentDto.prototype, "id", void 0);
+_ts_decorate([
+    ApiProperty(),
+    IsNotEmpty(),
+    IsString(),
+    _ts_metadata("design:type", String)
+], UpdateTaskCommentDto.prototype, "content", void 0);
+export class TaskCommentResponseDto extends IdentityResponseDto {
+    constructor(...args){
+        super(...args), _define_property(this, "taskId", void 0), _define_property(this, "userId", void 0), _define_property(this, "content", void 0), _define_property(this, "parentCommentId", void 0);
+    }
+}
+_ts_decorate([
+    Expose(),
+    ApiProperty({
+        type: String,
+        format: 'uuid',
+        description: 'Task ID'
+    }),
+    _ts_metadata("design:type", String)
+], TaskCommentResponseDto.prototype, "taskId", void 0);
+_ts_decorate([
+    Expose(),
+    ApiProperty({
+        type: String,
+        format: 'uuid',
+        description: 'Author user ID'
+    }),
+    _ts_metadata("design:type", String)
+], TaskCommentResponseDto.prototype, "userId", void 0);
+_ts_decorate([
+    Expose(),
+    ApiProperty({
+        type: String,
+        description: 'Comment content'
+    }),
+    _ts_metadata("design:type", String)
+], TaskCommentResponseDto.prototype, "content", void 0);
+_ts_decorate([
+    Expose(),
+    ApiPropertyOptional({
+        type: String,
+        format: 'uuid',
+        description: 'Parent comment ID for replies',
+        nullable: true
+    }),
+    _ts_metadata("design:type", Object)
+], TaskCommentResponseDto.prototype, "parentCommentId", void 0);