import { readFileSync } from "node:fs"; import { fileURLToPath } from "node:url"; import path from "node:path"; import { afterEach, describe, expect, it } from "vitest"; import { __resetDbClientSingletonsForTests, createDbClient, getDbClient, getExtendedDbClient, getReadDbClient, getWriteDbClient, } from "./client.server.js"; const clientServerSourcePath = path.join(path.dirname(fileURLToPath(import.meta.url)), "./client.server.ts"); const clientServerSource = () => readFileSync(clientServerSourcePath, "utf8"); describe("@hivegrid/db server client boundary", () => { it("exports a createDbClient factory from the package-owned generated client", () => { expect(createDbClient).toEqual(expect.any(Function)); }); it("reuses a singleton across runtime environments", () => { const existingClient = {} as ReturnType; global.__db = existingClient; expect(getDbClient({ nodeEnv: "development" })).toBe(existingClient); expect(getDbClient({ nodeEnv: "production" })).toBe(existingClient); global.__db = undefined; }); it("keeps explicit client options isolated from the process singleton", () => { const existingClient = {} as ReturnType; global.__db = existingClient; expect(getDbClient({ connectionString: "postgresql://user:pass@example.test:5432/db" })).not.toBe(existingClient); global.__db = undefined; }); it("wires database error diagnostics through the structured logger while preserving custom callbacks", () => { const source = clientServerSource(); expect(source).toContain('import { createChildLogger, defaultLogger } from "@hivegrid/logger";'); expect(source).toContain('const dbLogger = createChildLogger(defaultLogger, { component: "db" });'); expect(source).toContain('dbLogger.error({ error: event }, "database error");'); expect(source).toContain("options.onError ?? logDatabaseError"); }); it("does not leave active console diagnostics in the server database client", () => { const source = clientServerSource(); const withoutLineComments = source.replaceAll(/\/\/.*$/gm, ""); expect(withoutLineComments).not.toMatch(/\bconsole\.(?:log|error|warn|info)\s*\(/); }); }); describe("R/W-split singletons", () => { const originalReadUrl = process.env.DATABASE_READ_URL; afterEach(() => { if (originalReadUrl === undefined) { delete process.env.DATABASE_READ_URL; } else { process.env.DATABASE_READ_URL = originalReadUrl; } __resetDbClientSingletonsForTests(); }); it("falls back to the write singleton when DATABASE_READ_URL is unset", () => { delete process.env.DATABASE_READ_URL; const existingWriter = {} as ReturnType; global.__db = existingWriter; global.__dbRead = undefined; const read = getReadDbClient(); const write = getWriteDbClient(); expect(read).toBe(existingWriter); expect(read).toBe(write); }); it("falls back to the write singleton when DATABASE_READ_URL is an empty string", () => { process.env.DATABASE_READ_URL = ""; const existingWriter = {} as ReturnType; global.__db = existingWriter; global.__dbRead = undefined; expect(getReadDbClient()).toBe(existingWriter); }); it("creates a distinct read client when DATABASE_READ_URL is set", () => { process.env.DATABASE_READ_URL = "postgresql://reader:pw@replica.test:5432/db"; const existingWriter = {} as ReturnType; global.__db = existingWriter; global.__dbRead = undefined; const read = getReadDbClient(); expect(read).not.toBe(existingWriter); expect(getReadDbClient()).toBe(read); // memoised }); it("exposes .read and .write accessors via $extends and lets default API flow to the write client", () => { delete process.env.DATABASE_READ_URL; const existingWriter = createDbClient({ connectionString: "postgresql://user:pass@primary.test:5432/db" }); global.__db = existingWriter; global.__dbRead = undefined; const extended = getExtendedDbClient(); expect(extended.write).toBe(existingWriter); expect(extended.read).toBe(existingWriter); // fallback semantics // Default API (e.g. extended.user) must still be present — $extends preserves it. expect(extended).toHaveProperty("user"); }); it("routes .read and .write to different underlying clients when a replica URL is configured", () => { process.env.DATABASE_READ_URL = "postgresql://reader:pw@replica.test:5432/db"; global.__db = undefined; global.__dbRead = undefined; const extended = getExtendedDbClient(); expect(extended.read).not.toBe(extended.write); }); });