pgsql-test 4.13.1 → 4.13.2

package/README.md

@@ -191,7 +191,19 @@ db.setContext({
 });
 ```
 
-This applies the settings using `SET LOCAL` statements, ensuring they persist only for the current transaction and maintain proper isolation between tests.
+This applies the settings using `SET LOCAL` and `set_config(..., true)` statements, ensuring they persist only for the current transaction and maintain proper isolation between tests.
+
+> **⚠️ Important:** `set_config(..., true)` is **transaction-local**. Inside test bodies (`it()` blocks), `beforeEach()` has already started a transaction, so context persists across queries automatically. However, in `beforeAll()` there is no active transaction — each query runs in auto-commit mode and context is lost between calls. If you need context-aware operations in `beforeAll()`, wrap them in explicit `db.begin()` / `db.commit()`:
+>
+> ```ts
+> beforeAll(async () => {
+>   ({ db, teardown } = await getConnections());
+>   await db.begin();
+>   db.setContext({ role: 'authenticated', 'jwt.claims.user_id': '123' });
+>   await db.query('SELECT current_user_id()'); // context persists within transaction
+>   await db.commit();
+> });
+> ```
 
 #### Testing Role-Based Access
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pgsql-test",
-  "version": "4.13.1",
+  "version": "4.13.2",
   "author": "Constructive <developers@constructive.io>",
   "description": "pgsql-test offers isolated, role-aware, and rollback-friendly PostgreSQL environments for integration tests — giving developers realistic test coverage without external state pollution",
   "main": "index.js",
@@ -71,5 +71,5 @@
     "pgsql-client": "^3.13.1",
     "pgsql-seed": "^2.13.1"
   },
-  "gitHead": "d43f1d7e38cc39a71b4f8d2cafb39f46df12e31a"
+  "gitHead": "ea590e1b9e1ee38c267f8dbbb37aa3f83a5d3fb7"
 }