mssql 3.2.1 → 3.3.0

package/CHANGELOG.txt

@@ -1,3 +1,9 @@
+v3.3.0 (2016-05-06)
+-------------------
+[new] Added support for receiving informational messages
+[new] Added JSON support for msnodesql and msnodesqlv8 drivers
+[fix] Minor fixes in connection string parsing
+
 v3.2.1 (2016-04-16)
 -------------------
 [fix] Added PreparedStatement.lastRequest to access internal Request when using Promises

package/README.md

@@ -68,83 +68,83 @@ sql.connect("mssql://username:password@localhost/database").then(function() {
 });
 ```
 
-If you're on Windows Azure, add `?encrypt=true` to your connection string. See [docs](#cfg) to learn more.
+If you're on Windows Azure, add `?encrypt=true` to your connection string. See [docs](#configuration) to learn more.
 
 ## Documentation
 
-* [2.x to 3.x changes](#twotothree)
+* [2.x to 3.x changes](#2x-to-3x-changes)
 
 ### Examples
 
 * [Promises](#promises)
-* [Nested callbacks](#callbacks)
+* [Nested callbacks](#nested-callbacks)
 * [Streaming](#streaming)
 * [Multiple Connections](#multiple-connections)
 
 ### Configuration
 
-* [General](#cfg-general)
-* [Formats](#cfg-formats)
+* [General](#general-same-for-all-drivers)
+* [Formats](#formats)
 
 ### Drivers
 
-* [Tedious](#cfg-tedious)
-* [Microsoft / Contributors Node V8 Driver for Node.js for SQL Server](#cfg-msnodesqlv8)
-* [Microsoft Driver for Node.js for SQL Server](#cfg-msnodesql)
-* [node-tds](#cfg-node-tds)
+* [Tedious](#tedious)
+* [Microsoft / Contributors Node V8 Driver for Node.js for SQL Server](#microsoft--contributors-node-v8-driver-for-nodejs-for-sql-server)
+* [Microsoft Driver for Node.js for SQL Server](#microsoft-driver-for-nodejs-for-sql-server)
+* [node-tds](#node-tds)
 
 ### Connections
 
 * [Connection](#connection)
-* [connect](#connect)
+* [connect](#connect-callback)
 * [close](#close)
 
 ### Requests
 
 * [Request](#request)
-* [execute](#execute)
-* [input](#input)
-* [output](#output)
-* [pipe](#pipe)
-* [query](#query)
-* [batch](#batch)
-* [bulk](#bulk)
+* [execute](#execute-procedure-callback)
+* [input](#input-name-type-value)
+* [output](#output-name-type-value)
+* [pipe](#pipe-stream)
+* [query](#query-command-callback)
+* [batch](#batch-batch-callback)
+* [bulk](#bulk-table-callback)
 * [cancel](#cancel)
 
 ### Transactions
 
 * [Transaction](#transaction)
-* [begin](#begin)
-* [commit](#commit)
-* [rollback](#rollback)
+* [begin](#begin-isolationlevel-callback)
+* [commit](#commit-callback)
+* [rollback](#rollback-callback)
 
 ### Prepared Statements
 
 * [PreparedStatement](#prepared-statement)
-* [input](#prepared-statement-input)
-* [output](#prepared-statement-output)
-* [prepare](#prepare)
-* [execute](#prepared-statement-execute)
-* [unprepare](#unprepare)
+* [input](#input-name-type)
+* [output](#output-name-type)
+* [prepare](#prepare-statement-callback)
+* [execute](#execute-values-callback)
+* [unprepare](#unprepare-callback)
 
 ### Other
 
 * [CLI](#cli)
-* [Geography and Geometry](#geography)
-* [Table-Valued Parameter](#tvp)
+* [Geography and Geometry](#geography-and-geometry)
+* [Table-Valued Parameter](#table-valued-parameter-tvp)
 * [Affected Rows](#affected-rows)
-* [JSON support](#json)
+* [JSON support](#json-support)
 * [Errors](#errors)
-* [Metadata](#meta)
+* [Informational messages](#informational-messages)
+* [Metadata](#metadata)
 * [Data Types](#data-types)
-* [SQL injection](#injection)
-* [Verbose Mode](#verbose)
-* [Known Issues](#issues)
+* [SQL injection](#sql-injection)
+* [Verbose Mode](#verbose-mode)
+* [Known Issues](#known-issues)
 * [Contributing](https://github.com/patriksimek/node-mssql/wiki/Contributing)
 
 ## Examples
 
-<a name="promises" />
 ### Promises
 
 ```javascript
@@ -205,7 +205,6 @@ sql.connect(config).then(function() {
 
 All values are automatically sanitized against sql injection.
 
-<a name="callbacks" />
 ### Nested callbacks
 
 ```javascript
@@ -250,7 +249,6 @@ sql.on('error', function(err) {
 });
 ```
 
-<a name="streaming" />
 ### Streaming
 
 If you plan to work with large amount of rows, you should always use streaming. Once you enable this, you must listen for events to receive data.
@@ -299,7 +297,6 @@ sql.on('error', function(err) {
 });
 ```
 
-<a name="multiple-connections" />
 ## Multiple Connections
 
 ```javascript
@@ -370,7 +367,6 @@ new sql.Connection(config).connect().then(function(conn) {
 
 All values are automatically sanitized against sql injection.
 
-<a name="cfg" />
 ## Configuration
 
 ```javascript
@@ -387,7 +383,6 @@ var config = {
 }
 ```
 
-<a name="cfg-general" />
 ### General (same for all drivers)
 
 - **driver** - Driver to use (default: `tedious`). Possible values: `tedious`, `msnodesqlv8` or `msnodesql` or `tds`.
@@ -400,12 +395,11 @@ var config = {
 - **connectionTimeout** - Connection timeout in ms (default: `15000`).
 - **requestTimeout** - Request timeout in ms (default: `15000`).
 - **stream** - Stream recordsets/rows instead of returning them all at once as an argument of callback (default: `false`). You can also enable streaming for each request independently (`request.stream = true`). Always set to `true` if you plan to work with large amount of rows.
-- **parseJSON** - Parse JSON recordsets to JS objects (default: `false`). For more information please see section [JSON support](#json).
+- **parseJSON** - Parse JSON recordsets to JS objects (default: `false`). For more information please see section [JSON support](#json-support).
 - **pool.max** - The maximum number of connections there can be in the pool (default: `10`).
 - **pool.min** - The minimum of connections there can be in the pool (default: `0`).
 - **pool.idleTimeoutMillis** - The Number of milliseconds before closing an unused connection (default: `30000`).
 
-<a name="cfg-formats" />
 ### Formats
 
 In addition to configuration object there is an option to pass config as a connection string. Two formats of connection string are supported.
@@ -430,7 +424,6 @@ __Version__
 
 ## Drivers
 
-<a name="cfg-tedious" />
 ### Tedious
 
 Default driver, actively maintained and production ready. Platform independent, runs everywhere Node.js runs.
@@ -446,7 +439,6 @@ Default driver, actively maintained and production ready. Platform independent,
 
 More information about Tedious specific options: http://pekim.github.io/tedious/api-connection.html
 
-<a name="cfg-msnodesqlv8" />
 ### Microsoft / Contributors Node V8 Driver for Node.js for SQL Server
 
 **Requires Node.js 0.12.x/4.2.0. Windows only.** This driver is not part of the default package and must be installed separately by `npm install msnodesqlv8`.
@@ -468,7 +460,6 @@ Default connection string when connecting to named instance:
 Driver={SQL Server Native Client 11.0};Server={#{server}\\#{instance}};Database={#{database}};Uid={#{user}};Pwd={#{password}};Trusted_Connection={#{trusted}};
 ```
 
-<a name="cfg-msnodesql" />
 ### Microsoft Driver for Node.js for SQL Server
 
 **Requires Node.js 0.6.x/0.8.x/0.10.x. Windows only.** This driver is not part of the default package and must be installed separately by `npm install msnodesql`. If you are looking for compiled binaries, see [node-sqlserver-binary](https://github.com/jorgeazevedo/node-sqlserver-unofficial).
@@ -490,15 +481,13 @@ Default connection string when connecting to named instance:
 Driver={SQL Server Native Client 11.0};Server={#{server}\\#{instance}};Database={#{database}};Uid={#{user}};Pwd={#{password}};Trusted_Connection={#{trusted}};
 ```
 
-<a name="cfg-node-tds" />
 ### node-tds
 
 **Legacy support, don't use this driver for new projects.** This driver is not part of the default package and must be installed separately by `npm install tds`.
 
 _node-mssql updates this driver with extra features and bug fixes by overriding some of its internal functions. If you want to disable this, require module with `var sql = require('mssql/nofix')`._
 
-<a name="connection" />
-## Connections
+## Connection
 
 Internally, each `Connection` instance is a separate pool of TDS connections. Once you create a new `Request`/`Transaction`/`Prepared Statement`, a new TDS connection is acquired from the pool and reserved for desired action. Once the action is complete, connection is released back to the pool. Connection health check is built-in so once the dead connection is discovered, it is immediately replaced with a new one.
 
@@ -519,8 +508,7 @@ __Errors__
 
 ---------------------------------------
 
-<a name="connect" />
-### connect([callback])
+### connect ([callback])
 
 Create a new connection pool with one active connection. This one initial connection serves as a probe to find out whether the configuration is valid.
 
@@ -553,7 +541,6 @@ __Errors__
 
 ---------------------------------------
 
-<a name="close" />
 ### close()
 
 Close all active connections in the pool.
@@ -564,8 +551,7 @@ __Example__
 connection.close();
 ```
 
-<a name="request" />
-## Requests
+## Request
 
 ```javascript
 var request = new sql.Request(/* [connection] */);
@@ -579,11 +565,11 @@ If you omit connection argument, global connection is used instead.
 - **row(row)** - Dispatched when new row is parsed.
 - **done(returnValue)** - Dispatched when request is complete.
 - **error(err)** - Dispatched on error.
+- **info(message)** - Dispatched on informational message.
 
 ---------------------------------------
 
-<a name="execute" />
-### execute(procedure, [callback])
+### execute (procedure, [callback])
 
 Call a stored procedure.
 
@@ -626,8 +612,7 @@ __Errors__
 
 ---------------------------------------
 
-<a name="input" />
-### input(name, [type], value)
+### input (name, [type], value)
 
 Add an input parameter to the request.
 
@@ -673,8 +658,7 @@ __Errors__ (synchronous)
 
 ---------------------------------------
 
-<a name="output" />
-### output(name, type, [value])
+### output (name, type, [value])
 
 Add an output parameter to the request.
 
@@ -697,8 +681,7 @@ __Errors__ (synchronous)
 
 ---------------------------------------
 
-<a name="pipe" />
-### pipe(stream)
+### pipe (stream)
 
 Sets request to `stream` mode and pulls all rows from all recordsets to a given stream.
 
@@ -726,10 +709,9 @@ __Version__
 
 ---------------------------------------
 
-<a name="query" />
-### query(command, [callback])
+### query (command, [callback])
 
-Execute the SQL command. To execute commands like `create procedure` or if you plan to work with local temporary tables, use [batch](#batch) instead.
+Execute the SQL command. To execute commands like `create procedure` or if you plan to work with local temporary tables, use [batch](#batch-batch-callback) instead.
 
 __Arguments__
 
@@ -777,10 +759,9 @@ request.query('select 1 as number; select 2 as number', function(err, recordsets
 
 ---------------------------------------
 
-<a name="batch" />
-### batch(batch, [callback])
+### batch (batch, [callback])
 
-Execute the SQL command. Unlike [query](#query), it doesn't use `sp_executesql`, so is not likely that SQL Server will reuse the execution plan it generates for the SQL. Use this only in special cases, for example when you need to execute commands like `create procedure` which can't be executed with [query](#query) or if you're executing statements longer than 4000 chars on SQL Server 2000. Also you should use this if you're plan to work with local temporary tables ([more information here](http://weblogs.sqlteam.com/mladenp/archive/2006/11/03/17197.aspx)).
+Execute the SQL command. Unlike [query](#query-command-callback), it doesn't use `sp_executesql`, so is not likely that SQL Server will reuse the execution plan it generates for the SQL. Use this only in special cases, for example when you need to execute commands like `create procedure` which can't be executed with [query](#query-command-callback) or if you're executing statements longer than 4000 chars on SQL Server 2000. Also you should use this if you're plan to work with local temporary tables ([more information here](http://weblogs.sqlteam.com/mladenp/archive/2006/11/03/17197.aspx)).
 
 NOTE: Table-Valued Parameter (TVP) is not supported in batch.
 
@@ -812,7 +793,6 @@ You can enable multiple recordsets in queries with the `request.multiple = true`
 
 ---------------------------------------
 
-<a name="bulk" />
 ### bulk(table, [callback])
 
 Perform a bulk insert.
@@ -856,7 +836,6 @@ __Errors__
 
 ---------------------------------------
 
-<a name="cancel" />
 ### cancel()
 
 Cancel currently executing request. Return `true` if cancellation packet was send successfully.
@@ -876,8 +855,7 @@ request.query('waitfor delay \'00:00:05\'; select 1 as number', function(err, re
 request.cancel();
 ```
 
-<a name="transaction" />
-## Transactions
+## Transaction
 
 **IMPORTANT:** always use `Transaction` class to create transactions - it ensures that all your requests are executed on one connection. Once you call `begin`, a single connection is acquired from the connection pool and all subsequent requests (initialized with the `Transaction` object) are executed exclusively on this connection. Transaction also contains a queue to make sure your requests are executed in series. After you call `commit` or `rollback`, connection is then released back to the connection pool.
 
@@ -953,8 +931,7 @@ transaction.begin(function(err) {
 
 ---------------------------------------
 
-<a name="begin" />
-### begin([isolationLevel], [callback])
+### begin ([isolationLevel], [callback])
 
 Begin a transaction.
 
@@ -978,8 +955,7 @@ __Errors__
 
 ---------------------------------------
 
-<a name="commit" />
-### commit([callback])
+### commit ([callback])
 
 Commit a transaction.
 
@@ -1006,8 +982,7 @@ __Errors__
 
 ---------------------------------------
 
-<a name="rollback" />
-### rollback([callback])
+### rollback ([callback])
 
 Rollback a transaction. If the queue isn't empty, all queued requests will be Cancelled and the transaction will be marked as aborted.
 
@@ -1032,8 +1007,7 @@ __Errors__
 - ENOTBEGUN (`TransactionError`) - Transaction has not begun.
 - EREQINPROG (`TransactionError`) - Can't rollback transaction. There is a request in progress.
 
-<a name="prepared-statement" />
-## PreparedStatement
+## Prepared Statement
 
 **IMPORTANT:** always use `PreparedStatement` class to create prepared statements - it ensures that all your executions of prepared statement are executed on one connection. Once you call `prepare`, a single connection is acquired from the connection pool and all subsequent executions are executed exclusively on this connection. Prepared Statement also contains a queue to make sure your executions are executed in series. After you call `unprepare`, the connection is then released back to the connection pool.
 
@@ -1068,8 +1042,7 @@ ps.prepare('select @param as value', function(err) {
 
 ---------------------------------------
 
-<a name="prepared-statement-input" />
-### input(name, type)
+### input (name, type)
 
 Add an input parameter to the prepared statement.
 
@@ -1091,8 +1064,7 @@ __Errors__ (synchronous)
 
 ---------------------------------------
 
-<a name="prepared-statement-output" />
-### output(name, type)
+### output (name, type)
 
 Add an output parameter to the prepared statement.
 
@@ -1114,8 +1086,7 @@ __Errors__ (synchronous)
 
 ---------------------------------------
 
-<a name="prepare" />
-### prepare(statement, [callback])
+### prepare (statement, [callback])
 
 Prepare a statement.
 
@@ -1140,8 +1111,7 @@ __Errors__
 
 ---------------------------------------
 
-<a name="prepared-statement-execute" />
-### execute(values, [callback])
+### execute (values, [callback])
 
 Execute a prepared statement.
 
@@ -1240,8 +1210,7 @@ __Errors__
 
 ---------------------------------------
 
-<a name="unprepare" />
-### unprepare([callback])
+### unprepare ([callback])
 
 Unprepare a prepared statement.
 
@@ -1267,7 +1236,6 @@ ps.prepare('select @param as value', function(err, recordsets) {
 __Errors__
 - ENOTPREPARED (`PreparedStatementError`) - Statement is not prepared.
 
-<a name="cli" />
 ## CLI
 
 Before you can start using CLI, you must install `mssql` globally with `npm install mssql -g`. Once you do that you will be able to execute `mssql` command.
@@ -1311,7 +1279,6 @@ __Version__
 
 2.0
 
-<a name="geography" />
 ## Geography and Geometry
 
 node-mssql has built-in serializer for Geography and Geometry CLR data types.
@@ -1342,7 +1309,6 @@ Results in:
   segments: [] }
 ```
 
-<a name="tvp" />
 ## Table-Valued Parameter (TVP)
 
 Supported on SQL Server 2008 and later. You can pass a data table as a parameter to stored procedure. First, we have to create custom type in our database.
@@ -1384,7 +1350,6 @@ request.execute('MyCustomStoredProcedure', function(err, recordsets, returnValue
 
 **TIP**: You can also create Table variable from any recordset with `recordset.toTable()`.
 
-<a name="affected-rows">
 ## Affected Rows
 
 If you're performing `INSERT`, `UPDATE` or `DELETE` in a query, you can read number of affected rows.
@@ -1424,8 +1389,7 @@ __Version__
 
 3.0
 
-<a name="json" />
-## JSON support (works only with Tedious driver)
+## JSON support
 
 SQL Server 2016 introduced built-in JSON serialization. By default, JSON is returned as a plain text in a special column named `JSON_F52E2B61-18A1-11d1-B105-00805F49916B`.
 
@@ -1457,7 +1421,6 @@ __Version__
 
 2.3
 
-<a name="errors" />
 ## Errors
 
 There are 4 types of errors you can handle:
@@ -1506,13 +1469,40 @@ Name | Code | Message
 SQL errors (`RequestError` with `err.code` equal to `EREQUEST`) contains additional details.
 
 - **err.number** - The error number.
-- **err.state** - The error state, used as a modifier to the error number.
+- **err.state** - The error state, used as a modifier to the number.
 - **err.class** - The class (severity) of the error. A class of less than 10 indicates an informational message. Detailed explanation can be found [here](https://msdn.microsoft.com/en-us/library/dd304156.aspx).
 - **err.lineNumber** - The line number in the SQL batch or stored procedure that caused the error. Line numbers begin at 1; therefore, if the line number is not applicable to the message, the value of LineNumber will be 0.
 - **err.serverName** - The server name.
 - **err.procName** - The stored procedure name.
 
-<a name="meta" />
+## Informational messages
+
+To receive informational messages generated by `PRINT` or `RAISERROR` commands use:
+
+```javascript
+var request = new sql.Request();
+request.on('info', function(info) {
+	console.dir(info);
+});
+request.query('print \'Hello world.\';', function(err, recordset) {
+    // ...
+});
+```
+
+Structure of informational message:
+
+- **info.message** - Message.
+- **info.number** - The message number.
+- **info.state** - The message state, used as a modifier to the number.
+- **info.class** - The class (severity) of the message. Equal or lower than 10. Detailed explanation can be found [here](https://msdn.microsoft.com/en-us/library/dd304156.aspx).
+- **info.lineNumber** - The line number in the SQL batch or stored procedure that generated the message. Line numbers begin at 1; therefore, if the line number is not applicable to the message, the value of LineNumber will be 0.
+- **info.serverName** - The server name.
+- **info.procName** - The stored procedure name.
+
+__Version__
+
+3.3
+
 ## Metadata
 
 Recordset metadata are accessible through the `recordset.columns` property.
@@ -1556,7 +1546,6 @@ Columns structure for example above:
 }
 ```
 
-<a name="data-types" />
 ## Data Types
 
 You can define data types with length/precision/scale:
@@ -1621,7 +1610,6 @@ sql.Geometry
 
 To setup MAX length for `VarChar`, `NVarChar` and `VarBinary` use `sql.MAX` length. Types `sql.XML` and `sql.Variant` are not supported as input parameters.
 
-<a name="injection" />
 ## SQL injection
 
 This module has built-in SQL injection protection. Always use parameters to pass sanitized values to your queries.
@@ -1634,7 +1622,6 @@ request.query('select @myval as myval', function(err, recordset) {
 });
 ```
 
-<a name="verbose" />
 ## Verbose Mode
 
 You can enable verbose mode by `request.verbose = true` command.
@@ -1669,35 +1656,36 @@ Output for the example above could look similar to this.
 ---------- completed ----------
 ```
 
-<a name="issues" />
 ## Known issues
 
 ### Tedious
 
 - If you're facing problems with connecting SQL Server 2000, try setting the default TDS version to 7.1 with `config.options.tdsVersion = '7_1'` ([issue](https://github.com/patriksimek/node-mssql/issues/36))
-- If you're executing a statement longer than 4000 chars on SQL Server 2000, always use [batch](#batch) instead of [query](#query) ([issue](https://github.com/patriksimek/node-mssql/issues/68))
+- If you're executing a statement longer than 4000 chars on SQL Server 2000, always use [batch](#batch-batch-callback) instead of [query](#query-command-callback) ([issue](https://github.com/patriksimek/node-mssql/issues/68))
 
 ### msnodesqlv8
 
 - msnodesqlv8 has problem with errors during transactions - [reported](https://github.com/patriksimek/node-mssql/issues/77).
 - msnodesqlv8 doesn't timeout the connection reliably - [reported](https://github.com/TimelordUK/node-sqlserver-v8/issues/9).
-- msnodesqlv8 doesn't support [TVP](#tvp) data type.
+- msnodesqlv8 doesn't support [TVP](#table-valued-parameter-tvp) data type.
 - msnodesqlv8 doesn't support Variant data type.
 - msnodesqlv8 doesn't support request timeout.
 - msnodesqlv8 doesn't support request cancellation.
 - msnodesqlv8 doesn't support [detailed SQL errors](#detailed-sql-errors).
+- msnodesqlv8 doesn't support [Informational messages](#informational-messages).
 
 ### msnodesql
 
 - msnodesql has problem with errors during transactions - [reported](https://github.com/patriksimek/node-mssql/issues/77).
 - msnodesql contains bug in DateTimeOffset ([reported](https://github.com/Azure/node-sqlserver/issues/160))
-- msnodesql doesn't support [Bulk](#bulk) load.
-- msnodesql doesn't support [TVP](#tvp) data type.
+- msnodesql doesn't support [Bulk](#bulk-table-callback) load.
+- msnodesql doesn't support [TVP](#table-valued-parameter-tvp) data type.
 - msnodesql doesn't support Variant data type.
 - msnodesql doesn't support connection timeout.
 - msnodesql doesn't support request timeout.
 - msnodesql doesn't support request cancellation.
 - msnodesql doesn't support [detailed SQL errors](#detailed-sql-errors).
+- msnodesql doesn't support [Informational messages](#informational-messages).
 - msnodesql reports invalid number of affected rows in some cases.
 
 ### node-tds
@@ -1710,20 +1698,19 @@ Output for the example above could look similar to this.
 - node-tds doesn't support Binary, VarBinary and Image as parameters.
 - node-tds always return date/time values in local time.
 - node-tds has serious problems with MAX types.
-- node-tds doesn't support [Bulk](#bulk) load.
-- node-tds doesn't support [TVP](#tvp) data type.
+- node-tds doesn't support [Bulk](#bulk-table-callback) load.
+- node-tds doesn't support [TVP](#table-valued-parameter-tvp) data type.
 - node-tds doesn't support Variant data type.
 - node-tds doesn't support request timeout.
-- node-tds doesn't support [built-in JSON serialization](#json) introduced in SQL Server 2016.
+- node-tds doesn't support [built-in JSON serialization](#json-support) introduced in SQL Server 2016.
 - node-tds doesn't support [detailed SQL errors](#detailed-sql-errors).
 - node-tds doesn't support [Affected Rows](#affected-rows)
 
-<a name="twotothree" />
 ## 2.x to 3.x changes
 
 ### Prepared Statement
 
-* [`execute`](#prepared-statement-execute) method now returns 3 arguments instead of 2.
+* [`execute`](#execute-values-callback) method now returns 3 arguments instead of 2.
 
     ```javascript
     ps.execute(values, function(err, recordset, affected) { });
@@ -1737,7 +1724,7 @@ Output for the example above could look similar to this.
 
 ### Request
 
-* [`execute`](#execute) method now returns 4 arguments instead of 3.
+* [`execute`](#execute-procedure-callback) method now returns 4 arguments instead of 3.
 
     ```javascript
     ps.execute(values, function(err, recordset, returnValue, affected) { });
@@ -1749,7 +1736,7 @@ Output for the example above could look similar to this.
     request.on('done', function(returnValue, affected) { });
     ```
 
-* [`query`](#query) method now returns 3 arguments instead of 2.
+* [`query`](#query-command-callback) method now returns 3 arguments instead of 2.
 
     ```javascript
     ps.execute(values, function(err, recordset, affected) { });
@@ -1761,7 +1748,6 @@ Output for the example above could look similar to this.
     request.on('done', function(affected) { });
     ```
 
-<a name="license" />
 ## License
 
 Copyright (c) 2013-2016 Patrik Simek

package/lib/connectionstring.js

@@ -186,7 +186,7 @@
   };
 
   resolveConnectionString = function(string) {
-    var config, parsed, ref, ref1, ref10, ref11, ref12, ref13, ref14, ref2, ref3, ref4, ref5, ref6, ref7, ref8, ref9, server, user;
+    var config, parsed, ref, ref1, ref10, ref11, ref12, ref13, ref14, ref15, ref16, ref17, ref2, ref3, ref4, ref5, ref6, ref7, ref8, ref9, server, user;
     if (/^(mssql|tedious|msnodesql|tds)\:\/\//i.test(string)) {
       parsed = parseConnectionURI(string);
     } else {
@@ -211,13 +211,22 @@
       driver: parsed.driver,
       password: (ref6 = parsed.pwd) != null ? ref6 : parsed.password,
       database: (ref7 = parsed.database) != null ? ref7 : parsed['initial catalog'],
-      connectionTimeout: (ref8 = (ref9 = parsed.timeout) != null ? ref9 : parsed['connect timeout']) != null ? ref8 : parsed['connection timeout'],
-      requestTimeout: parsed['request timeout'],
-      stream: (ref10 = (ref11 = parsed.stream) != null ? ref11.toLowerCase() : void 0) === 'true' || ref10 === 'yes' || ref10 === '1',
+      connectionTimeout: (ref8 = (ref9 = (ref10 = parsed.connectionTimeout) != null ? ref10 : parsed.timeout) != null ? ref9 : parsed['connect timeout']) != null ? ref8 : parsed['connection timeout'],
+      requestTimeout: (ref11 = parsed.requestTimeout) != null ? ref11 : parsed['request timeout'],
+      stream: (ref12 = (ref13 = parsed.stream) != null ? ref13.toLowerCase() : void 0) === 'true' || ref12 === 'yes' || ref12 === '1',
       options: {
-        encrypt: (ref12 = (ref13 = parsed.encrypt) != null ? ref13.toLowerCase() : void 0) === 'true' || ref12 === 'yes' || ref12 === '1'
+        encrypt: (ref14 = (ref15 = parsed.encrypt) != null ? ref15.toLowerCase() : void 0) === 'true' || ref14 === 'yes' || ref14 === '1'
       }
     };
+    if (parsed.useUTC != null) {
+      config.options.useUTC = (ref16 = parsed.useUTC.toLowerCase()) === 'true' || ref16 === 'yes' || ref16 === '1';
+    }
+    if (config.connectionTimeout != null) {
+      config.connectionTimeout = parseInt(config.connectionTimeout);
+    }
+    if (config.requestTimeout != null) {
+      config.requestTimeout = parseInt(config.requestTimeout);
+    }
     if (/^(.*)\\(.*)$/.exec(user)) {
       config.domain = RegExp.$1;
       user = RegExp.$2;
@@ -238,7 +247,7 @@
         server = RegExp.$1.trim();
         config.port = parseInt(RegExp.$2.trim());
       }
-      if ((ref14 = server.toLowerCase()) === '.' || ref14 === '(.)' || ref14 === '(localdb)' || ref14 === '(local)') {
+      if ((ref17 = server.toLowerCase()) === '.' || ref17 === '(.)' || ref17 === '(localdb)' || ref17 === '(local)') {
         server = 'localhost';
       }
     }

package/lib/msnodesql.js

@@ -429,10 +429,28 @@
                 _this._log("---------- response -----------");
               }
               req.on('meta', function(metadata) {
-                var ref1;
+                var error, ex, ref1;
                 if (row) {
                   if (isChunkedRecordset) {
-                    row[columns[0].name] = chunksBuffer.join('');
+                    if (columns[0].name === JSON_COLUMN_ID && _this.connection.config.parseJSON === true) {
+                      try {
+                        row = JSON.parse(chunksBuffer.join(''));
+                        if (!_this.stream) {
+                          recordsets[recordsets.length - 1][0] = row;
+                        }
+                      } catch (error) {
+                        ex = error;
+                        row = null;
+                        ex = RequestError(new Error("Failed to parse incoming JSON. " + ex.message), 'EJSON');
+                        if (_this.stream) {
+                          _this.emit('error', ex);
+                        } else {
+                          console.error(ex);
+                        }
+                      }
+                    } else {
+                      row[columns[0].name] = chunksBuffer.join('');
+                    }
                     chunksBuffer = null;
                   }
                   if (_this.verbose) {
@@ -528,11 +546,29 @@
                 return typeof callback === "function" ? callback(e) : void 0;
               });
               return req.once('done', function() {
-                var elapsed, last, ref1, ref2;
+                var elapsed, error, ex, last, ref1, ref2;
                 if (!_this.nested) {
                   if (row) {
                     if (isChunkedRecordset) {
-                      row[columns[0].name] = chunksBuffer.join('');
+                      if (columns[0].name === JSON_COLUMN_ID && _this.connection.config.parseJSON === true) {
+                        try {
+                          row = JSON.parse(chunksBuffer.join(''));
+                          if (!_this.stream) {
+                            recordsets[recordsets.length - 1][0] = row;
+                          }
+                        } catch (error) {
+                          ex = error;
+                          row = null;
+                          ex = RequestError(new Error("Failed to parse incoming JSON. " + ex.message), 'EJSON');
+                          if (_this.stream) {
+                            _this.emit('error', ex);
+                          } else {
+                            console.error(ex);
+                          }
+                        }
+                      } else {
+                        row[columns[0].name] = chunksBuffer.join('');
+                      }
                       chunksBuffer = null;
                     }
                     if (_this.verbose) {

package/lib/msnodesqlv8.js

@@ -519,10 +519,28 @@
                 _this._log("---------- response -----------");
               }
               req.on('meta', function(metadata) {
-                var ref1;
+                var error, ex, ref1;
                 if (row) {
                   if (isChunkedRecordset) {
-                    row[columns[0].name] = chunksBuffer.join('');
+                    if (columns[0].name === JSON_COLUMN_ID && _this.connection.config.parseJSON === true) {
+                      try {
+                        row = JSON.parse(chunksBuffer.join(''));
+                        if (!_this.stream) {
+                          recordsets[recordsets.length - 1][0] = row;
+                        }
+                      } catch (error) {
+                        ex = error;
+                        row = null;
+                        ex = RequestError(new Error("Failed to parse incoming JSON. " + ex.message), 'EJSON');
+                        if (_this.stream) {
+                          _this.emit('error', ex);
+                        } else {
+                          console.error(ex);
+                        }
+                      }
+                    } else {
+                      row[columns[0].name] = chunksBuffer.join('');
+                    }
                     chunksBuffer = null;
                   }
                   if (_this.verbose) {
@@ -618,11 +636,29 @@
                 return typeof callback === "function" ? callback(e) : void 0;
               });
               return req.once('done', function() {
-                var elapsed, last, ref1, ref2;
+                var elapsed, error, ex, last, ref1, ref2;
                 if (!_this.nested) {
                   if (row) {
                     if (isChunkedRecordset) {
-                      row[columns[0].name] = chunksBuffer.join('');
+                      if (columns[0].name === JSON_COLUMN_ID && _this.connection.config.parseJSON === true) {
+                        try {
+                          row = JSON.parse(chunksBuffer.join(''));
+                          if (!_this.stream) {
+                            recordsets[recordsets.length - 1][0] = row;
+                          }
+                        } catch (error) {
+                          ex = error;
+                          row = null;
+                          ex = RequestError(new Error("Failed to parse incoming JSON. " + ex.message), 'EJSON');
+                          if (_this.stream) {
+                            _this.emit('error', ex);
+                          } else {
+                            console.error(ex);
+                          }
+                        }
+                      } else {
+                        row[columns[0].name] = chunksBuffer.join('');
+                      }
                       chunksBuffer = null;
                     }
                     if (_this.verbose) {

package/lib/tds.js

@@ -551,6 +551,17 @@
                   return typeof callback === "function" ? callback(error, _this.multiple || _this.nested ? recordsets : recordsets[0]) : void 0;
                 }
               });
+              req.on('message', function(msg) {
+                return _this.emit('info', {
+                  message: msg.text,
+                  number: msg.number,
+                  state: msg.state,
+                  "class": msg.severity,
+                  lineNumber: msg.lineNumber,
+                  serverName: msg.serverName,
+                  procName: msg.procName
+                });
+              });
               req.on('error', function(err) {
                 var e;
                 e = RequestError(err, 'EREQUEST');

package/lib/tedious.js

@@ -551,7 +551,7 @@
        */
 
       TediousRequest.prototype.bulk = function(table, callback) {
-        var errorHandlers, errors, handleError, hasReturned, started;
+        var errorHandlers, errors, handleError, handleInfo, hasReturned, started;
         table._makeBulk();
         if (!table.name) {
           process.nextTick(function() {
@@ -593,6 +593,19 @@
             return errors.push(e);
           };
         })(this);
+        handleInfo = (function(_this) {
+          return function(msg) {
+            return _this.emit('info', {
+              message: msg.message,
+              number: msg.number,
+              state: msg.state,
+              "class": msg["class"],
+              lineNumber: msg.lineNumber,
+              serverName: msg.serverName,
+              procName: msg.procName
+            });
+          };
+        })(this);
         return this._acquire((function(_this) {
           return function(err, connection) {
             var bulk, col, done, i, j, len, len1, objectid, ref1, ref2, req, row;
@@ -613,8 +626,10 @@
                 }
                 return connection.cancel();
               };
+              errorHandlers['infoMessage'] = handleInfo;
               errorHandlers['errorMessage'] = handleError.bind(void 0, false, connection);
               errorHandlers['error'] = handleError.bind(void 0, true, connection);
+              connection.on('infoMessage', errorHandlers['infoMessage']);
               connection.on('errorMessage', errorHandlers['errorMessage']);
               connection.on('error', errorHandlers['error']);
               done = bindDomain(function(err, rowCount) {
@@ -702,7 +717,7 @@
        */
 
       TediousRequest.prototype.query = function(command, callback) {
-        var batchHasOutput, batchLastRow, chunksBuffer, columns, errorHandlers, errors, handleError, hasReturned, isChunkedRecordset, isJSONRecordset, recordset, recordsets, started, xmlBuffer;
+        var batchHasOutput, batchLastRow, chunksBuffer, columns, errorHandlers, errors, handleError, handleInfo, hasReturned, isChunkedRecordset, isJSONRecordset, recordset, recordsets, started, xmlBuffer;
         columns = {};
         recordset = [];
         recordsets = [];
@@ -742,6 +757,19 @@
             return errors.push(e);
           };
         })(this);
+        handleInfo = (function(_this) {
+          return function(msg) {
+            return _this.emit('info', {
+              message: msg.message,
+              number: msg.number,
+              state: msg.state,
+              "class": msg["class"],
+              lineNumber: msg.lineNumber,
+              serverName: msg.serverName,
+              procName: msg.procName
+            });
+          };
+        })(this);
         return this._acquire((function(_this) {
           return function(err, connection) {
             var assigns, declarations, doneHandler, name, param, ref1, ref2, req, selects, value;
@@ -762,8 +790,10 @@
                 }
                 return connection.cancel();
               };
+              errorHandlers['infoMessage'] = handleInfo;
               errorHandlers['errorMessage'] = handleError.bind(void 0, false, connection);
               errorHandlers['error'] = handleError.bind(void 0, true, connection);
+              connection.on('infoMessage', errorHandlers['infoMessage']);
               connection.on('errorMessage', errorHandlers['errorMessage']);
               connection.on('error', errorHandlers['error']);
               req = new tds.Request(command, bindDomain(function(err) {

package/package.json

@@ -21,7 +21,7 @@
 		"azure",
 		"node-mssql"
 	],
-	"version": "3.2.1",
+	"version": "3.3.0",
 	"main": "index.js",
 	"repository": {
 		"type": "git",

package/src/connectionstring.coffee

@@ -159,7 +159,7 @@ resolveConnectionString = (string) ->
 		parsed = parseConnectionURI string
 	else
 		parsed = parseConnectionString string
-	
+
 	if parsed.driver is 'msnodesql'
 		parsed.driver = 'SQL Server Native Client 11.0'
 		parsed.__original__?.driver = name: 'Driver', escape: ['{', '}']
@@ -172,11 +172,15 @@ resolveConnectionString = (string) ->
 		driver: parsed.driver
 		password: parsed.pwd ? parsed.password
 		database: parsed.database ? parsed['initial catalog']
-		connectionTimeout: parsed.timeout ? parsed['connect timeout'] ? parsed['connection timeout']
-		requestTimeout: parsed['request timeout']
+		connectionTimeout: parsed.connectionTimeout ? parsed.timeout ? parsed['connect timeout'] ? parsed['connection timeout']
+		requestTimeout: parsed.requestTimeout ? parsed['request timeout']
 		stream: parsed.stream?.toLowerCase() in ['true', 'yes', '1']
 		options:
 			encrypt: parsed.encrypt?.toLowerCase() in ['true', 'yes', '1']
+
+	if parsed.useUTC? then config.options.useUTC = parsed.useUTC.toLowerCase() in ['true', 'yes', '1']
+	if config.connectionTimeout? then config.connectionTimeout = parseInt config.connectionTimeout
+	if config.requestTimeout? then config.requestTimeout = parseInt config.requestTimeout
 	
 	if (/^(.*)\\(.*)$/).exec user
 		config.domain = RegExp.$1

package/src/msnodesql.coffee

@@ -249,7 +249,23 @@ module.exports = (Connection, Transaction, Request, ConnectionError, Transaction
 					req.on 'meta', (metadata) =>
 						if row
 							if isChunkedRecordset
-								row[columns[0].name] = chunksBuffer.join ''
+								if columns[0].name is JSON_COLUMN_ID and @connection.config.parseJSON is true
+									try
+										row = JSON.parse chunksBuffer.join('')
+										if not @stream then recordsets[recordsets.length - 1][0] = row
+									catch ex
+										row = null
+										ex = RequestError new Error("Failed to parse incoming JSON. #{ex.message}"), 'EJSON'
+										
+										if @stream
+											@emit 'error', ex
+										
+										else
+											console.error ex
+								
+								else
+									row[columns[0].name] = chunksBuffer.join ''
+								
 								chunksBuffer = null
 								
 							if @verbose
@@ -341,7 +357,23 @@ module.exports = (Connection, Transaction, Request, ConnectionError, Transaction
 						unless @nested
 							if row
 								if isChunkedRecordset
-									row[columns[0].name] = chunksBuffer.join ''
+									if columns[0].name is JSON_COLUMN_ID and @connection.config.parseJSON is true
+										try
+											row = JSON.parse chunksBuffer.join('')
+											if not @stream then recordsets[recordsets.length - 1][0] = row
+										catch ex
+											row = null
+											ex = RequestError new Error("Failed to parse incoming JSON. #{ex.message}"), 'EJSON'
+											
+											if @stream
+												@emit 'error', ex
+											
+											else
+												console.error ex
+									
+									else
+										row[columns[0].name] = chunksBuffer.join ''
+									
 									chunksBuffer = null
 								
 								if @verbose

package/src/msnodesqlv8.coffee

@@ -322,7 +322,23 @@ module.exports = (Connection, Transaction, Request, ConnectionError, Transaction
 					req.on 'meta', (metadata) =>
 						if row
 							if isChunkedRecordset
-								row[columns[0].name] = chunksBuffer.join ''
+								if columns[0].name is JSON_COLUMN_ID and @connection.config.parseJSON is true
+									try
+										row = JSON.parse chunksBuffer.join('')
+										if not @stream then recordsets[recordsets.length - 1][0] = row
+									catch ex
+										row = null
+										ex = RequestError new Error("Failed to parse incoming JSON. #{ex.message}"), 'EJSON'
+										
+										if @stream
+											@emit 'error', ex
+										
+										else
+											console.error ex
+								
+								else
+									row[columns[0].name] = chunksBuffer.join ''
+								
 								chunksBuffer = null
 								
 							if @verbose
@@ -414,7 +430,23 @@ module.exports = (Connection, Transaction, Request, ConnectionError, Transaction
 						unless @nested
 							if row
 								if isChunkedRecordset
-									row[columns[0].name] = chunksBuffer.join ''
+									if columns[0].name is JSON_COLUMN_ID and @connection.config.parseJSON is true
+										try
+											row = JSON.parse chunksBuffer.join('')
+											if not @stream then recordsets[recordsets.length - 1][0] = row
+										catch ex
+											row = null
+											ex = RequestError new Error("Failed to parse incoming JSON. #{ex.message}"), 'EJSON'
+											
+											if @stream
+												@emit 'error', ex
+											
+											else
+												console.error ex
+									
+									else
+										row[columns[0].name] = chunksBuffer.join ''
+									
 									chunksBuffer = null
 								
 								if @verbose

package/src/tds.coffee

@@ -385,6 +385,16 @@ module.exports = (Connection, Transaction, Request, ConnectionError, Transaction
 						else
 							callback? error, if @multiple or @nested then recordsets else recordsets[0]
 					
+					req.on 'message', (msg) =>
+						@emit 'info',
+							message: msg.text
+							number: msg.number
+							state: msg.state
+							class: msg.severity
+							lineNumber: msg.lineNumber
+							serverName: msg.serverName
+							procName: msg.procName
+					
 					req.on 'error', (err) =>
 						e = RequestError err, 'EREQUEST'
 						

package/src/tedious.coffee

@@ -386,6 +386,16 @@ module.exports = (Connection, Transaction, Request, ConnectionError, Transaction
 
 				# we must collect errors even in stream mode
 				errors.push e
+			
+			handleInfo = (msg) =>
+				@emit 'info',
+					message: msg.message
+					number: msg.number
+					state: msg.state
+					class: msg.class
+					lineNumber: msg.lineNumber
+					serverName: msg.serverName
+					procName: msg.procName
 
 			@_acquire (err, connection) =>
 				unless err
@@ -401,8 +411,10 @@ module.exports = (Connection, Transaction, Request, ConnectionError, Transaction
 						connection.cancel()
 					
 					# attach handler to handle multiple error messages
+					errorHandlers['infoMessage'] = handleInfo
 					errorHandlers['errorMessage'] = handleError.bind(undefined, false, connection)
 					errorHandlers['error']        = handleError.bind(undefined, true, connection)
+					connection.on 'infoMessage', errorHandlers['infoMessage']
 					connection.on 'errorMessage', errorHandlers['errorMessage']
 					connection.on 'error',        errorHandlers['error']
 
@@ -510,6 +522,16 @@ module.exports = (Connection, Transaction, Request, ConnectionError, Transaction
 				# we must collect errors even in stream mode
 				errors.push e
 			
+			handleInfo = (msg) =>
+				@emit 'info',
+					message: msg.message
+					number: msg.number
+					state: msg.state
+					class: msg.class
+					lineNumber: msg.lineNumber
+					serverName: msg.serverName
+					procName: msg.procName
+			
 			@_acquire (err, connection) =>
 				unless err
 					if @verbose then @_log "---------- sql #{if @_isBatch then 'batch' else 'query'} ----------\n    #{if @_isBatch then 'batch' else 'query'}: #{command}"
@@ -524,8 +546,10 @@ module.exports = (Connection, Transaction, Request, ConnectionError, Transaction
 						connection.cancel()
 					
 					# attach handler to handle multiple error messages
+					errorHandlers['infoMessage'] = handleInfo
 					errorHandlers['errorMessage'] = handleError.bind(undefined, false, connection)
 					errorHandlers['error']        = handleError.bind(undefined, true, connection)
+					connection.on 'infoMessage', errorHandlers['infoMessage']
 					connection.on 'errorMessage', errorHandlers['errorMessage']
 					connection.on 'error',        errorHandlers['error']