pogi 2.11.0

package/.vscode/launch.json

@@ -0,0 +1,35 @@
+{
+    // Use IntelliSense to learn about possible attributes.
+    // Hover to view descriptions of existing attributes.
+    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "Debug via npm",
+            "type": "node",
+            "request": "launch",
+            "cwd": "${workspaceFolder}",
+            "runtimeExecutable": "npm",
+            "runtimeArgs": [
+                "run-script", "test_debug"
+            ],
+            "port": 9229
+        },
+        {
+			"name": "Run test",
+			"type": "node",
+			"request": "launch",
+			"cwd": "${workspaceFolder}",
+			"program": "${workspaceFolder}/spec/run.js",
+            "runtimeExecutable": "node",
+            "skipFiles": [
+				"fs.js",
+				"typescript.js",
+				"tslib.js",
+				"loader.js",
+				"loaders.js",
+				"helpers.js",
+			  ]
+		}
+    ]
+}

package/CHANGELOG.md

@@ -0,0 +1,277 @@
+# [2.11.0](https://github.com/holdfenytolvaj/pogi/compare/v2.10.0...v2.11.0) (2021-09-16)
+
+### Features
+
+- documentation on postgres-notifications
+([427119b](https://github.com/holdfenytolvaj/pogi/commit/427119baa3ffd8a19dc5ba5084e08ab7e2a4c395))
+- automatic restart upon disconnected connection ([2bc777a](https://github.com/holdfenytolvaj/pogi/commit/2bc777ace4b88c2890b80e4090f3733137b89ef5))
+- automatic recognition of changed enum ([5af7146](https://github.com/holdfenytolvaj/pogi/commit/5af7146d727f0344e3411a2f9df1f02afbf998b2),[bfaedd5](https://github.com/holdfenytolvaj/pogi/commit/bfaedd5a10810623d27be010e338abe324155494))
+
+### Bug Fixes
+
+## [2.10.2](https://github.com/holdfenytolvaj/pogi/compare/v2.10.0...v2.10.2) (2021-01-29)
+
+
+### Bug Fixes
+
+* Null pointer exception ([289e6f4](https://github.com/holdfenytolvaj/pogi/commit/289e6f4))
+
+
+
+## [2.10.1](https://github.com/holdfenytolvaj/pogi/compare/v2.10.0...v2.10.1) (2021-01-29)
+
+
+### Bug Fixes
+
+* Null pointer exception ([289e6f4](https://github.com/holdfenytolvaj/pogi/commit/289e6f4))
+
+
+
+# [2.10.0](https://github.com/holdfenytolvaj/pogi/compare/v2.9.2...v2.10.0) (2021-01-29)
+
+
+### Features
+
+* new query function queryAsRows which gives result as array instead of objects ([119aa73](https://github.com/holdfenytolvaj/pogi/commit/119aa73))
+
+
+
+# [2.10.0](https://github.com/holdfenytolvaj/pogi/compare/v2.9.2...v2.10.0) (2021-01-29)
+
+
+### Features
+
+* new query function queryAsRows which gives result as array instead of objects ([119aa73](https://github.com/holdfenytolvaj/pogi/commit/119aa73))
+
+
+
+## [2.9.2](https://github.com/holdfenytolvaj/pogi/compare/v2.9.1...v2.9.2) (2020-06-13)
+
+### Bug Fixes
+
+* handle empty 'and' and 'or' condition ([e49c416](https://github.com/holdfenytolvaj/pogi/commit/e49c416))
+
+## [2.9.1](https://github.com/holdfenytolvaj/pogi/compare/v2.9.0...v2.9.1) (2020-06-13)
+
+### Chore
+bump pg (8.2.1) and pg-query-stream (3.1.1) to support nodejs v14
+
+
+# [2.9.0](https://github.com/holdfenytolvaj/pogi/compare/v2.8.0...v2.9.0) (2020-05-28)
+
+### Features
+
+* more options to handle transaction,  savepoint support from API ([d5a88cb](https://github.com/holdfenytolvaj/pogi/commit/d5a88cb))
+
+
+# [2.8.0](https://github.com/holdfenytolvaj/pogi/compare/v2.5.11...v2.8.0) (2020-04-29)
+
+
+### Bug Fixes
+
+* execute (file) function do not start new dedicated connection when run in one, add support for /* */ comment ([d5a03d5](https://github.com/holdfenytolvaj/pogi/commit/d5a03d5))
+
+
+### Features
+
+* add notify and listen functions ([fb3318a](https://github.com/holdfenytolvaj/pogi/commit/fb3318a))
+
+
+
+<a name="2.7.2"></a>
+## add initial support for postgresl PUB/SUB
+
+<a name="2.7.1"></a>
+## add more test and update packages
+
+[.. some missing update]
+
+<a name="2.5.11"></a>
+## [2.5.11](https://github.com/holdfenytolvaj/pogi/compare/v2.5.10...v2.5.11) (2018-10-01)
+
+
+### Bug Fixes
+
+* queryOneField and queryOneColumn maybe fall if no result found ([3395951](https://github.com/holdfenytolvaj/pogi/commit/3395951))
+
+
+
+<a name="2.5.10"></a>
+## [2.5.10](https://github.com/holdfenytolvaj/pogi/compare/v2.5.9...v2.5.10) (2018-08-14)
+ * use different syntax for array query to avoid long sql (so instead of "field IN ($1, $2, $3)" where $1 $2 $3 are values use "field =ANY $1" where $1 is an array). There is no speed difference
+
+
+<a name="2.5.8"></a>
+## [2.5.8](https://github.com/holdfenytolvaj/pogi/compare/v2.5.6...v2.5.8) (2018-04-23)
+* Nothing changed, just scripts runs and runs
+
+
+<a name="2.5.7"></a>
+## [2.5.7](https://github.com/holdfenytolvaj/pogi/compare/v2.5.6...v2.5.7) (2018-04-23)
+
+### Bug Fixes
+
+* null item value handling on column type number[]
+
+
+<a name="2.5.6"></a>
+## [2.5.6](https://github.com/holdfenytolvaj/pogi/compare/v2.5.5...v2.5.6) (2018-03-05)
+
+
+### Bug Fixes
+
+* reload function should use transaction if it started to reload schema. ([d14c495](https://github.com/holdfenytolvaj/pogi/commit/d14c495))
+
+
+
+<a name="2.5.5"></a>
+## [2.5.5](https://github.com/holdfenytolvaj/pogi/compare/v2.5.3...v2.5.5) (2017-12-12)
+* Nothing changed, just scripts runs and runs
+
+## [2.5.4](https://github.com/holdfenytolvaj/pogi/compare/v2.5.3...v2.5.5) (2017-12-12)
+### Bug Fixes
+* fix import statement
+
+<a name="2.5.3"></a>
+## [2.5.3](https://github.com/holdfenytolvaj/pogi/compare/v2.5.2...v2.5.3) (2017-12-04)
+
+
+### Bug Fixes
+
+* array column parsing , JSON.parse do not handle correctly special characters ex: \ f (formfeed) ([c2a48dc](https://github.com/holdfenytolvaj/pogi/commit/c2a48dc))
+
+
+
+<a name="2.5.2"></a>
+## [2.5.2](https://github.com/holdfenytolvaj/pogi/compare/v2.5.1...v2.5.2) (2017-11-30)
+
+
+### Bug Fixes
+
+* update query build did not handle properly null value on query ([0d84e61](https://github.com/holdfenytolvaj/pogi/commit/0d84e61))
+
+
+
+<a name="2.5.1"></a>
+## [2.5.1](https://github.com/holdfenytolvaj/pogi/compare/v2.5.0...v2.5.1) (2017-11-08)
+* Nothing changed, just scripts runs and runs
+
+
+<a name="2.5.0"></a>
+# [2.5.0](https://github.com/holdfenytolvaj/pogi/compare/v2.4.0...v2.5.0) (2017-11-08)
+
+
+### Bug Fixes
+
+* add tslib to dependencies ([eb16ea4](https://github.com/holdfenytolvaj/pogi/commit/eb16ea4))
+* jsonb[] column parsing ([eafb0fd](https://github.com/holdfenytolvaj/pogi/commit/eafb0fd))
+
+
+
+<a name="2.4.0"></a>
+# [2.4.0](https://github.com/holdfenytolvaj/pogi/compare/v2.3.5...v2.4.0) (2017-10-24)
+
+
+### Features
+
+* add queryFirst, queryOne queries which return only one result ([dce7bad](https://github.com/holdfenytolvaj/pogi/commit/dce7bad))
+* add distinct, forUpdate as boolean query options ([dce7bad](https://github.com/holdfenytolvaj/pogi/commit/dce7bad))
+
+
+
+<a name="2.3.5"></a>
+## [2.3.5](https://github.com/holdfenytolvaj/pogi/compare/v2.3.4...v2.3.5) (2017-10-20)
+
+
+### Bug Fixes
+
+* option is passed to pg connect by a copied  object not prototype ([7c5e186](https://github.com/holdfenytolvaj/pogi/commit/7c5e186))
+
+
+
+<a name="2.3.4"></a>
+## [2.3.4](https://github.com/holdfenytolvaj/pogi/compare/v2.3.3...v2.3.4) (2017-10-19)
+
+
+### Bug Fixes
+
+* streams not released connections ([a7fdb42](https://github.com/holdfenytolvaj/pogi/commit/a7fdb42))
+* textArray parsing do not handle right "  character ([c3993db](https://github.com/holdfenytolvaj/pogi/commit/c3993db))
+
+
+
+<a name="2.3.3"></a>
+## [2.3.3](https://github.com/holdfenytolvaj/pogi/compare/v2.3.2...v2.3.3) (2017-10-13)
+
+
+### Bug Fixes
+
+* pg stream not working with newer version of pg-query-stream ([00d1687](https://github.com/holdfenytolvaj/pogi/commit/00d1687))
+
+
+
+<a name="2.3.2"></a>
+## [2.3.2](https://github.com/holdfenytolvaj/pogi/compare/v2.2.4...v2.3.2) (2017-09-29)
+
+
+### Bug Fixes
+
+* textArray parsing do not handle right \ escape character ([7b9c332](https://github.com/holdfenytolvaj/pogi/commit/7b9c332))
+
+
+
+<a name="2.2.4"></a>
+## [2.2.4](https://github.com/holdfenytolvaj/pogi/compare/v2.2.3...v2.2.4) (2017-06-11)
+
+
+
+<a name="2.2.3"></a>
+## [2.2.3](https://github.com/holdfenytolvaj/pogi/compare/v2.2.2...v2.2.3) (2017-06-06)
+
+
+
+<a name="2.2.2"></a>
+## [2.2.2](https://github.com/holdfenytolvaj/pogi/compare/v2.2.1...v2.2.2) (2017-06-02)
+
+
+
+<a name="2.2.1"></a>
+## [2.2.1](https://github.com/holdfenytolvaj/pogi/compare/v2.2.0...v2.2.1) (2017-03-20)
+
+
+
+<a name="2.2.0"></a>
+# [2.2.0](https://github.com/holdfenytolvaj/pogi/compare/v2.1.1...v2.2.0) (2017-03-18)
+
+
+
+<a name="2.1.1"></a>
+## [2.1.1](https://github.com/holdfenytolvaj/pogi/compare/v2.1.0...v2.1.1) (2017-03-13)
+
+
+
+<a name="2.1.0"></a>
+# [2.1.0](https://github.com/holdfenytolvaj/pogi/compare/v2.0.0...v2.1.0) (2017-01-23)
+
+
+
+<a name="2.0.0"></a>
+# [2.0.0](https://github.com/holdfenytolvaj/pogi/compare/v1.0.4...v2.0.0) (2016-12-12)
+
+
+
+<a name="1.0.2"></a>
+## [1.0.2](https://github.com/holdfenytolvaj/pogi/compare/v1.0.1...v1.0.2) (2016-11-30)
+
+
+
+<a name="1.0.1"></a>
+## [1.0.1](https://github.com/holdfenytolvaj/pogi/compare/v1.0.0...v1.0.1) (2016-10-13)
+
+
+
+<a name="1.0.0"></a>
+# 1.0.0 (2016-10-12)
+
+
+

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright 2016 Radics, Laszlo & Radics, Geza
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,85 @@
+# pogi
+> What is your dream?
+
+**pogi** is a wrapper over [pg.js](https://github.com/brianc/node-postgres) to use PostgreSQL easier.
+- it is not an over engineered ORM with new syntax to learn and with less functionality,
+- it is not a simple prepared statements executor with a lot of boilerplate for queries
+
+it is somewhere in between, around the _golden_ middle ground.
+
+## Some of the features:
+- typescript support (async-await!) (also can generate the structure for the db)
+- transaction support
+- connection pooling
+- sql file execution
+- BYOL - bring your own logger :) (db/schema/table/query level)
+- encourage mixing jsonb and relational columns (arrays, complex types, enums etc) to get the full power!
+- named parameters for queries
+- stream support
+
+so all the basics that you would expect in 2018.
+
+## Install
+```js
+npm install pogi --save
+```
+
+## Documentation (includes why+1?)
+[here](http://pogi.readthedocs.io/en/latest/)
+
+[Our experience on migrating from mongo](https://hackernoon.com/javascript-experience-of-migrating-from-mongodb-to-postgresql-21f8bf140c05#.k4d7hqsv2)
+
+
+## Some examples to get the taste
+```js
+import {PgDb} from "pogi";
+
+let pgdb = await PgDb.connect({connectionString: "postgres://"});
+
+let table = pgdb['test']['users']; //or pgdb.test.users if you generate the interface
+
+let c1 = await pgdb.query(`SELECT COUNT(*) as c FROM ${table} WHERE active=:active`, {active:true});
+let c2 = await table.count({active:true});
+c1[0].c == c2; //true
+
+//mix json and relational columns (e.g. enumerations)
+await table.insert({name:'simply', permissions:['r','w','e'], props:{email:'undefined@dev.null'}});
+
+let rows;
+
+//use the same operators as in postgre
+rows = await table.find({'name ~':'Jo.*',                                  //regexp
+                         'jsoncolumn @>':{'dream':{'change':'the world'}}, //contains
+                         'arraycolumn @>':['up', 'down']});                //contains
+
+//will be transformed to "select * from test.users where id in (1,2,3)"
+rows = await table.find({id:[1,2,3]});
+
+//easy fallback
+rows = await table.findWhere('"happyWife"="happyLife" and name=:name', {name:'me'});
+
+//convenient functions
+let power = await pgdb.queryOneField('SELECT MAX(power) FROM magical.dbhandlers');
+power; //>9000
+
+//much more!
+
+```
+
+## It's not without pitfalls
+What is? It's just usually not written (definitely not in the front page), but see more in the [docs](https://pogi.readthedocs.io/pitfalls/).
+I wish more project would be honest about it to save a lot of hours for others. If you find more,
+don't hesitate to tell us!
+
+## Contributing
+Ideas are welcome! To compile & test
+```js
+npm run build
+npm run test
+```
+
+## Changelog
+[Changelog.md](CHANGELOG.md)
+
+## Handcrafted at
+[www.labcup.net](http://www.labcup.net/)

package/docs/API/PgDb.md

@@ -0,0 +1,218 @@
+For all the examples below 
+```js
+import {PgDb} from "pogi";
+
+let pgdb = PgDb.connect(..);
+```
+Note: search path will be readed on connection and `tables` and `fn` properties will be populated by that. However these are not merged into PgDb object, while schemas will be.
+
+#Properties
+## db
+<span class="def">db:</span><span class="type">PgDb</span>
+Back reference to this instance.
+## schemas
+<span class="def">schemas:</span><span class="type">{[name:string]:PgSchema}</span>
+Schemas, also merged to db object.
+## tables
+<span class="def">tables:</span><span class="type">{[name:string]:PgTable}</span>
+Tables in the search_path.
+## fn
+<span class="def">fn:</span><span class="type">{[name:string]:Function}</span>
+Stored procedures and functions in the search_path.
+#Functions
+##setLogger
+<span class="def"><span class="func">setLogger</span>(logger:<span class="type">PgDbLogger</span>) </span>
+
+Note: inherited.
+
+Sets the fallback logger for all queries (if no schema, table or query level logger is set, this will be used).
+```js
+pgdb.setLogger(console);
+```
+
+---
+## isTransactionActive
+<span class="def"><span class="func">isTransactionActive</span>():Promise&lt;<span class="type">PgDb</span>&gt;</span>
+
+Returns true if the active connection has transaction ongoing. (Does not detect timeouts.)
+
+# Functions - async
+
+## connect
+<span style="color:darkorange;">static</span> <span class="def"><span class="func">connect</span>(config:<span class="type">ConnectionOptions</span>):Promise&lt;<span class="type">PgDb</span>&gt;</span>
+
+see [connection](/connection) section
+
+---
+## close
+<span style="color:darkorange;">static</span> <span class="def"><span class="func">close</span>():Promise&lt;<span class="type">void</span>&gt;</span>
+
+Close connection, useful for exiting/teardown code.
+
+---
+## dedicatedConnectionBegin
+<span class="def"><span class="func">dedicatedConnectionBegin</span>():Promise&lt;<span class="type">PgDb</span>&gt;</span>
+
+You can use dedicated connection instead of pool. It is very useful if you plan to use such a command: `SET search_path TO "dev";`
+Similar to [transactionBegin](#transactionBegin) but without transaction. This function will create a new PgDb instance with the dedicated connection mode. 
+Use of that Pgdb instance all query will go throuth that single connection. The original pgdb instance won't touched.
+For example see the [transaction](/transaction) section. 
+
+---
+## dedicatedConnectionEnd
+<span class="def"><span class="func">dedicatedConnectionEnd</span>():Promise&lt;<span class="type">PgDb</span>&gt;</span>
+
+Close dedicated connection. If there is no dedicated connection, do nothing. After that pgdb instance will work in pooled connection mode. 
+Return value will be the same pgdb instance.
+For example see the [transaction](/transaction) section. 
+
+---
+## execute
+<span class="def"><span class="func">execute</span>(fileName, transformer?:<span class="type">(string)=&gt;string)</span>):Promise&lt;<span class="type">void</span>&gt;</span>
+
+Executes an sql file, with a transformer function. For more details see [Executing sql files](/executingSqlFile) section.
+
+```js
+for (let schemaName of ['test1', 'test2']) {
+    await pgdb.execute(__dirname + '/db_upgrade/all.sql', (cmd)=&gt;cmd.replace(/__SCHEMA__/g, '"' + schemaName + '"'));
+}
+```
+
+where the sql file is (`__SCHEMA__` will be replaced to the `schemaName` see above)
+```sql
+UPDATE __SCHEMA__.webapp set lang='TS' where lang='JS';
+```
+
+---
+##query
+<span class="def"><span class="func">query</span>(sql:<span class="type">string</span>, params?:<span class="type">any[]|{}</span>, options?:<span class="type">SqlQueryOptions</span>):Promise&lt;<span class="type">any[]</span>&gt;</span>
+<a name="query"></a>
+
+Executes an arbitrary sql string with parameters / named parameters. 
+```ts
+let res1 = await schema.query('SELECT MAX(point) from game1.scores WHERE name=$1 ', ['player1']);
+let res2 = await schema.query('SELECT MAX(point) from !:schema.scores WHERE name=:name ', {schema:'game1', name:'player1'});
+```
+---
+##queryFirst
+<span class="def"><span class="func">queryFirst</span>(sql:<span class="type">string</span>, params?:<span class="type">any[]|{}</span>, options?:<span class="type">SqlQueryOptions</span>):Promise&lt;<span class="type">any</span>&gt;</span>
+<a name="query"></a>
+
+Executes an arbitrary sql string with parameters / named parameters. Return the first record. 
+
+---
+##queryOne
+<span class="def"><span class="func">query</span>(sql:<span class="type">string</span>, params?:<span class="type">any[]|{}</span>, options?:<span class="type">SqlQueryOptions</span>):Promise&lt;<span class="type">any</span>&gt;</span>
+<a name="query"></a>
+ 
+Executes an arbitrary sql string with parameters / named parameters. Return the first record, throw Error if there are more. 
+
+---
+## queryOneField
+<span class="def"><span class="func">queryOneField</span>(sql:<span class="type">string</span>, params?:<span class="type">any[]|{}</span>, options?:<span class="type">SqlQueryOptions</span>):Promise&lt;<span class="type">any</span>&gt;</span>
+
+Note: inherited, uses schema level log if present (if not then the db level log).
+
+If there is only one record and one field that we are interested in. For the params usage see [query](#query).
+```js
+let winner = await schema.getOneField(`SELECT 'The winner is ' || name FROM test1.users LIMIT 1`);
+console.log(winner); //The winner is Admin
+```
+
+---
+## queryOneColumn
+<span class="def"><span class="func">queryOneColumn</span>(sql:<span class="type">string</span>, params?:<span class="type">any[]|{}</span>, options?:<span class="type">SqlQueryOptions</span>):Promise&lt;<span class="type">any[]</span>&gt;</span>
+
+Note: inherited, uses schema level log if present (if not then the db level log).
+
+If there is only one column that we are interested in. For the params usage see [query](#query).
+```js
+let userList = await schema.getOneColumn('SELECT name FROM test1.users');
+console.dir(userList); //['Admin', 'User1', 'User2']
+```
+
+---
+## queryAsStream
+<span class="def"><span class="func">queryAsStream</span>(sql:<span class="type">string</span>, params?:<span class="type">any[]|{}</span>, options?:<span class="type">SqlQueryOptions</span>):Promise&lt;<span class="type">any[]</span>&gt;</span>
+
+---
+## reload
+<span class="def"><span class="func">reload</span>()</span>
+Rerun the queries to load the schemas, tables and special types.
+Need to be called after truncate(!), alter table, create schema etc.
+
+---
+##run
+<span class="def"><span class="func">run</span>(sql:<span class="type">string</span>):Promise&lt;<span class="type">any[]</span>&gt;</span>
+Executes an arbitrary sql string.
+```js
+await schema.run('CREATE schema myschema');
+```
+
+---
+## setTypeParser
+<span class="def"><span class="func">setTypeParser</span>(typeName:<span class="type">string</span>, parser:<span class="type">(string)=&gt;any</span>, schemaName?:<span class="type">string</span>): Promise&lt;<span class="type">void</span>&gt;</span>
+
+See the [mapping database types to js types](/mappingDatabaseTypes) section
+
+---
+## setPgTypeParser
+<span class="def"><span class="func">setPgTypeParser</span>(typeName:<span class="type">string</span>, parser:<span class="type">(string)=&gt;any</span>, schemaName?:<span class="type">string</span>): Promise&lt;<span class="type">void</span>&gt;</span>
+
+See the [mapping database types to js types](/mappingDatabaseTypes) section
+
+---
+## setPostProcessResult
+<span class="def"><span class="func">setPostProcessResult</span>(f:(res: <span class="type">any[]</span>, fields: <span class="type">ResultFieldType[]</span>, logger:<span class="type">PgDbLogger</span>)=&gt;<span class="type">void</span>): <span class="type">void</span></span>
+You can add a postprocessor function that will be executed for every result (even empty ones), if you want to do something extra.
+If you call it twice the second function will overwrite the first. So you can easily unset also if you call it will null; 
+
+---
+## transactionBegin 
+<span class="def"><span class="func">transactionBegin</span>():Promise&lt;<span class="type">PgDb</span>&gt;</span>
+
+Return with a new PgDb instance with dedicated connection mode and start a transaction. 
+(Only this connection has the transaction, can be committed or rolled back. Similar to [dedicatedConnectionBegin](#dedicatedConnectionBegin))
+
+For example see the [transaction](/transaction) section. 
+
+---
+## transactionCommit 
+<span class="def"><span class="func">transactionCommit</span>():Promise&lt;<span class="type">PgDb</span>&gt;</span>
+
+If the PgDb instance has dedicated connection mode and has transaction it will commits that, otherwise do nothing.
+Returns with PgDb instance (with pool connections mode) where no transaction is taking place.
+For example see the [transaction](/transaction) section. 
+
+---
+## transactionRollback
+<span class="def"><span class="func">transactionRollback</span>():Promise&lt;<span class="type">PgDb</span>&gt;</span>
+
+If the PgDb instance has dedicated connection mode and has transaction it will rolls back, otherwise do nothing.
+Returns with PgDb instance (with pool connections mode) where no transaction is taking place.
+For example see the [transaction](/transaction) section. 
+
+---
+## listen
+<span class="def"><span class="func">listen</span>(channel:<span class="type">string</span>, callback:<span class="type">(Notification)=&gt;void)</span>;</>
+
+Creates a new dedicated connection for listeners (if it doesn't exists), and sets a callback for the channel.
+It is possible to set multiple callbacks for one channel.
+If there will be a notification from the database, the callback will be executed.
+For example see the [notification](/notification) section.
+
+---
+## unlisten
+<span class="def"><span class="func">unlisten</span>(channel:<span class="type">string</span>, callback?:<span class="type">(Notification)=&gt;void)</span>;</>
+
+Removes a listener. If callback parameter is set, only the given callback will be removed.
+If callback parameter is not set, all callbacks will be removed from the channel.
+If it was the last channel, the dedicated connection for listeners will be released.
+For example see the [notification](/notification) section.
+
+---
+## notify
+<span class="def"><span class="func">notify</span>(channel:<span class="type">string</span>, payload?:<span class="type">string</span>;</>
+
+Send a notification via postgresql.
+For example see the [notification](/notification) section.