pg-promise 10.10.2 → 10.12.0

package/README.md

@@ -3,9 +3,6 @@ pg-promise
 
 PostgreSQL interface for Node.js
 
-[![Build Status](https://travis-ci.org/vitaly-t/pg-promise.svg?branch=master)](https://travis-ci.org/vitaly-t/pg-promise)
-[![Join the chat at https://gitter.im/vitaly-t/pg-promise](https://img.shields.io/gitter/room/vitaly-t/pg-promise.svg)](https://gitter.im/vitaly-t/pg-promise?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
-
 ---
 
 * [About](#about)
@@ -995,7 +992,8 @@ This library manages all database connections via the [connection pool], which i
 Connections in the cache expire due to inactivity after [idleTimeoutMillis] number of milliseconds, which you
 can set only when creating the [Database] object. 
 
-While there is a single open connection in the pool, the process cannot terminate by itself, only via `process.exit()`. 
+While there is a single open connection in the pool, the process cannot terminate by itself, only via `process.exit()`,
+unless `allowExitOnIdle` is used - see update section below.
 If you want the process to finish by itself, without waiting for all connections in the pool to expire, you need
 to force the pool to shut down all the connections it holds:
 
@@ -1031,7 +1029,11 @@ Once you have shut down the pool associated with your [Database] object, you can
 will be rejecting with [Error] = `Connection pool of the database object has been destroyed`.
 
 See the relevant API: [pgp.end], [Database.$pool]
- 
+
+### update
+
+Version 10.11.0 added support for connection option `allowExitOnIdle`, to let process exit when pool is idle.
+
 # History
 
 Although this project formally maintains a [CHANGELOG], for a short list of the top-level changes,

package/lib/connect.js

@@ -40,7 +40,12 @@ function poolConnect(ctx, db, config) {
                     // Make sure useCount drops to 1, if it ever reaches maximum integer number;
                     // We do not drop it to zero, to avoid rerun of initialization queries that
                     // usually check for useCount === 0;
-                    client.$useCount = client.$useCount >= Number.MAX_SAFE_INTEGER ? 1 : ++client.$useCount;
+                    // istanbul ignore if
+                    if (client.$useCount >= Number.MAX_SAFE_INTEGER) {
+                        client.$useCount = 1; // resetting; cannot auto-test this
+                    } else {
+                        client.$useCount = ++client.$useCount;
+                    }
                 } else {
                     Object.defineProperty(client, `$useCount`, {
                         value: 0,

package/lib/formatting.js

@@ -718,7 +718,8 @@ const $as = {
     /**
      * @method formatting.json
      * @description
-     * Converts any value into JSON, and returns it as a valid string, with single-quote symbols fixed, unless flag `raw` is set.
+     * Converts any value into JSON (includes `BigInt` support), and returns it as a valid string,
+     * with single-quote symbols fixed, unless flag `raw` is set.
      *
      * When formatting a query, a variable makes use of this method via modifier `:json`. See method {@link formatting.format format}.
      *

package/lib/query-file.js

@@ -229,49 +229,48 @@ class QueryFile extends InnerState {
      * Throw any error encountered.
      */
     prepare(throwErrors) {
-        const _i = this._inner, options = _i.options;
+        const i = this._inner, options = i.options;
         let lastMod;
-        if (options.debug && _i.ready) {
+        if (options.debug && i.ready) {
             try {
-                lastMod = npm.fs.statSync(_i.filePath).mtime.getTime();
-                if (lastMod === _i.modTime) {
-                    // istanbul ignore next;
-                    // coverage for this works differently under Windows and Linux
+                lastMod = npm.fs.statSync(i.filePath).mtime.getTime();
+                // istanbul ignore if;
+                if (lastMod === i.modTime) {
                     return;
                 }
-                _i.ready = false;
+                i.ready = false;
             } catch (e) {
-                _i.sql = undefined;
-                _i.ready = false;
-                _i.error = e;
+                i.sql = undefined;
+                i.ready = false;
+                i.error = e;
                 if (throwErrors) {
-                    throw _i.error;
+                    throw i.error;
                 }
                 return;
             }
         }
-        if (_i.ready) {
+        if (i.ready) {
             return;
         }
         try {
-            _i.sql = npm.fs.readFileSync(_i.filePath, `utf8`);
-            _i.modTime = lastMod || npm.fs.statSync(_i.filePath).mtime.getTime();
+            i.sql = npm.fs.readFileSync(i.filePath, `utf8`);
+            i.modTime = lastMod || npm.fs.statSync(i.filePath).mtime.getTime();
             if (options.minify && options.minify !== `after`) {
-                _i.sql = npm.minify(_i.sql, {compress: options.compress});
+                i.sql = npm.minify(i.sql, {compress: options.compress});
             }
             if (options.params !== undefined) {
-                _i.sql = npm.formatting.as.format(_i.sql, options.params, {partial: true});
+                i.sql = npm.formatting.as.format(i.sql, options.params, {partial: true});
             }
             if (options.minify && options.minify === `after`) {
-                _i.sql = npm.minify(_i.sql, {compress: options.compress});
+                i.sql = npm.minify(i.sql, {compress: options.compress});
             }
-            _i.ready = true;
-            _i.error = undefined;
+            i.ready = true;
+            i.error = undefined;
         } catch (e) {
-            _i.sql = undefined;
-            _i.error = new QueryFileError(e, this);
+            i.sql = undefined;
+            i.error = new QueryFileError(e, this);
             if (throwErrors) {
-                throw _i.error;
+                throw i.error;
             }
         }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pg-promise",
-  "version": "10.10.2",
+  "version": "10.12.0",
   "description": "PostgreSQL interface for Node.js",
   "main": "lib/index.js",
   "typings": "typescript/pg-promise.d.ts",
@@ -9,7 +9,6 @@
     "test:native": "jasmine-node test --config PG_NATIVE true",
     "doc": "jsdoc -c ./jsdoc/jsdoc.js ./jsdoc/README.md -t ./jsdoc/templates/custom",
     "coverage": "istanbul cover ./node_modules/jasmine-node/bin/jasmine-node test",
-    "travis": "npm run lint && npm run tslint && npm run coverage --captureExceptions && cat ./coverage/lcov.info | ./node_modules/coveralls/bin/coveralls.js && rm -rf ./coverage",
     "lint": "eslint ./lib ./test/*.js ./test/db --fix",
     "tslint": "tslint ./typescript/*.ts"
   },
@@ -37,25 +36,25 @@
   },
   "license": "MIT",
   "engines": {
-    "node": ">=8.0"
+    "node": ">=12.0"
   },
   "dependencies": {
     "assert-options": "0.7.0",
-    "pg": "8.6.0",
+    "pg": "8.8.0",
     "pg-minify": "1.6.2",
     "spex": "3.2.0"
   },
   "devDependencies": {
-    "@types/node": "15.0.1",
+    "@types/node": "18.7.13",
     "bluebird": "3.7.2",
-    "coveralls": "3.1.0",
-    "eslint": "7.25.0",
+    "coveralls": "3.1.1",
+    "eslint": "8.23.0",
     "istanbul": "0.4.5",
     "jasmine-node": "3.0.0",
-    "jsdoc": "3.6.6",
+    "jsdoc": "3.6.11",
     "JSONStream": "1.3.5",
-    "pg-query-stream": "4.1.0",
+    "pg-query-stream": "4.2.4",
     "tslint": "6.1.3",
-    "typescript": "4.2.4"
+    "typescript": "4.8.2"
   }
 }

package/typescript/pg-promise.d.ts

@@ -166,6 +166,7 @@ declare namespace pgPromise {
         readonly def: any;
         readonly castText: string;
         readonly escapedName: string;
+        readonly variable: string;
         readonly init: (col: IColumnDescriptor<T>) => any
         readonly skip: (col: IColumnDescriptor<T>) => boolean
 

package/typescript/pg-subset.d.ts

@@ -13,7 +13,7 @@
 // Calling it 'pg-subset' to avoid a conflict in case the application also
 // includes the official 'pg' typings.
 //
-// Supported version of pg: 8.0.0 and later.
+// Supported version of pg: 8.7.1 and later.
 //
 // pg: https://github.com/brianc/node-postgres
 //////////////////////////////////////////////////////////////////////////////
@@ -105,6 +105,8 @@ declare namespace pg {
         Client?: new(config: string | IConnectionParameters) => C
         Promise?: any
         types?: ITypeOverrides
+        allowExitOnIdle?: boolean
+        maxLifetimeSeconds?: number
     }
 
     // Type id-s supported by PostgreSQL, copied from: