Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/apps/hocuspocus/src/extensions/database.test.ts
T

126 lines
4.7 KiB
TypeScript

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<string, StubCollabRow>();
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<string, StubCollabRow> } {
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]);
});
});