knex 3.2.4 → 3.2.6

package/CHANGELOG.md

@@ -1,10 +1,22 @@
 # Master (Unreleased)
 
+# 3.2.6 - 24 March, 2026
+
+### Bug fixes
+
+- Fix module exports [#6406](https://github.com/knex/knex/issues/6406)
+
+# 3.2.5 - 23 March, 2026
+
+### Bug fixes
+
+- Fix ESM exports [#6405](https://github.com/knex/knex/issues/6405)
+
 # 3.2.4 - 23 March, 2026
 
 ### Bug fixes
 
-- Fix ESM type exports
+- Fix ESM type exports [#6404](https://github.com/knex/knex/issues/6404)
 
 # 3.2.1 - 22 March, 2026
 

package/README.md

@@ -37,6 +37,27 @@ For knex-based Object Relational Mapper, see:
 
 To see the SQL that Knex will generate for a given query, you can use [Knex Query Lab](https://michaelavila.com/knex-querylab/)
 
+## Local Development Setup
+
+### Prerequisites
+
+- Node.js 16+
+- Python 3.x with `setuptools` installed (required for building native dependencies like `better-sqlite3`)
+
+  Python 3.12+ removed the built-in `distutils` module. If you encounter a `ModuleNotFoundError: No module named 'distutils'` error during `npm install`, install `setuptools` for the Python version used by node-gyp:
+
+  ```bash
+  pip install setuptools
+  ```
+
+- **Windows only:** [Visual Studio Build Tools](https://visualstudio.microsoft.com/visual-cpp-build-tools/) with the "Desktop development with C++" workload
+
+### Install dependencies
+
+```bash
+npm install
+```
+
 ## Examples
 
 We have several examples [on the website](http://knexjs.org). Here is the first one to get you started:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "knex",
-  "version": "3.2.4",
+  "version": "3.2.6",
   "description": "A batteries-included SQL query & schema builder for PostgresSQL, MySQL, CockroachDB, MSSQL and SQLite3",
   "main": "knex.js",
   "types": "types/index.d.ts",
@@ -15,6 +15,10 @@
         "default": "./knex.js"
       }
     },
+    "./bin/*.js": "./bin/*.js",
+    "./bin/*": "./bin/*",
+    "./types/*.d.ts": "./types/*.d.ts",
+    "./types/*": "./types/*.d.ts",
     "./lib/*.js": "./lib/*.js",
     "./lib/*": "./lib/*.js",
     "./knex": "./knex.js",
@@ -36,7 +40,8 @@
     "coveralls": "nyc report --reporter=lcov",
     "lint": "eslint --cache .",
     "lint:fix": "eslint --cache --fix .",
-    "lint:types": "tsd",
+    "prelint:types": "cd test-tstyche && npm i",
+    "lint:types": "tsd && tstyche --target 5.4",
     "lint:everything": "npm run lint && npm run lint:types",
     "lint:fix:everything": "npm run lint:fix && npm run lint:types",
     "test:unit": "npm run test:unit-only && npm run test:cli",
@@ -170,7 +175,8 @@
     "toxiproxy-node-client": "^4.0.0",
     "ts-node": "^10.9.1",
     "tsd": "^0.28.1",
-    "typescript": "5.0.4"
+    "tstyche": "^6.2.0",
+    "typescript": "5.4.5"
   },
   "buildDependencies": [
     "rimraf"

package/types/index.d.mts

@@ -2,10 +2,13 @@
 // This file provides ESM type definitions that wrap the CJS types from index.d.ts
 // to match the exports defined in knex.mjs
 
-import type knexCjs from './index.d.ts';
+import type { Knex } from './index.d.ts';
 
-// Re-export the named export as defined in knex.mjs, without circular self-reference
-export const knex: Omit<typeof knexCjs, 'default' | 'knex'>;
+// Re-declare the knex factory function for ESM consumers.
+// This matches the call signature from the CJS types.
+declare function knex<TRecord extends {} = any, TResult = unknown[]>(
+  config: Knex.Config | string
+): Knex<TRecord, TResult>;
 
-// Re-export the default export as defined in knex.mjs: export default knex
+export { knex, Knex };
 export default knex;