add-test

When the user asks to add tests for a resource, follow this sequence. Ask for the resource name if not provided.

Variables

• <Name> = PascalCase singular (e.g. Note)
• <name> = camelCase singular (e.g. note)
• <names> = camelCase plural (e.g. notes)

---

Unit Tests (tests/unit/services/<name>.service.test.ts)

Unit tests cover the service layer in isolation. The repository is fully mocked.

Structure:

import { describe, it, expect, vi, beforeEach } from 'vitest';
import { <Name>Service } from '../../../src/services/<name>.service';
import type { I<Name>Repository } from '../../../src/repository/<name>.repository';
import { NotFoundError, ConflictError } from '../../../src/errors';

const mockRepository: I<Name>Repository = {
    create: vi.fn(),
    findById: vi.fn(),
    findAll: vi.fn(),
    update: vi.fn(),
    delete: vi.fn(),
    count: vi.fn(),
};

describe('<Name>Service', () => {
    let service: <Name>Service;

    beforeEach(() => {
        vi.clearAllMocks();
        service = new <Name>Service(mockRepository);
    });

    describe('create', () => {
        it('creates and returns a DTO', async () => {
            vi.mocked(mockRepository.create).mockResolvedValue({ id: '1', /* fields */ } as any);
            const result = await service.create({ /* input */ });
            expect(result).toMatchObject({ id: '1' });
        });

        it('throws ConflictError when item already exists', async () => {
            vi.mocked(mockRepository.create).mockRejectedValue(new ConflictError('<Name> already exists'));
            await expect(service.create({ /* input */ })).rejects.toThrow(ConflictError);
        });
    });

    describe('findById', () => {
        it('returns DTO when found', async () => {
            vi.mocked(mockRepository.findById).mockResolvedValue({ id: '1' } as any);
            const result = await service.findById('1');
            expect(result.id).toBe('1');
        });

        it('throws NotFoundError when not found', async () => {
            vi.mocked(mockRepository.findById).mockResolvedValue(null);
            await expect(service.findById('missing')).rejects.toThrow(NotFoundError);
        });
    });

    // Add describe blocks for: update, delete, list, and any resource-specific methods
});