extending type TableName.

jsdoc/fixLinks.js

@@ -24,7 +24,8 @@ var links = {
     "ES6 generator": "https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Statements/function*",
     "Performance Boost": "https://github.com/vitaly-t/pg-promise/wiki/Performance-Boost",
     "Prepared Statement": "http://www.postgresql.org/docs/9.5/static/sql-prepare.html",
-    "Prepared Statements": "http://www.postgresql.org/docs/9.5/static/sql-prepare.html"
+    "Prepared Statements": "http://www.postgresql.org/docs/9.5/static/sql-prepare.html",
+    "Custom Type Formatting": "https://github.com/vitaly-t/pg-promise#custom-type-formatting"
 };
 
 function fixLinks(source) {

lib/helpers/tableName.js

@@ -8,13 +8,18 @@ var $npm = {
 /**
  * @class helpers.TableName
  * @description
- * 
+ *
  * **Alternative Syntax:** `TableName({table, [schema]})` ⇒ {@link helpers.TableName}
  *
  * Prepares and escapes a full table name that can be injected into queries directly.
  *
  * This is a read-only type that can be used wherever parameter `table` is supported.
  *
+ * **Added in v.4.7.4:**
+ *
+ * Support for $[Custom Type Formatting], i.e. you can use the type directly as a formatting parameter,
+ * without specifying any escaping.
+ *
  * @param {String|Object} table
  * Table name details, depending on the type:
  *
@@ -44,7 +49,11 @@ var $npm = {
  * var table = new pgp.helpers.TableName('my-table', 'my-schema');
  * console.log(table);
  * //=> "my-schema"."my-table"
- * 
+ *
+ * // From v.4.7.4 we use the type directly:
+ * pgp.as.format("SELECT $1", table);
+ * //=> SELECT "my-schema"."my-table"
+ *
  */
 function TableName(table, schema) {
 
@@ -77,9 +86,15 @@ function TableName(table, schema) {
         this.name = $npm.formatting.as.name(schema) + '.' + this.name;
     }
 
+    this._rawDBType = true;
+
     Object.freeze(this);
 }
 
+TableName.prototype.formatDBType = function () {
+    return this.name;
+};
+
 /**
  * @method helpers.TableName.toString
  * @description

package.json

@@ -1,6 +1,6 @@
 {
   "name": "pg-promise",
-  "version": "4.7.3",
+  "version": "4.7.4",
   "description": "Promises interface for PostgreSQL",
   "main": "lib/index.js",
   "scripts": {