lib: Log a deprecation message when a {__raw: ...} object is used

Author: nwoltman

lib/MySQLTable.js

@@ -1,5 +1,12 @@
 'use strict';
 
+const util = require('util');
+
+const returnDeprecatedRaw = util.deprecate(
+  raw => raw,
+  '[mysql-plus] {__raw: ...} objects are deprected and will not be supported starting in v0.14.0.'
+);
+
 /**
  * A class that provides convenient methods for performing queries.<br>To create
  * an instance, use {@link PoolPlus#defineTable|`poolPlus.defineTable()`} or
@@ -462,7 +469,7 @@ class MySQLTable {
 
   _rawEscape(value) {
     return value && value.__raw !== undefined
-      ? value.__raw
+      ? returnDeprecatedRaw(value.__raw)
       : this._db.escape(value);
   }
 }