feat(#5): Implement CRUD APIs for tasks, events, and projects
Implements comprehensive CRUD APIs following TDD principles with 92.44% test coverage (exceeds 85% requirement). Features: - Tasks API: Full CRUD with filtering, pagination, and subtask support - Events API: Full CRUD with recurrence support and date filtering - Projects API: Full CRUD with task/event association - Authentication guards on all endpoints - Workspace-scoped queries for multi-tenant isolation - Activity logging for all operations (CREATED, UPDATED, DELETED, etc.) - DTOs with class-validator validation - Comprehensive test suite (221 tests, 44 for new APIs) Implementation: - Services: Business logic with Prisma ORM integration - Controllers: RESTful endpoints with AuthGuard - Modules: Properly registered in AppModule - Documentation: Complete API reference in docs/4-api/4-crud-endpoints/ Test Coverage: - Tasks: 96.1% - Events: 89.83% - Projects: 84.21% - Overall: 92.44% TDD Workflow: 1. RED: Wrote failing tests first 2. GREEN: Implemented minimal code to pass tests 3. REFACTOR: Improved code quality while maintaining coverage Refs #5 Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
Jason Woltje
236
apps/api/src/events/events.service.spec.ts
Normal file
236
apps/api/src/events/events.service.spec.ts
Normal file
@@ -0,0 +1,236 @@
|
||||
import { describe, it, expect, beforeEach, vi } from "vitest";
|
||||
import { Test, TestingModule } from "@nestjs/testing";
|
||||
import { EventsService } from "./events.service";
|
||||
import { PrismaService } from "../prisma/prisma.service";
|
||||
import { ActivityService } from "../activity/activity.service";
|
||||
import { NotFoundException } from "@nestjs/common";
|
||||
|
||||
describe("EventsService", () => {
|
||||
let service: EventsService;
|
||||
let prisma: PrismaService;
|
||||
let activityService: ActivityService;
|
||||
|
||||
const mockPrismaService = {
|
||||
event: {
|
||||
create: vi.fn(),
|
||||
findMany: vi.fn(),
|
||||
count: vi.fn(),
|
||||
findUnique: vi.fn(),
|
||||
update: vi.fn(),
|
||||
delete: vi.fn(),
|
||||
},
|
||||
};
|
||||
|
||||
const mockActivityService = {
|
||||
logEventCreated: vi.fn(),
|
||||
logEventUpdated: vi.fn(),
|
||||
logEventDeleted: vi.fn(),
|
||||
};
|
||||
|
||||
const mockWorkspaceId = "550e8400-e29b-41d4-a716-446655440001";
|
||||
const mockUserId = "550e8400-e29b-41d4-a716-446655440002";
|
||||
const mockEventId = "550e8400-e29b-41d4-a716-446655440003";
|
||||
|
||||
const mockEvent = {
|
||||
id: mockEventId,
|
||||
workspaceId: mockWorkspaceId,
|
||||
title: "Test Event",
|
||||
description: "Test Description",
|
||||
startTime: new Date("2026-02-01T10:00:00Z"),
|
||||
endTime: new Date("2026-02-01T11:00:00Z"),
|
||||
allDay: false,
|
||||
location: "Conference Room A",
|
||||
recurrence: null,
|
||||
creatorId: mockUserId,
|
||||
projectId: null,
|
||||
metadata: {},
|
||||
createdAt: new Date(),
|
||||
updatedAt: new Date(),
|
||||
};
|
||||
|
||||
beforeEach(async () => {
|
||||
const module: TestingModule = await Test.createTestingModule({
|
||||
providers: [
|
||||
EventsService,
|
||||
{
|
||||
provide: PrismaService,
|
||||
useValue: mockPrismaService,
|
||||
},
|
||||
{
|
||||
provide: ActivityService,
|
||||
useValue: mockActivityService,
|
||||
},
|
||||
],
|
||||
}).compile();
|
||||
|
||||
service = module.get<EventsService>(EventsService);
|
||||
prisma = module.get<PrismaService>(PrismaService);
|
||||
activityService = module.get<ActivityService>(ActivityService);
|
||||
|
||||
vi.clearAllMocks();
|
||||
});
|
||||
|
||||
it("should be defined", () => {
|
||||
expect(service).toBeDefined();
|
||||
});
|
||||
|
||||
describe("create", () => {
|
||||
it("should create an event and log activity", async () => {
|
||||
const createDto = {
|
||||
title: "New Event",
|
||||
description: "Event description",
|
||||
startTime: new Date("2026-02-01T10:00:00Z"),
|
||||
allDay: false,
|
||||
};
|
||||
|
||||
mockPrismaService.event.create.mockResolvedValue(mockEvent);
|
||||
mockActivityService.logEventCreated.mockResolvedValue({});
|
||||
|
||||
const result = await service.create(mockWorkspaceId, mockUserId, createDto);
|
||||
|
||||
expect(result).toEqual(mockEvent);
|
||||
expect(prisma.event.create).toHaveBeenCalledWith({
|
||||
data: {
|
||||
...createDto,
|
||||
workspaceId: mockWorkspaceId,
|
||||
creatorId: mockUserId,
|
||||
allDay: false,
|
||||
metadata: {},
|
||||
},
|
||||
include: {
|
||||
creator: {
|
||||
select: { id: true, name: true, email: true },
|
||||
},
|
||||
project: {
|
||||
select: { id: true, name: true, color: true },
|
||||
},
|
||||
},
|
||||
});
|
||||
expect(activityService.logEventCreated).toHaveBeenCalledWith(
|
||||
mockWorkspaceId,
|
||||
mockUserId,
|
||||
mockEvent.id,
|
||||
{ title: mockEvent.title }
|
||||
);
|
||||
});
|
||||
});
|
||||
|
||||
describe("findAll", () => {
|
||||
it("should return paginated events with default pagination", async () => {
|
||||
const events = [mockEvent];
|
||||
mockPrismaService.event.findMany.mockResolvedValue(events);
|
||||
mockPrismaService.event.count.mockResolvedValue(1);
|
||||
|
||||
const result = await service.findAll({ workspaceId: mockWorkspaceId });
|
||||
|
||||
expect(result).toEqual({
|
||||
data: events,
|
||||
meta: {
|
||||
total: 1,
|
||||
page: 1,
|
||||
limit: 50,
|
||||
totalPages: 1,
|
||||
},
|
||||
});
|
||||
});
|
||||
|
||||
it("should filter by date range", async () => {
|
||||
const startFrom = new Date("2026-02-01");
|
||||
const startTo = new Date("2026-02-28");
|
||||
|
||||
mockPrismaService.event.findMany.mockResolvedValue([mockEvent]);
|
||||
mockPrismaService.event.count.mockResolvedValue(1);
|
||||
|
||||
await service.findAll({
|
||||
workspaceId: mockWorkspaceId,
|
||||
startFrom,
|
||||
startTo,
|
||||
});
|
||||
|
||||
expect(prisma.event.findMany).toHaveBeenCalledWith(
|
||||
expect.objectContaining({
|
||||
where: {
|
||||
workspaceId: mockWorkspaceId,
|
||||
startTime: {
|
||||
gte: startFrom,
|
||||
lte: startTo,
|
||||
},
|
||||
},
|
||||
})
|
||||
);
|
||||
});
|
||||
});
|
||||
|
||||
describe("findOne", () => {
|
||||
it("should return an event by id", async () => {
|
||||
mockPrismaService.event.findUnique.mockResolvedValue(mockEvent);
|
||||
|
||||
const result = await service.findOne(mockEventId, mockWorkspaceId);
|
||||
|
||||
expect(result).toEqual(mockEvent);
|
||||
});
|
||||
|
||||
it("should throw NotFoundException if event not found", async () => {
|
||||
mockPrismaService.event.findUnique.mockResolvedValue(null);
|
||||
|
||||
await expect(service.findOne(mockEventId, mockWorkspaceId)).rejects.toThrow(
|
||||
NotFoundException
|
||||
);
|
||||
});
|
||||
});
|
||||
|
||||
describe("update", () => {
|
||||
it("should update an event and log activity", async () => {
|
||||
const updateDto = {
|
||||
title: "Updated Event",
|
||||
location: "New Location",
|
||||
};
|
||||
|
||||
mockPrismaService.event.findUnique.mockResolvedValue(mockEvent);
|
||||
mockPrismaService.event.update.mockResolvedValue({
|
||||
...mockEvent,
|
||||
...updateDto,
|
||||
});
|
||||
mockActivityService.logEventUpdated.mockResolvedValue({});
|
||||
|
||||
const result = await service.update(
|
||||
mockEventId,
|
||||
mockWorkspaceId,
|
||||
mockUserId,
|
||||
updateDto
|
||||
);
|
||||
|
||||
expect(result.title).toBe("Updated Event");
|
||||
expect(activityService.logEventUpdated).toHaveBeenCalled();
|
||||
});
|
||||
|
||||
it("should throw NotFoundException if event not found", async () => {
|
||||
mockPrismaService.event.findUnique.mockResolvedValue(null);
|
||||
|
||||
await expect(
|
||||
service.update(mockEventId, mockWorkspaceId, mockUserId, { title: "Test" })
|
||||
).rejects.toThrow(NotFoundException);
|
||||
});
|
||||
});
|
||||
|
||||
describe("remove", () => {
|
||||
it("should delete an event and log activity", async () => {
|
||||
mockPrismaService.event.findUnique.mockResolvedValue(mockEvent);
|
||||
mockPrismaService.event.delete.mockResolvedValue(mockEvent);
|
||||
mockActivityService.logEventDeleted.mockResolvedValue({});
|
||||
|
||||
await service.remove(mockEventId, mockWorkspaceId, mockUserId);
|
||||
|
||||
expect(prisma.event.delete).toHaveBeenCalled();
|
||||
expect(activityService.logEventDeleted).toHaveBeenCalled();
|
||||
});
|
||||
|
||||
it("should throw NotFoundException if event not found", async () => {
|
||||
mockPrismaService.event.findUnique.mockResolvedValue(null);
|
||||
|
||||
await expect(
|
||||
service.remove(mockEventId, mockWorkspaceId, mockUserId)
|
||||
).rejects.toThrow(NotFoundException);
|
||||
});
|
||||
});
|
||||
});
|
||||
Reference in New Issue
Block a user