gajus · gajus · Mar 12, 2026 · Mar 12, 2026
diff --git a/.changeset/humble-onions-send.md b/.changeset/humble-onions-send.md
diff --git a/packages/benchmark/CHANGELOG.md b/packages/benchmark/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @slonik/benchmark
 
+## 48.13.0
+
+### Patch Changes
+
+- Updated dependencies [[`c92d1df`](https://github.com/gajus/slonik/commit/c92d1df8e0e7fa3124dc69f32175a8b6df1b866d)]:
+  - slonik@48.13.0
+
 ## 48.12.3
 
 ### Patch Changes

diff --git a/packages/benchmark/package.json b/packages/benchmark/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@slonik/benchmark",
-  "version": "48.12.3",
+  "version": "48.13.0",
   "private": true,
   "scripts": {
     "benchmark": "NODE_ENV=production node benchmark.js"
@@ -10,6 +10,6 @@
     "pg": "^8.18.0",
     "pg-promise": "^11.15.0",
     "postgres": "^3.4.7",
-    "slonik": "^48.12.3"
+    "slonik": "^48.13.0"
   }
 }
diff --git a/packages/driver/CHANGELOG.md b/packages/driver/CHANGELOG.md
@@ -1,5 +1,28 @@
 # @slonik/driver
 
+## 48.13.0
+
+### Minor Changes
+
+- [#764](https://github.com/gajus/slonik/pull/764) [`c92d1df`](https://github.com/gajus/slonik/commit/c92d1df8e0e7fa3124dc69f32175a8b6df1b866d) Thanks [@gajus](https://github.com/gajus)! - Add `'DISABLE_TIMEOUT'` support for `idleTimeout` and `maximumConnectionAge`.
+
+  Previously, passing `idleTimeout: 'DISABLE_TIMEOUT'` was silently ignored — the sentinel string was accepted by the type but never propagated through `createPoolConfiguration`, so the idle timer always fired at the default 10s. Similarly, `maximumConnectionAge` only accepted a plain number with no way to opt out of age-based connection recycling.
+
+  **Changes:**
+
+  - `idleTimeout: 'DISABLE_TIMEOUT'` now correctly disables idle connection cleanup. Connections above `minimumPoolSize` are kept alive indefinitely until explicitly released or the pool is ended.
+  - `maximumConnectionAge` now accepts `'DISABLE_TIMEOUT'` to disable age-based recycling. Connections are no longer destroyed and replaced after the default 30-minute lifetime.
+  - Passing `0` for either field now emits a warning and clamps to `1ms` (matching the existing `idleTimeout=0` behaviour), rather than being silently ignored.
+  - `DriverConfiguration.maximumConnectionAge` in `@slonik/driver` is widened to `'DISABLE_TIMEOUT' | number` for consistency with the other timeout fields.
+
+  Internally, `'DISABLE_TIMEOUT'` is resolved to `Number.POSITIVE_INFINITY` at the `createPoolConfiguration` boundary so that `createConnectionPool` works with plain numeric comparisons throughout.
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @slonik/types@48.13.0
+  - @slonik/utilities@48.13.0
+
 ## 48.12.3
 
 ### Patch Changes

diff --git a/packages/driver/package.json b/packages/driver/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@slonik/driver",
-  "version": "48.12.3",
+  "version": "48.13.0",
   "description": "A Node.js PostgreSQL client with strict types, detailed logging and assertions.",
   "keywords": [
     "postgresql",
@@ -32,8 +32,8 @@
     "test": "ava --verbose --serial"
   },
   "dependencies": {
-    "@slonik/types": "^48.12.3",
-    "@slonik/utilities": "^48.12.3",
+    "@slonik/types": "^48.13.0",
+    "@slonik/utilities": "^48.13.0",
     "roarr": "^7.21.4",
     "serialize-error": "^12.0.0",
     "strict-event-emitter-types": "^2.0.0"

diff --git a/packages/errors/CHANGELOG.md b/packages/errors/CHANGELOG.md
@@ -1,5 +1,12 @@
 # @slonik/errors
 
+## 48.13.0
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @slonik/types@48.13.0
+
 ## 48.12.3
 
 ### Patch Changes

diff --git a/packages/errors/package.json b/packages/errors/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@slonik/errors",
-  "version": "48.12.3",
+  "version": "48.13.0",
   "description": "A Node.js PostgreSQL client with strict types, detailed logging and assertions.",
   "keywords": [
     "postgresql",
@@ -32,7 +32,7 @@
     "test": "ava --verbose --serial"
   },
   "dependencies": {
-    "@slonik/types": "^48.12.3"
+    "@slonik/types": "^48.13.0"
   },
   "devDependencies": {
     "@standard-schema/spec": "^1.0.0",

diff --git a/packages/pg-driver/CHANGELOG.md b/packages/pg-driver/CHANGELOG.md
@@ -1,5 +1,16 @@
 # @slonik/pg-driver
 
+## 48.13.0
+
+### Patch Changes
+
+- Updated dependencies [[`c92d1df`](https://github.com/gajus/slonik/commit/c92d1df8e0e7fa3124dc69f32175a8b6df1b866d)]:
+  - @slonik/driver@48.13.0
+  - @slonik/errors@48.13.0
+  - @slonik/sql-tag@48.13.0
+  - @slonik/types@48.13.0
+  - @slonik/utilities@48.13.0
+
 ## 48.12.3
 
 ### Patch Changes

diff --git a/packages/pg-driver/package.json b/packages/pg-driver/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@slonik/pg-driver",
-  "version": "48.12.3",
+  "version": "48.13.0",
   "description": "A Node.js PostgreSQL client with strict types, detailed logging and assertions.",
   "keywords": [
     "postgresql",
@@ -32,11 +32,11 @@
     "test": "ava --verbose --serial"
   },
   "dependencies": {
-    "@slonik/driver": "^48.12.3",
-    "@slonik/errors": "^48.12.3",
-    "@slonik/sql-tag": "^48.12.3",
-    "@slonik/types": "^48.12.3",
-    "@slonik/utilities": "^48.12.3",
+    "@slonik/driver": "^48.13.0",
+    "@slonik/errors": "^48.13.0",
+    "@slonik/sql-tag": "^48.13.0",
+    "@slonik/types": "^48.13.0",
+    "@slonik/utilities": "^48.13.0",
     "pg": "^8.18.0",
     "pg-query-stream": "^4.12.0",
     "pg-types": "^4.1.0",

diff --git a/packages/slonik-dataloaders/CHANGELOG.md b/packages/slonik-dataloaders/CHANGELOG.md
@@ -1,5 +1,7 @@
 # @slonik/dataloaders
 
+## 48.13.0
+
 ## 48.12.3
 
 ## 48.12.2

diff --git a/packages/slonik-dataloaders/package.json b/packages/slonik-dataloaders/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@slonik/dataloaders",
-  "version": "48.12.3",
+  "version": "48.13.0",
   "description": "Utilities for creating DataLoaders using Slonik.",
   "keywords": [
     "interceptor",
@@ -31,9 +31,9 @@
     "zod": "^4.3.6"
   },
   "devDependencies": {
-    "@slonik/types": "^48.12.3",
+    "@slonik/types": "^48.13.0",
     "@standard-schema/spec": "^1.0.0",
-    "slonik": "^48.12.3",
+    "slonik": "^48.13.0",
     "typescript": "^5.9.3",
     "vitest": "^4.0.18"
   },

diff --git a/packages/slonik-interceptor-field-name-transformation/CHANGELOG.md b/packages/slonik-interceptor-field-name-transformation/CHANGELOG.md
@@ -1,5 +1,7 @@
 # slonik-interceptor-field-name-transformation
 
+## 48.13.0
+
 ## 48.12.3
 
 ## 48.12.2

diff --git a/packages/slonik-interceptor-field-name-transformation/package.json b/packages/slonik-interceptor-field-name-transformation/package.json
@@ -1,6 +1,6 @@
 {
   "name": "slonik-interceptor-field-name-transformation",
-  "version": "48.12.3",
+  "version": "48.13.0",
   "description": "Transforms Slonik query result field names.",
   "keywords": [
     "format",
@@ -30,7 +30,7 @@
   },
   "devDependencies": {
     "ava": "^6.4.1",
-    "slonik": "^48.12.3",
+    "slonik": "^48.13.0",
     "tsimp": "^2.0.12",
     "typescript": "^5.9.3"
   },

diff --git a/packages/slonik-interceptor-query-cache/CHANGELOG.md b/packages/slonik-interceptor-query-cache/CHANGELOG.md
@@ -1,5 +1,7 @@
 # slonik-interceptor-query-cache
 
+## 48.13.0
+
 ## 48.12.3
 
 ## 48.12.2

diff --git a/packages/slonik-interceptor-query-cache/package.json b/packages/slonik-interceptor-query-cache/package.json
@@ -1,6 +1,6 @@
 {
   "name": "slonik-interceptor-query-cache",
-  "version": "48.12.3",
+  "version": "48.13.0",
   "description": "Logs Slonik queries.",
   "keywords": [
     "interceptor",
@@ -32,7 +32,7 @@
   },
   "devDependencies": {
     "ava": "^6.4.1",
-    "slonik": "^48.12.3",
+    "slonik": "^48.13.0",
     "tsimp": "^2.0.12",
     "typescript": "^5.9.3"
   },

diff --git a/packages/slonik-interceptor-query-logging/CHANGELOG.md b/packages/slonik-interceptor-query-logging/CHANGELOG.md
@@ -1,5 +1,7 @@
 # slonik-interceptor-query-logging
 
+## 48.13.0
+
 ## 48.12.3
 
 ## 48.12.2

diff --git a/packages/slonik-interceptor-query-logging/package.json b/packages/slonik-interceptor-query-logging/package.json
@@ -1,6 +1,6 @@
 {
   "name": "slonik-interceptor-query-logging",
-  "version": "48.12.3",
+  "version": "48.13.0",
   "description": "Logs Slonik queries.",
   "keywords": [
     "interceptor",
@@ -32,7 +32,7 @@
   },
   "devDependencies": {
     "ava": "^6.4.1",
-    "slonik": "^48.12.3",
+    "slonik": "^48.13.0",
     "tsimp": "^2.0.12",
     "typescript": "^5.9.3"
   },

diff --git a/packages/slonik-sql-tag-raw/CHANGELOG.md b/packages/slonik-sql-tag-raw/CHANGELOG.md
@@ -1,5 +1,12 @@
 # slonik-sql-tag-raw
 
+## 48.13.0
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @slonik/sql-tag@48.13.0
+
 ## 48.12.3
 
 ### Patch Changes

diff --git a/packages/slonik-sql-tag-raw/package.json b/packages/slonik-sql-tag-raw/package.json
@@ -1,6 +1,6 @@
 {
   "name": "slonik-sql-tag-raw",
-  "version": "48.12.3",
+  "version": "48.13.0",
   "description": "Logs Slonik queries.",
   "keywords": [
     "interceptor",
@@ -26,12 +26,12 @@
     "test": "ava --verbose --serial"
   },
   "dependencies": {
-    "@slonik/sql-tag": "^48.12.3",
+    "@slonik/sql-tag": "^48.13.0",
     "roarr": "^7.21.4"
   },
   "devDependencies": {
     "ava": "^6.4.1",
-    "slonik": "^48.12.3",
+    "slonik": "^48.13.0",
     "tsimp": "^2.0.12",
     "typescript": "^5.9.3"
   },

diff --git a/packages/slonik/CHANGELOG.md b/packages/slonik/CHANGELOG.md
@@ -1,5 +1,31 @@
 # slonik
 
+## 48.13.0
+
+### Minor Changes
+
+- [#764](https://github.com/gajus/slonik/pull/764) [`c92d1df`](https://github.com/gajus/slonik/commit/c92d1df8e0e7fa3124dc69f32175a8b6df1b866d) Thanks [@gajus](https://github.com/gajus)! - Add `'DISABLE_TIMEOUT'` support for `idleTimeout` and `maximumConnectionAge`.
+
+  Previously, passing `idleTimeout: 'DISABLE_TIMEOUT'` was silently ignored — the sentinel string was accepted by the type but never propagated through `createPoolConfiguration`, so the idle timer always fired at the default 10s. Similarly, `maximumConnectionAge` only accepted a plain number with no way to opt out of age-based connection recycling.
+
+  **Changes:**
+
+  - `idleTimeout: 'DISABLE_TIMEOUT'` now correctly disables idle connection cleanup. Connections above `minimumPoolSize` are kept alive indefinitely until explicitly released or the pool is ended.
+  - `maximumConnectionAge` now accepts `'DISABLE_TIMEOUT'` to disable age-based recycling. Connections are no longer destroyed and replaced after the default 30-minute lifetime.
+  - Passing `0` for either field now emits a warning and clamps to `1ms` (matching the existing `idleTimeout=0` behaviour), rather than being silently ignored.
+  - `DriverConfiguration.maximumConnectionAge` in `@slonik/driver` is widened to `'DISABLE_TIMEOUT' | number` for consistency with the other timeout fields.
+
+  Internally, `'DISABLE_TIMEOUT'` is resolved to `Number.POSITIVE_INFINITY` at the `createPoolConfiguration` boundary so that `createConnectionPool` works with plain numeric comparisons throughout.
+
+### Patch Changes
+
+- Updated dependencies [[`c92d1df`](https://github.com/gajus/slonik/commit/c92d1df8e0e7fa3124dc69f32175a8b6df1b866d)]:
+  - @slonik/driver@48.13.0
+  - @slonik/errors@48.13.0
+  - @slonik/pg-driver@48.13.0
+  - @slonik/sql-tag@48.13.0
+  - @slonik/utilities@48.13.0
+
 ## 48.12.3
 
 ### Patch Changes

diff --git a/packages/slonik/package.json b/packages/slonik/package.json
@@ -1,6 +1,6 @@
 {
   "name": "slonik",
-  "version": "48.12.3",
+  "version": "48.13.0",
   "description": "A Node.js PostgreSQL client with strict types, detailed logging and assertions.",
   "keywords": [
     "postgresql",
@@ -33,11 +33,11 @@
   },
   "dependencies": {
     "@opentelemetry/api": "^1.9.0",
-    "@slonik/driver": "^48.12.3",
-    "@slonik/errors": "^48.12.3",
-    "@slonik/pg-driver": "^48.12.3",
-    "@slonik/sql-tag": "^48.12.3",
-    "@slonik/utilities": "^48.12.3",
+    "@slonik/driver": "^48.13.0",
+    "@slonik/errors": "^48.13.0",
+    "@slonik/pg-driver": "^48.13.0",
+    "@slonik/sql-tag": "^48.13.0",
+    "@slonik/utilities": "^48.13.0",
     "@standard-schema/spec": "^1.0.0",
     "iso8601-duration": "^2.1.3",
     "p-limit": "^6.2.0",

diff --git a/packages/sql-tag/CHANGELOG.md b/packages/sql-tag/CHANGELOG.md
@@ -1,5 +1,13 @@
 # @slonik/sql-tag
 
+## 48.13.0
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @slonik/errors@48.13.0
+  - @slonik/types@48.13.0
+
 ## 48.12.3
 
 ### Patch Changes

diff --git a/packages/sql-tag/package.json b/packages/sql-tag/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@slonik/sql-tag",
-  "version": "48.12.3",
+  "version": "48.13.0",
   "description": "A Node.js PostgreSQL client with strict types, detailed logging and assertions.",
   "keywords": [
     "postgresql",
@@ -32,8 +32,8 @@
     "test": "ava --verbose --serial"
   },
   "dependencies": {
-    "@slonik/errors": "^48.12.3",
-    "@slonik/types": "^48.12.3",
+    "@slonik/errors": "^48.13.0",
+    "@slonik/types": "^48.13.0",
     "roarr": "^7.21.4",
     "safe-stable-stringify": "^2.5.0",
     "serialize-error": "^12.0.0",