chore: expose min and idleTimeoutMillis pg options

Author: slowbackspace

CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Changed
+
+- Replaced `idle_session_timeout` (server-side Postgres setting) with `idleTimeoutMillis` (client-side pg-pool setting) for idle connection cleanup. Set via `dbSync.idleTimeoutMs` in config or `BLOCKFROST_CONFIG_DBSYNC_IDLE_TIMEOUT_MS` env var (value in milliseconds). Disabled by default (pg-pool falls back to its own 10,000ms default). The previous `dbSync.idleSessionTimeoutMs` / `BLOCKFROST_CONFIG_DBSYNC_IDLE_SESSION_TIMEOUT_MS` options are removed.
+- Exposed `min` pool size option. Set via `dbSync.minConnections` in config or `BLOCKFROST_CONFIG_DBSYNC_MIN_CONN` env var. Disabled by default (pg-pool defaults to 0).
+
 ## [6.3.4] - 2026-03-17
 
 ### Added

src/app.ts

@@ -118,8 +118,11 @@ const start = (options = {}): FastifyInstance => {
     application_name: config.dbSync.applicationName,
     statement_timeout: config.dbSync.statementTimeout,
     connectionTimeoutMillis: config.dbSync.connectionTimeoutMs,
-    ...(config.dbSync.idleSessionTimeoutMs !== undefined && {
-      options: `-c idle_session_timeout=${config.dbSync.idleSessionTimeoutMs}`,
+    ...(config.dbSync.idleTimeoutMs !== undefined && {
+      idleTimeoutMillis: config.dbSync.idleTimeoutMs,
+    }),
+    ...(config.dbSync.minConnections !== undefined && {
+      min: config.dbSync.minConnections,
     }),
   });
 

src/config.ts

@@ -83,11 +83,15 @@ export const loadConfig = () => {
     : config.has('dbSync.connectionTimeoutMs')
       ? config.get<number>('dbSync.connectionTimeoutMs')
       : undefined;
-  const databaseSyncIdleSessionTimeoutMs = process.env
-    .BLOCKFROST_CONFIG_DBSYNC_IDLE_SESSION_TIMEOUT_MS
-    ? Number(process.env.BLOCKFROST_CONFIG_DBSYNC_IDLE_SESSION_TIMEOUT_MS)
-    : config.has('dbSync.idleSessionTimeoutMs')
-      ? config.get<number>('dbSync.idleSessionTimeoutMs')
+  const databaseSyncIdleTimeoutMs = process.env.BLOCKFROST_CONFIG_DBSYNC_IDLE_TIMEOUT_MS
+    ? Number(process.env.BLOCKFROST_CONFIG_DBSYNC_IDLE_TIMEOUT_MS)
+    : config.has('dbSync.idleTimeoutMs')
+      ? config.get<number>('dbSync.idleTimeoutMs')
+      : undefined;
+  const databaseSyncMinConnections = process.env.BLOCKFROST_CONFIG_DBSYNC_MIN_CONN
+    ? Number(process.env.BLOCKFROST_CONFIG_DBSYNC_MIN_CONN)
+    : config.has('dbSync.minConnections')
+      ? config.get<number>('dbSync.minConnections')
       : undefined;
   const ssl = config.has('dbSync.ssl') ? { rejectUnauthorized: false } : false;
   const databaseSyncApplicationName =
@@ -174,7 +178,8 @@ export const loadConfig = () => {
       maxConnections: databaseSyncMaxConnections,
       statementTimeout: databaseSyncStatementTimeout,
       connectionTimeoutMs: databaseSyncConnectionTimeoutMs,
-      idleSessionTimeoutMs: databaseSyncIdleSessionTimeoutMs,
+      idleTimeoutMs: databaseSyncIdleTimeoutMs,
+      minConnections: databaseSyncMinConnections,
       ssl,
       applicationName: databaseSyncApplicationName,
     },