docs(datatype): add a note about BIGINT datatype conversion to string (#5796)

* docs(datatype): add a note about BIGINT datatype conversion to string

This helps users to understand the reason to this conversion and avoid more open issues to Sequelize like these:
- https://github.com/sequelize/sequelize/issues/1774
- https://github.com/sequelize/sequelize/issues/4550

* docs(datatype): add documentation to source code

docs/api/datatypes.md

@@ -89,6 +89,8 @@ Available properties: `UNSIGNED`, `ZEROFILL`
 
 
 A 64 bit integer.
 A 64 bit integer.
 
 
+Note: an attribute defined as `BIGINT` will be treated like a `string` due this [feature from node-postgres](https://github.com/brianc/node-postgres/pull/353) to prevent precision loss. To have this attribute as a `number`, this is a possible [workaround](https://github.com/sequelize/sequelize/issues/2383#issuecomment-58006083).
+
 Available properties: `UNSIGNED`, `ZEROFILL`
 Available properties: `UNSIGNED`, `ZEROFILL`
 
 
 ***
 ***

lib/data-types.js

@@ -277,6 +277,8 @@ INTEGER.prototype.validate = function(value) {
 /**
 /**
  * A 64 bit integer.
  * A 64 bit integer.
  *
  *
+ * Note: an attribute defined as `BIGINT` will be treated like a `string` due this [feature from node-postgres](https://github.com/brianc/node-postgres/pull/353) to prevent precision loss. To have this attribute as a `number`, this is a possible [workaround](https://github.com/sequelize/sequelize/issues/2383#issuecomment-58006083).
+ *
  * Available properties: `UNSIGNED`, `ZEROFILL`
  * Available properties: `UNSIGNED`, `ZEROFILL`
  *
  *
  * @property BIGINT
  * @property BIGINT