import { beforeEach, describe, expect, it, vi } from "vitest"; const mocks = vi.hoisted(() => ({ db: { kwpProjectCatalogState: { findUnique: vi.fn(), upsert: vi.fn(), update: vi.fn(), updateMany: vi.fn(), }, kwpProjectCatalogItem: { findMany: vi.fn(), createMany: vi.fn(), upsert: vi.fn(), update: vi.fn(), updateMany: vi.fn(), count: vi.fn(), }, $transaction: vi.fn(), }, resource: { listProjectNumbers: vi.fn(), searchProjects: vi.fn(), }, searchProjects: vi.fn(), })); vi.mock("@hivegrid/db/client.server", () => ({ getDbClient: () => mocks.db, })); vi.mock("@hivegrid/db/rls-context.server", () => ({ getRlsExecutionContext: () => ({ tenantId: "tenant_1" }), })); vi.mock("./resource-client.server.js", () => ({ runKwpResourceSession: (_input: unknown, operation: (resource: typeof mocks.resource) => Promise) => operation(mocks.resource), searchProjects: mocks.searchProjects, })); import { KwpError } from "./client.js"; import { searchAndCacheKwpProjects, searchKwpProjectCatalog, syncKwpProjectCatalog, } from "./project-catalog.server.js"; const RESULT = { externalProjectNumber: "P-100", name: "Heizung Schule", projectAddressCode: "ADR-1", invoiceAddressCode: null, clientAddressCode: null, status: 8 as const, statusLabel: "Erhalten", }; beforeEach(() => { vi.clearAllMocks(); mocks.db.$transaction.mockImplementation((operation: (tx: typeof mocks.db) => Promise) => operation(mocks.db)); mocks.db.kwpProjectCatalogItem.upsert.mockResolvedValue({}); mocks.db.kwpProjectCatalogState.update.mockResolvedValue({}); mocks.db.kwpProjectCatalogState.updateMany.mockResolvedValue({ count: 1 }); }); describe("KWP project catalog", () => { it("searches the normalized local cache and maps stable KWP status labels", async () => { mocks.db.kwpProjectCatalogItem.findMany.mockResolvedValue([{ externalProjectNumber: "P-100", name: "Heizung Schule", projectAddressCode: "ADR-1", invoiceAddressCode: null, clientAddressCode: null, status: 8, }]); await expect(searchKwpProjectCatalog({ connectionId: "connection_1", query: " Heizung ", })).resolves.toEqual([RESULT]); expect(mocks.db.kwpProjectCatalogItem.findMany).toHaveBeenCalledWith(expect.objectContaining({ where: expect.objectContaining({ tenantId: "tenant_1", dataConnectionId: "connection_1", searchText: { contains: "heizung" }, }), take: 50, })); }); it("returns cached results during a transient provider outage", async () => { mocks.db.kwpProjectCatalogItem.findMany.mockResolvedValue([{ externalProjectNumber: RESULT.externalProjectNumber, name: RESULT.name, projectAddressCode: RESULT.projectAddressCode, invoiceAddressCode: RESULT.invoiceAddressCode, clientAddressCode: RESULT.clientAddressCode, status: RESULT.status, }]); mocks.searchProjects.mockRejectedValue(new KwpError("provider_outage", 503)); await expect(searchAndCacheKwpProjects({ connectionId: "connection_1", query: "Heizung", })).resolves.toEqual([RESULT]); }); it("discovers and hydrates a bounded batch without provider I/O inside a database transaction", async () => { const now = new Date("2026-07-24T12:00:00.000Z"); mocks.db.kwpProjectCatalogState.upsert.mockResolvedValue({ discoveredCount: 0, nextDiscoveryAt: now, }); mocks.resource.listProjectNumbers.mockResolvedValue(["P-100", "P-200"]); mocks.db.kwpProjectCatalogItem.createMany.mockResolvedValue({ count: 2 }); mocks.db.kwpProjectCatalogItem.findMany.mockResolvedValue([ { externalProjectNumber: "P-100" }, { externalProjectNumber: "P-200" }, ]); mocks.resource.searchProjects.mockImplementation(async (query: string) => [{ ...RESULT, externalProjectNumber: query, name: `Projekt ${query}`, }]); mocks.db.kwpProjectCatalogItem.count .mockResolvedValueOnce(2) .mockResolvedValueOnce(0); await expect(syncKwpProjectCatalog({ connectionId: "connection_1", now, })).resolves.toEqual({ discoveredCount: 2, hydratedCount: 2, processed: 2, hasMore: false, status: "ready", }); expect(mocks.resource.listProjectNumbers).toHaveBeenCalledTimes(1); expect(mocks.resource.searchProjects).toHaveBeenCalledTimes(2); expect(mocks.db.kwpProjectCatalogItem.createMany).toHaveBeenCalledWith(expect.objectContaining({ skipDuplicates: true, data: expect.arrayContaining([ expect.objectContaining({ externalProjectNumber: "P-100", state: "discovered" }), ]), })); expect(mocks.db.$transaction).toHaveBeenCalledTimes(2); expect(mocks.db.$transaction.mock.invocationCallOrder.every((order) => mocks.resource.searchProjects.mock.invocationCallOrder.every((providerOrder) => providerOrder !== order))).toBe(true); }); });