@accounter/server/src/environment.test.ts

Accounter GraphQL server

import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';

/**
 * `environment.ts` reads `process.env` at import time, so each case needs a
 * fresh module registry. dotenv does not override variables already present in
 * `process.env`, so the values set here win over any local `.env`.
 */
async function loadEnv(overrides: Record<string, string>) {
  vi.resetModules();
  for (const [key, value] of Object.entries(overrides)) {
    process.env[key] = value;
  }
  const { env } = await import('./environment.js');
  return env;
}

const REQUIRED = {
  POSTGRES_HOST: 'localhost',
  POSTGRES_PORT: '5432',
  POSTGRES_DB: 'test',
  POSTGRES_USER: 'test',
  POSTGRES_PASSWORD: 'test',
  CREDENTIALS_ENCRYPTION_KEY: 'a'.repeat(64),
};

const MANAGED_KEYS = [
  'POSTGRES_WATCHDOG_INTERVAL_MS',
  'POSTGRES_CLIENT_MAX_IDLE_MS',
  'POSTGRES_MONITOR_INTERVAL_MS',
  'POSTGRES_CONNECTION_TIMEOUT_MS',
];

describe('postgres pool configuration', () => {
  let original: Record<string, string | undefined>;

  beforeEach(() => {
    original = Object.fromEntries(
      [...MANAGED_KEYS, ...Object.keys(REQUIRED)].map(key => [key, process.env[key]]),
    );
    for (const key of MANAGED_KEYS) {
      delete process.env[key];
    }
  });

  afterEach(() => {
    for (const [key, value] of Object.entries(original)) {
      if (value === undefined) {
        delete process.env[key];
      } else {
        process.env[key] = value;
      }
    }
    vi.resetModules();
  });

  it('derives the watchdog interval when not configured', async () => {
    const env = await loadEnv(REQUIRED);

    expect(env.postgres.clientMaxIdleMs).toBe(300_000);
    expect(env.postgres.watchdogIntervalMs).toBe(30_000);
  });

  it('honours an explicit watchdog interval', async () => {
    const env = await loadEnv({ ...REQUIRED, POSTGRES_WATCHDOG_INTERVAL_MS: '5000' });

    expect(env.postgres.watchdogIntervalMs).toBe(5000);
  });

  it('keeps the derived sweep interval in step with a tightened idle ceiling', async () => {
    const env = await loadEnv({ ...REQUIRED, POSTGRES_CLIENT_MAX_IDLE_MS: '9000' });

    // Sweeping every 30s would let a leak sit for far longer than the ceiling.
    expect(env.postgres.watchdogIntervalMs).toBe(9000);
  });

  it('accepts 0 for the monitor interval, which disables the heartbeat', async () => {
    const env = await loadEnv({ ...REQUIRED, POSTGRES_MONITOR_INTERVAL_MS: '0' });

    expect(env.postgres.monitorIntervalMs).toBe(0);
  });

  it('rejects 0 for the connection timeout, keeping "wait forever" unreachable', async () => {
    // pg treats 0 as "queue indefinitely" — the behaviour that turns an
    // exhausted pool into a silent, permanent wedge.
    await expect(
      loadEnv({ ...REQUIRED, POSTGRES_CONNECTION_TIMEOUT_MS: '0' }),
    ).rejects.toBeDefined();
  });
});