import { describe, expect, it, vi } from "vitest"; import { fetchCollabDoc, storeCollabDoc, type DatabaseExtensionDeps } from "./database.js"; type StubCollabRow = { tenantId: string; resourceType: string; resourceId: string; ydocState: Buffer; version: number; lastUpdatedAt: Date; }; function createStubDb() { const rows = new Map(); const findUnique = vi.fn(async ({ where }: { where: { tenantId_resourceType_resourceId: { tenantId: string; resourceType: string; resourceId: string } }; select?: unknown }) => { const { tenantId, resourceType, resourceId } = where.tenantId_resourceType_resourceId; const key = `${tenantId}:${resourceType}:${resourceId}`; const row = rows.get(key); return row ? { ydocState: row.ydocState } : null; }); type UpsertArgs = { where: { tenantId_resourceType_resourceId: { tenantId: string; resourceType: string; resourceId: string } }; create: StubCollabRow; update: { ydocState: Buffer; version: { increment: number }; lastUpdatedAt: Date }; }; const upsert = vi.fn(async ({ where, create, update }: UpsertArgs) => { const { tenantId, resourceType, resourceId } = where.tenantId_resourceType_resourceId; const key = `${tenantId}:${resourceType}:${resourceId}`; const existing = rows.get(key); if (existing) { existing.ydocState = update.ydocState; existing.version += update.version.increment; existing.lastUpdatedAt = update.lastUpdatedAt; return existing; } rows.set(key, { ...create }); return create; }); return { db: { collabDoc: { findUnique, upsert } }, rows, }; } function buildDeps(): { deps: DatabaseExtensionDeps; rows: Map } { const stub = createStubDb(); return { rows: stub.rows, deps: { db: stub.db as unknown as DatabaseExtensionDeps["db"], maxPayloadBytes: 1024, clock: () => new Date("2026-05-17T12:00:00Z"), }, }; } describe("fetchCollabDoc", () => { it("returns null when no row exists for the document", async () => { const { deps } = buildDeps(); const result = await fetchCollabDoc("t:kb-article:art_1", deps); expect(result).toBeNull(); }); it("returns null for malformed document names", async () => { const { deps } = buildDeps(); expect(await fetchCollabDoc("malformed", deps)).toBeNull(); }); it("returns a Uint8Array when the row exists", async () => { const { deps, rows } = buildDeps(); rows.set("t:kb-article:art_1", { tenantId: "t", resourceType: "kb-article", resourceId: "art_1", ydocState: Buffer.from([1, 2, 3, 4]), version: 7, lastUpdatedAt: new Date(), }); const result = await fetchCollabDoc("t:kb-article:art_1", deps); expect(result).toBeInstanceOf(Uint8Array); expect(Array.from(result ?? [])).toEqual([1, 2, 3, 4]); }); }); describe("storeCollabDoc", () => { it("inserts a new row on first store", async () => { const { deps, rows } = buildDeps(); await storeCollabDoc("t:kb-article:art_1", new Uint8Array([9, 9, 9]), deps); const row = rows.get("t:kb-article:art_1"); expect(row).toBeDefined(); expect(row?.version).toBe(1); expect(Array.from(row?.ydocState ?? new Uint8Array())).toEqual([9, 9, 9]); }); it("increments version on subsequent stores", async () => { const { deps, rows } = buildDeps(); await storeCollabDoc("t:kb-article:art_1", new Uint8Array([1]), deps); await storeCollabDoc("t:kb-article:art_1", new Uint8Array([2]), deps); await storeCollabDoc("t:kb-article:art_1", new Uint8Array([3]), deps); expect(rows.get("t:kb-article:art_1")?.version).toBe(3); expect(Array.from(rows.get("t:kb-article:art_1")?.ydocState ?? new Uint8Array())).toEqual([3]); }); it("refuses payloads exceeding maxPayloadBytes", async () => { const { deps } = buildDeps(); const large = new Uint8Array(2048); await expect(storeCollabDoc("t:kb:art_1", large, deps)).rejects.toThrow(/exceeds HOCUSPOCUS_MAX_PAYLOAD_BYTES/); }); it("is a no-op for malformed document names", async () => { const { deps, rows } = buildDeps(); await storeCollabDoc("malformed", new Uint8Array([1]), deps); expect(rows.size).toBe(0); }); it("isolates tenants — same resourceType/Id under different tenant gets its own row", async () => { const { deps, rows } = buildDeps(); await storeCollabDoc("tenant_a:kb:art_1", new Uint8Array([1]), deps); await storeCollabDoc("tenant_b:kb:art_1", new Uint8Array([2]), deps); expect(rows.size).toBe(2); expect(Array.from(rows.get("tenant_a:kb:art_1")?.ydocState ?? new Uint8Array())).toEqual([1]); expect(Array.from(rows.get("tenant_b:kb:art_1")?.ydocState ?? new Uint8Array())).toEqual([2]); }); });