improving _TN function (#933)

lib/helpers/index.js

@@ -25,7 +25,7 @@ const method = require('./methods');
  * {@link helpers.TableName TableName} class constructor.
  *
  * @property {function} _TN
- * {@link helpers._TN _TN} Table-Name template tag function.
+ * {@link helpers._TN _TN} Table-Name conversion function.
  *
  * @property {function} ColumnSet
  * {@link helpers.ColumnSet ColumnSet} class constructor.

lib/helpers/table-name.js

@@ -139,18 +139,22 @@ npm.utils.addInspection(TableName, function () {
 /**
  * @function helpers._TN
  * @description
- * Table-Name template tag function, to convert any `"schema.table"` string
+ * Table-Name helper function, to convert any `"schema.table"` string
  * into `{schema, table}` object.
  *
  * @example
  * const {ColumnSet, _TN} = pgp.helpers;
  *
- * const cs = new ColumnSet(['id', 'name'], {table: _TN`schema.table`});
+ * // Using as a regular function:
+ * const cs1 = new ColumnSet(['id', 'name'], {table: _TN('schema.table')});
+ *
+ * // Using as a template-tag function:
+ * const cs2 = new ColumnSet(['id', 'name'], {table: _TN`schema.table`});
  *
  * @returns {Table}
  */
-function _TN(data) {
- const [schema, table] = data[0].split('.');
+function _TN(s) {
+ const [schema, table] = (s.raw ? s[0] : s).split('.');
  return table === undefined ? {table: schema} : {schema, table};
 }
 

package.json

@@ -1,6 +1,6 @@
 {
  "name": "pg-promise",
- "version": "11.7.0",
+ "version": "11.7.1",
  "description": "PostgreSQL interface for Node.js",
  "main": "lib/index.js",
  "typings": "typescript/pg-promise.d.ts",

typescript/pg-promise.d.ts

@@ -708,7 +708,7 @@ declare namespace pgPromise {
  ColumnSet: typeof ColumnSet
  TableName: typeof TableName
 
- _TN: (data: TemplateStringsArray) => ITable
+ _TN: (data: TemplateStringsArray | string) => ITable
  }
 
  interface IGenericPromise {