Skip to content

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

10.2 KB
Raw Blame
import { beforeEach, describe, expect, it, vi } from 'vitest'

const mockFindOneBy = vi.fn()
const mockDelete = vi.fn()
const mockCount = vi.fn()
const mockSave = vi.fn()
const mockFind = vi.fn().mockResolvedValue([])
const mockInsert = vi.fn()
const mockUpdate = vi.fn()
const mockUpdateExecute = vi.fn().mockResolvedValue({ raw: [{ id: 'chunk-1' }] })
const mockUpdateWhere = vi.fn()
const mockRepoUpdate = vi.fn()
const updateBuilder = {
    setLock: () => updateBuilder,
    getOne: async () => ({ id: 'kb-file-1' }),
    update: () => updateBuilder,
    insert: () => updateBuilder,
    delete: () => updateBuilder,
    values: (rows: unknown) => { mockInsert(rows); return updateBuilder },
    orUpdate: () => updateBuilder,
    set: (values: unknown) => { mockUpdate(values); return updateBuilder },
    where: (_sql: string, params: unknown) => { mockUpdateWhere(params); return updateBuilder },
    andWhere: () => updateBuilder,
    returning: () => updateBuilder,
    execute: mockUpdateExecute,
}

vi.mock('../../../../src/app/core/db/repo-factory', () => ({
    repoFactory: vi.fn(() => () => ({
        findOneBy: mockFindOneBy,
        delete: mockDelete,
        count: mockCount,
        save: mockSave,
        find: mockFind,
        insert: mockInsert,
        createQueryBuilder: () => updateBuilder,
    })),
}))

const mockDbQuery = vi.fn().mockResolvedValue([])

const chunkRepo = {
    findOneBy: mockFindOneBy,
    delete: mockDelete,
    count: mockCount,
    save: mockSave,
    find: mockFind,
    insert: mockInsert,
    update: mockRepoUpdate,
    createQueryBuilder: () => updateBuilder,
}

vi.mock('../../../../src/app/database/database-connection', () => ({
    databaseConnection: vi.fn(() => ({
        query: mockDbQuery,
        transaction: (run: (entityManager: { getRepository: () => typeof chunkRepo }) => Promise<unknown>) =>
            run({ getRepository: () => chunkRepo }),
    })),
}))

const mockFileServiceDelete = vi.fn().mockResolvedValue(undefined)
const mockFileServiceGetDataOrThrow = vi.fn()

vi.mock('../../../../src/app/file/file.service', () => ({
    fileService: vi.fn(() => ({
        delete: mockFileServiceDelete,
        getDataOrThrow: mockFileServiceGetDataOrThrow,
    })),
}))

import { knowledgeBaseService } from '../../../../src/app/knowledge-base/knowledge-base.service'

const mockLog = {
    info: vi.fn(),
    debug: vi.fn(),
    error: vi.fn(),
    warn: vi.fn(),
    child: vi.fn(),
    fatal: vi.fn(),
    trace: vi.fn(),
    silent: vi.fn(),
    level: 'info',
} as any

describe('knowledgeBaseService', () => {
    beforeEach(() => {
        vi.clearAllMocks()
        mockDbQuery.mockResolvedValue([])
        mockFind.mockResolvedValue([])
    })

    describe('deleteFile', () => {
        it('should delete the KB file and the underlying file', async () => {
            const kbFile = { id: 'kb-1', projectId: 'proj-1', fileId: 'file-1', displayName: 'test.txt' }
            mockFindOneBy.mockResolvedValue(kbFile)
            mockDelete.mockResolvedValue({ affected: 1 })

            await knowledgeBaseService(mockLog).deleteFile({ projectId: 'proj-1', id: 'kb-1' })

            expect(mockFindOneBy).toHaveBeenCalledWith({ id: 'kb-1', projectId: 'proj-1' })
            expect(mockDelete).toHaveBeenCalledWith({ id: 'kb-1', projectId: 'proj-1' })
            expect(mockFileServiceDelete).toHaveBeenCalledWith({ projectId: 'proj-1', fileId: 'file-1' })
        })

        it('should not call delete when KB file does not exist', async () => {
            mockFindOneBy.mockResolvedValue(null)

            await knowledgeBaseService(mockLog).deleteFile({ projectId: 'proj-1', id: 'kb-missing' })

            expect(mockDelete).not.toHaveBeenCalled()
            expect(mockFileServiceDelete).not.toHaveBeenCalled()
        })
    })

    describe('getChunkCount', () => {
        it('should scope query by projectId and knowledgeBaseFileId', async () => {
            mockCount.mockResolvedValue(42)

            const result = await knowledgeBaseService(mockLog).getChunkCount({
                projectId: 'proj-1',
                knowledgeBaseFileId: 'kb-file-1',
            })

            expect(result).toBe(42)
            expect(mockCount).toHaveBeenCalledWith({
                where: { projectId: 'proj-1', knowledgeBaseFileId: 'kb-file-1' },
            })
        })
    })

    describe('search', () => {
        it('should clamp negative scores to zero', async () => {
            mockDbQuery.mockResolvedValue([
                { id: '1', content: 'close match', metadata: {}, chunkIndex: 0, distance: 0.3 },
                { id: '2', content: 'far match', metadata: {}, chunkIndex: 1, distance: 1.5 },
            ])

            const results = await knowledgeBaseService(mockLog).search({
                projectId: 'proj-1',
                knowledgeBaseFileIds: ['kb-file-1'],
                queryEmbedding: [0.1, 0.2, 0.3],
                limit: 5,
            })

            expect(results[0].score).toBe(0.7)
            expect(results[1].score).toBe(0)
        })

        it('should return exact score for normal distances', async () => {
            mockDbQuery.mockResolvedValue([
                { id: '1', content: 'match', metadata: {}, chunkIndex: 0, distance: 0 },
            ])

            const results = await knowledgeBaseService(mockLog).search({
                projectId: 'proj-1',
                knowledgeBaseFileIds: ['kb-file-1'],
                queryEmbedding: [0.1, 0.2],
                limit: 5,
            })

            expect(results[0].score).toBe(1)
        })

        it('should filter results below similarity threshold', async () => {
            mockDbQuery.mockResolvedValue([
                { id: '1', content: 'good match', metadata: {}, chunkIndex: 0, distance: 0.2 },
                { id: '2', content: 'bad match', metadata: {}, chunkIndex: 1, distance: 0.8 },
            ])

            const results = await knowledgeBaseService(mockLog).search({
                projectId: 'proj-1',
                knowledgeBaseFileIds: ['kb-file-1'],
                queryEmbedding: [0.1, 0.2],
                limit: 5,
                similarityThreshold: 0.5,
            })

            expect(results).toHaveLength(1)
            expect(results[0].score).toBe(0.8)
        })

        it('should return all results when no threshold is provided', async () => {
            mockDbQuery.mockResolvedValue([
                { id: '1', content: 'good', metadata: {}, chunkIndex: 0, distance: 0.2 },
                { id: '2', content: 'bad', metadata: {}, chunkIndex: 1, distance: 0.9 },
            ])

            const results = await knowledgeBaseService(mockLog).search({
                projectId: 'proj-1',
                knowledgeBaseFileIds: ['kb-file-1'],
                queryEmbedding: [0.1, 0.2],
                limit: 5,
            })

            expect(results).toHaveLength(2)
        })

        it('should include results when threshold is 0', async () => {
            mockDbQuery.mockResolvedValue([
                { id: '1', content: 'match', metadata: {}, chunkIndex: 0, distance: 0.5 },
            ])

            const results = await knowledgeBaseService(mockLog).search({
                projectId: 'proj-1',
                knowledgeBaseFileIds: ['kb-file-1'],
                queryEmbedding: [0.1, 0.2],
                limit: 5,
                similarityThreshold: 0,
            })

            expect(results).toHaveLength(1)
        })
    })

    describe('storeChunks', () => {
        it('should insert new chunks when no id is provided', async () => {
            await knowledgeBaseService(mockLog).storeChunks({
                projectId: 'proj-1',
                knowledgeBaseFileId: 'kb-file-1',
                chunks: [{
                    content: 'test content',
                    chunkIndex: 0,
                }],
            })

            expect(mockInsert).toHaveBeenCalledTimes(1)
            expect(mockUpdate).not.toHaveBeenCalled()
        })

        it('should update existing chunks when id is provided', async () => {
            mockFind.mockResolvedValue([{ id: 'chunk-1', chunkIndex: 3 }])

            await knowledgeBaseService(mockLog).storeChunks({
                projectId: 'proj-1',
                knowledgeBaseFileId: 'kb-file-1',
                chunks: [{
                    id: 'chunk-1',
                    embedding: [0.1, 0.2, 0.3],
                }],
            })

            expect(mockInsert).not.toHaveBeenCalled()
            expect(mockRepoUpdate).toHaveBeenCalledTimes(1)
            expect(mockRepoUpdate).toHaveBeenCalledWith(
                { id: 'chunk-1', projectId: 'proj-1', knowledgeBaseFileId: 'kb-file-1' },
                expect.objectContaining({ embedding: '[0.1,0.2,0.3]', chunkIndex: 3 }),
            )
        })

        it('should refuse an id that names no chunk of the file', async () => {
            mockFind.mockResolvedValue([])

            await expect(knowledgeBaseService(mockLog).storeChunks({
                projectId: 'proj-1',
                knowledgeBaseFileId: 'kb-file-1',
                chunks: [{ id: 'chunk-1', content: 'an edit' }],
            })).rejects.toThrow()

            expect(mockRepoUpdate).not.toHaveBeenCalled()
            expect(mockInsert).not.toHaveBeenCalled()
        })

        it('should handle mixed insert and update chunks', async () => {
            mockFind.mockResolvedValue([{ id: 'existing-1', chunkIndex: 5 }])

            await knowledgeBaseService(mockLog).storeChunks({
                projectId: 'proj-1',
                knowledgeBaseFileId: 'kb-file-1',
                chunks: [
                    { content: 'new chunk', chunkIndex: 0 },
                    { id: 'existing-1', embedding: [0.5] },
                ],
            })

            expect(mockInsert).toHaveBeenCalledTimes(1)
            expect(mockRepoUpdate).toHaveBeenCalledTimes(1)
        })

        it('should clear the file rather than insert or update when no chunks are given', async () => {
            await knowledgeBaseService(mockLog).storeChunks({
                projectId: 'proj-1',
                knowledgeBaseFileId: 'kb-file-1',
                chunks: [],
            })

            expect(mockInsert).not.toHaveBeenCalled()
            expect(mockUpdate).not.toHaveBeenCalled()
        })

    })
})