Add a top level query() shorthand and fix some related docs

src/index.js

@@ -127,8 +127,9 @@ const SQL = {
    * Creates and manages a connection around a callback.
    *
    * @param {function} callback
-   * @param {pg.Pool} [pool]
-   * @param {boolean} [autoDestroyConn=false]
+   * @param {Object} [options]
+   * @param {pg.Pool} [options.pool]
+   * @param {boolean} [options.autoDestroyConn=false]
    * @returns {Promise<*>}
    */
   async connected(callback, {pool = null, autoDestroyConn = false} = {}) {
@@ -159,10 +160,11 @@ const SQL = {
    * Creates and manages a transaction around a callback.
    *
    * @param {function} callback
-   * @param {pg.Client} [conn]
-   * @param {pg.Pool} [pool]
-   * @param {boolean} [allowNested=false]
-   * @param {boolean} [autoDestroyConn=false]
+   * @param {Object} [options]
+   * @param {pg.Client} [options.conn]
+   * @param {pg.Pool} [options.pool]
+   * @param {boolean} [options.allowNested=false]
+   * @param {boolean} [options.autoDestroyConn=false]
    * @returns {Promise<*>}
    */
   async transaction(callback, {conn = null, pool = null, allowNested = false, autoDestroyConn = false} = {}) {
@@ -226,6 +228,25 @@ const SQL = {
     }
   },
 
+  /**
+   * Shorthand for one-off query.
+   *
+   * @param {string} test - SQL query.
+   * @param {Array} [values]
+   * @param {Object} [options]
+   * @param {pg.Pool} [options.pool]
+   * @param {boolean} [options.autoDestroyConn=false]
+   * @param {string} [options.name] - node-pg passthrough
+   * @param {string} [options.rowMode] - node-pg passthrough
+   * @param {*} [options.types] - node-pg passthrough
+   * @returns {Promise<pg.Result>}
+   */
+  async query(text, values = null, {pool = null, autoDestroyConn = false, name = undefined, rowMode = undefined, types = undefined} = {}) {
+    return this.connected(async function(conn) {
+      return conn.query({text, values, name, rowMode, types});
+    }, {pool, autoDestroyConn});
+  },
+
   /**
    * Where AND.
    *

tests/poolsAndConns.js

@@ -271,3 +271,11 @@ test('transaction autoDestroyConn', async (t) => {
     t.true(conn._the_one === undefined);
   }, {pool});
 });
+
+test('query one-off', async (t) => {
+  const pool = createTestPool(1);
+
+  const result = await SQL.query('SELECT 5 foo', null, {pool});
+  t.is(result.rows.length, 1);
+  t.is(result.rows[0].foo, 5);
+});