/** * Pool configuration stays unit-tested here so connection ceilings and wait * timeouts cannot silently fall back to separate library defaults. */ import { afterEach, beforeEach, describe, expect, it } from "vitest"; import { buildSessionOptions, getConnectionBudget, getPgBossPoolMax, getPoolConnectionTimeoutMs, getPrismaPoolMax, getStatementTimeoutMs, } from "../db"; describe("per-process database connection budget", () => { const originalDatabaseUrl = process.env.DATABASE_URL; const originalConnectionLimit = process.env.DB_CONNECTION_LIMIT; const originalPoolTimeout = process.env.DB_POOL_TIMEOUT; const originalLegacyPoolMax = process.env.DATABASE_POOL_MAX; beforeEach(() => { process.env.DATABASE_URL = "postgresql://healthlog:test@db:5432/healthlog?connection_limit=20&pool_timeout=20"; delete process.env.DB_CONNECTION_LIMIT; delete process.env.DB_POOL_TIMEOUT; delete process.env.DATABASE_POOL_MAX; }); afterEach(() => { const restore = (name: string, value: string | undefined) => { if (value === undefined) delete process.env[name]; else process.env[name] = value; }; restore("DATABASE_URL", originalDatabaseUrl); restore("DB_CONNECTION_LIMIT", originalConnectionLimit); restore("DB_POOL_TIMEOUT", originalPoolTimeout); restore("DATABASE_POOL_MAX", originalLegacyPoolMax); }); it("splits the URL connection_limit across Prisma and pg-boss", () => { expect(getConnectionBudget()).toBe(20); expect(getPrismaPoolMax()).toBe(18); expect(getPgBossPoolMax()).toBe(2); expect(getPrismaPoolMax() + getPgBossPoolMax()).toBe(getConnectionBudget()); }); it("uses the existing pool_timeout seconds for both pool constructors", () => { expect(getPoolConnectionTimeoutMs()).toBe(20_000); }); it("prefers explicit DB_CONNECTION_LIMIT and DB_POOL_TIMEOUT values", () => { process.env.DB_CONNECTION_LIMIT = "12"; process.env.DB_POOL_TIMEOUT = "7"; expect(getConnectionBudget()).toBe(12); expect(getPrismaPoolMax()).toBe(10); expect(getPgBossPoolMax()).toBe(2); expect(getPoolConnectionTimeoutMs()).toBe(7_000); }); it("keeps DATABASE_POOL_MAX as a backward-compatible explicit override", () => { process.env.DATABASE_POOL_MAX = "30"; expect(getConnectionBudget()).toBe(30); expect(getPrismaPoolMax()).toBe(28); }); }); // A-1 — a per-session statement timeout so a single stuck query can't hold a // pool slot forever and starve every DB-backed route. describe("getStatementTimeoutMs", () => { const originalEnv = process.env.DATABASE_STATEMENT_TIMEOUT_MS; beforeEach(() => { delete process.env.DATABASE_STATEMENT_TIMEOUT_MS; }); afterEach(() => { if (originalEnv === undefined) { delete process.env.DATABASE_STATEMENT_TIMEOUT_MS; } else { process.env.DATABASE_STATEMENT_TIMEOUT_MS = originalEnv; } }); it("defaults to 60000ms when the env var is unset", () => { expect(getStatementTimeoutMs()).toBe(60_000); }); it("honours a positive override", () => { process.env.DATABASE_STATEMENT_TIMEOUT_MS = "30000"; expect(getStatementTimeoutMs()).toBe(30_000); }); it("allows 0 to disable the timeout (legacy unbounded behaviour)", () => { process.env.DATABASE_STATEMENT_TIMEOUT_MS = "0"; expect(getStatementTimeoutMs()).toBe(0); }); it("falls back to the default on a malformed or negative value", () => { process.env.DATABASE_STATEMENT_TIMEOUT_MS = "not-a-number"; expect(getStatementTimeoutMs()).toBe(60_000); process.env.DATABASE_STATEMENT_TIMEOUT_MS = "-5"; expect(getStatementTimeoutMs()).toBe(60_000); }); }); describe("buildSessionOptions", () => { const originalEnv = process.env.DATABASE_STATEMENT_TIMEOUT_MS; afterEach(() => { if (originalEnv === undefined) { delete process.env.DATABASE_STATEMENT_TIMEOUT_MS; } else { process.env.DATABASE_STATEMENT_TIMEOUT_MS = originalEnv; } }); it("emits both session timeouts as libpq startup options by default", () => { delete process.env.DATABASE_STATEMENT_TIMEOUT_MS; const opts = buildSessionOptions(); expect(opts).toContain("-c statement_timeout=60000"); expect(opts).toContain("-c idle_in_transaction_session_timeout=60000"); }); it("returns undefined (no options) when the timeout is disabled", () => { process.env.DATABASE_STATEMENT_TIMEOUT_MS = "0"; expect(buildSessionOptions()).toBeUndefined(); }); });