oracledb 2.1.0 → 2.3.0

package/CHANGELOG.md

@@ -1,19 +1,141 @@
 # Change Log
 
+## node-oracledb v2.3.0 (7 Jun 2018)
+
+- The stated compatibility is now for Node.js 6, 8, and 10 due to EOL
+  of Node.js 4, and the release of Node 10.
+
+- Added support for heterogeneous connection pooling and for proxy
+  support in connection pools.  This allows each connection in the
+  pool to use different database credentials.
+
+- Added support for Oracle Database Continuous Query Notifications,
+  allowing JavaScript methods to be called when database changes are
+  committed.
+
+- Added support to `fetchAsString` and `fetchInfo` for fetching RAW
+  columns as STRING (hex-encoded).
+
+- Added Windows support for building binary packages for self-hosting
+  on internal networks. PR #891 (Danilo Silva).
+
+- Eliminated a memory leak when binding LOBs as `oracledb.BIND_INOUT`.
+
+- Added an error message indicating that `batchErrors` and
+  `dmlRowCounts` can only be used with INSERT, UPDATE, DELETE and
+  MERGE statements.
+
+- Fixed a bug that caused `queryStream()` to emit multiple close
+  events in Node.js 10.
+
+- Fixed a crash when getting the list of names for an undefined object
+  with Node.js 6.
+
+- Remove deprecated `Buffer()` function in tests in order to eliminate
+  a deprecation warning with Node.js 10.
+
+- Upgraded NAN dependency from 2.8 to 2.10.
+
+- Made some internal changes to fix NAN 2.10 deprecations: Replaced
+  `v8::String::Utf8Value` with `Nan::Uft8String`.  Replaced
+  `MakeCallback()` with `runInAsyncScope()`.
+
+- Mention that `queueRequests` is deprecated and will be removed in a
+  future version; connection pool queuing will always be enabled in
+  that future version.
+
+## node-oracledb v2.2.0 (3 Apr 2018)
+
+- Added
+  [`oracledb.oracleClientVersionString`](https://oracle.github.io/node-oracledb/doc/api.html#propdboracleclientversionstring)
+  and
+  [`connection.oracleServerVersionString`](https://oracle.github.io/node-oracledb/doc/api.html#propconnoracleserverversionstring)
+  to complement the existing numeric properties.
+
+- Added
+  [`oracledb.edition`](https://oracle.github.io/node-oracledb/doc/api.html#propdbedition)
+  to support Edition-Based Redefinition.  This removes the need to use
+  an `ALTER SESSION` command or `ORA_EDITION` environment variable.
+
+- Added
+  [`oracledb.events`](https://oracle.github.io/node-oracledb/doc/api.html#propdbevents)
+  to allow the Oracle client library to receive Oracle Database
+  service events, such as FAN and RLB events.  This removes the need
+  to use an `oraaccess.xml` file to enable event handling.
+
+- Added
+  [`connection.changePassword()`](https://oracle.github.io/node-oracledb/doc/api.html#changingpassword)
+  for changing passwords, and also added support for changing the
+  password during `oracledb.getConnection()`.
+
+- Added
+  [`connection.executeMany()`](https://oracle.github.io/node-oracledb/doc/api.html#executemany)
+  for efficient batch DML (e.g. INSERT, UPDATE and DELETE) and PL/SQL
+  execution with multiple records.
+
+- Added
+  [`connection.getStatementInfo()`](https://oracle.github.io/node-oracledb/doc/api.html#getstmtinfo)
+  to find information about a SQL statement without executing it.
+
+- Added
+  [`connection.ping()`](https://oracle.github.io/node-oracledb/doc/api.html#connectionping)
+  to support system health checks.
+
+- Added support for binding RAW types into Buffers in DML RETURNING statements.
+
+- Created GitHub 'pages' for hosting documentation.  See:
+    - https://oracle.github.io/node-oracledb
+    - https://oracle.github.io/node-oracledb/INSTALL.html
+    - https://oracle.github.io/node-oracledb/doc/api.html
+
+- Simplified the binary installer messages to reduce user uncertainty.
+
+- Improved the text for the NJS-045 runtime loader failure error.
+
+- Made the implementations of `connection.close()` and `pool.close()`
+  the primary code paths in place of their respective aliases
+  `connection.release()` and `pool.terminate()`.
+
+- An empty object for `fetchInfo` no longer produces an error.
+
+- Updated database abstraction layer to ODPI-C 2.3
+
+- Fixed compilation warnings on Windows.
+
+- Updated the node-oracledb implementation to replace V8 deprecations.
+
+## node-oracledb v2.1.2 (21 Feb 2018)
+
+- Fixed regression with end-to-end tracing attributes not being set.
+
+- Fix binary installer proxy 403 (Bruno Jouhier)
+
+## node-oracledb v2.1.1 (16 Feb 2018)
+
+- Fixed regression with querystream() in Node 4 & 6.
+  https://github.com/oracle/node-oracledb/issues/847
+
 ## node-oracledb v2.1.0 (15 Feb 2018)
 
-- Added support for privileged standalone connections: SYSDBA,
-  SYSOPER, SYSASM, SYSBACKUP, SYSDG, SYSKM, and SYSRAC
+- Added support for [privileged standalone
+  connections](https://oracle.github.io/node-oracledb/doc/api.html#privconn):
+  SYSDBA, SYSOPER, SYSASM, SYSBACKUP, SYSDG, SYSKM, and SYSRAC
 
-- Improved the Error object with new `errorNum` and `offset`
-  properties for Oracle errors.
+- Improved the
+  [Error](https://oracle.github.io/node-oracledb/doc/api.html#properror)
+  object with new `errorNum` and `offset` properties for Oracle
+  errors.
 
-- Added new `versionString` and `versionSuffix` attributes to aid
-  showing node-oracledb version and release status.
+- Added new
+  [`versionString`](https://oracle.github.io/node-oracledb/doc/api.html#propdbversionstring)
+  and
+  [`versionSuffix`](https://oracle.github.io/node-oracledb/doc/api.html#propdbversionsuffix)
+  attributes to aid showing node-oracledb version and release status.
 
-- Added `connectionString` as an alias for `connectString` in
-  `oracledb.createPool()` and `oracledb.getConnection()` (Sagie
-  Gur-Ari).
+- Added
+  [`connectionString`](https://oracle.github.io/node-oracledb/doc/api.html#createpoolpoolattrsconnectstring)
+  as an alias for `connectString` in `oracledb.createPool()` and
+  `oracledb.getConnection()` (Sagie Gur-Ari).
 
 - Updated the ODPI-C layer:
     - Eliminate DPI-1054 errors, allowing connections to be closed when ResultSets and Lobs are open.
@@ -24,7 +146,7 @@
   This means node-oracledb 2.1 no longer builds with Node.js 0.10 or
   Node.js 0.12.
 
-- Improved `queryStream()` streaming:
+- Improved [`queryStream()`](https://oracle.github.io/node-oracledb/doc/api.html#querystream) streaming:
 
     - Add support for the Stream `destroy()` method available with Node 8.
 
@@ -48,8 +170,7 @@
 - Fixed support for integers that are larger than Node.js's 32-bit
   integer is capable of handling.
 
-- Updated
-  [INSTALL.md](https://github.com/oracle/node-oracledb/blob/master/INSTALL.md)
+- Updated [INSTALL](https://oracle.github.io/node-oracledb/INSTALL.html)
   to mention:
     - The [yum.oracle.com](http://yum.oracle.com/oracle-linux-nodejs.html) Node.js RPM Packages for Oracle Linux
     - The [Oracle mirror](oss.oracle.com/git/oracle) of [github.com/oracle](https://github.com/oracle).
@@ -68,7 +189,7 @@
 - Installation has significantly improved.  Some pre-built binaries
   are available for convenience, or the add-on can be continue to built
   from source code.  Refer to
-  [INSTALL.md](https://github.com/oracle/node-oracledb/blob/master/INSTALL.md).
+  [INSTALL](https://oracle.github.io/node-oracledb/INSTALL.html).
 
     - Added utilities to /package for building binaries for
       distribution, and for installing them.
@@ -96,7 +217,7 @@
       libraries in `$ORACLE_HOME/lib`.
 
     - A new [Troubleshooting
-      section](https://github.com/oracle/node-oracledb/blob/master/INSTALL.md#troubleshooting)
+      section](https://oracle.github.io/node-oracledb/INSTALL.html#troubleshooting)
       was add to INSTALL.
 
     - Improvements were made to `require('oracledb')` failure messages
@@ -214,23 +335,23 @@
 
 - Improved query handling:
 
-  - Enhanced direct fetches to allow an unlimited number of rows to be
-    fetched.  This occurs when `oracledb.maxRows = 0`
+    - Enhanced direct fetches to allow an unlimited number of rows to be
+      fetched.  This occurs when `oracledb.maxRows = 0`
 
-  - Changed the default value of `oracledb.maxRows` to 0, meaning
-    unlimited.
+    - Changed the default value of `oracledb.maxRows` to 0, meaning
+      unlimited.
 
-  - Replaced `prefetchRows` (used for internal fetch buffering and
-    tuning) with a new property `fetchArraySize`.  This affects direct
-    fetches, ResultSet `getRow()` and `queryStream()`.
+    - Replaced `prefetchRows` (used for internal fetch buffering and
+      tuning) with a new property `fetchArraySize`.  This affects direct
+      fetches, ResultSet `getRow()` and `queryStream()`.
 
-  - `getRows(numRows,...)` internal fetch buffering is now only tuned
-    by the `numRows` value.
+    - `getRows(numRows,...)` internal fetch buffering is now only tuned
+      by the `numRows` value.
 
-  - Implemented `getRow()` in JavaScript for better performance.
+    - Implemented `getRow()` in JavaScript for better performance.
 
-  - Moved operations on REF CURSORS out of the main thread in order to
-    improve performance and memory usage.
+    - Moved operations on REF CURSORS out of the main thread in order to
+      improve performance and memory usage.
 
 - Fixed proxy support in the binary installer.
 
@@ -265,15 +386,15 @@
 - Upgraded NAN dependency from 2.5 to 2.8.
 
 - Updated ODPI-C submodule:
-  - Reinstate safe size limit for LOB bind to PL/SQL (node-oracledb regression from v1).
-  - Fix valgrind byte overrun when loading `libclntsh` from `$ORACLE_HOME`.
-  - Do not prevent connections from being explicitly closed when a fatal error has taken place.
-  - Eliminate race condition on initialization.  Add finalization code.
-  - Eliminate use of OCI wrappers for use of mutexes, which improves performance (now uses native threading, e.g. pthreads).
-  - Prevent use of NaN with Oracle numbers to avoid data corruption.
-  - Prevent ORA-1010 during connection ping to pre 10g Oracle Database.
-  - Improve debug trace output format.
-  - Prevent crash for DML RETURNING of variables that require dynamic binding.
+    - Reinstate safe size limit for LOB bind to PL/SQL (node-oracledb regression from v1).
+    - Fix valgrind byte overrun when loading `libclntsh` from `$ORACLE_HOME`.
+    - Do not prevent connections from being explicitly closed when a fatal error has taken place.
+    - Eliminate race condition on initialization.  Add finalization code.
+    - Eliminate use of OCI wrappers for use of mutexes, which improves performance (now uses native threading, e.g. pthreads).
+    - Prevent use of NaN with Oracle numbers to avoid data corruption.
+    - Prevent ORA-1010 during connection ping to pre 10g Oracle Database.
+    - Improve debug trace output format.
+    - Prevent crash for DML RETURNING of variables that require dynamic binding.
 
 - Updated examples to avoid "DPI-1054: connection cannot be closed
   when open statements or LOBs exist" and to avoid duplicate callbacks
@@ -344,7 +465,7 @@
   database abstraction library.
 
 - Installation instructions have changed.  Refer to
-  [INSTALL.md](https://github.com/oracle/node-oracledb/blob/master/INSTALL.md).
+  [INSTALL](https://oracle.github.io/node-oracledb/INSTALL.html).
   Distribution is still via source code.
 
   Oracle header files are no longer needed.  The `OCI_LIB_DIR` and
@@ -454,21 +575,20 @@
 ## node-oracledb v1.12.0 Development (3 Dec 2016)
 
 - Significantly enhanced LOB support:
-   - Added `BIND_IN` support for DML
-   - Added `BIND_IN`, `BIND_OUT`, `BIND_INOUT` support for PL/SQL
-   - Added a `connection.createLob()` method to create temporary LOBs
-   - Added a `lob.close()` method
-   - Made enhancements to allow binding String or Buffer data as `STRING` or `BUFFER` to LOB database types
-   - Writeable LOB Streams now conclude with a 'close' event
+    - Added `BIND_IN` support for DML
+    - Added `BIND_IN`, `BIND_OUT`, `BIND_INOUT` support for PL/SQL
+    - Added a `connection.createLob()` method to create temporary LOBs
+    - Added a `lob.close()` method
+    - Made enhancements to allow binding String or Buffer data as `STRING` or `BUFFER` to LOB database types
+    - Writeable LOB Streams now conclude with a 'close' event
 
 - Added a connection pool 'ping' feature controlled with
   `oracledb.poolPingInterval` and a corresponding `createPool()`
   option. This validates pooled connections when they are returned
-  from a `getConnection()` call.  Values are
-
-     - zero: always ping for every pooled `getConnection()`
-     - negative: never ping
-     - positive: time in seconds the connection must be idle in the pool before `getConnection()` does a ping.  Default is 60 seconds
+  from a `getConnection()` call.  Values are:
+    - zero: always ping for every pooled `getConnection()`
+    - negative: never ping
+    - positive: time in seconds the connection must be idle in the pool before `getConnection()` does a ping.  Default is 60 seconds
 
   The setting is a no-op when node-oracledb is built with Oracle
   Database 12.2 client libraries, where a new, lower-level OCI feature
@@ -566,10 +686,10 @@
 - Some enhancements were made to the underlying DPI data access layer.
   **These are not exposed to node-oracledb users.**
 
-   - Allow <code>SYSDBA</code> connections
-   - Allow session tagging
-   - Allow the character set and national character set to be specified via parameters to the DPI layer.
-   - Support heterogeneous pools (in addition to existing homogeneous pools)
+    - Allow <code>SYSDBA</code> connections
+    - Allow session tagging
+    - Allow the character set and national character set to be specified via parameters to the DPI layer.
+    - Support heterogeneous pools (in addition to existing homogeneous pools)
 
 ## node-oracledb v1.9.3 (24 May 2016)
 
@@ -942,8 +1062,8 @@
 
 - High Availability Features
 
-  - Fast Application Notification (FAN)
+    - Fast Application Notification (FAN)
 
-  - Runtime Load Balancing (RLB)
+    - Runtime Load Balancing (RLB)
 
-  - Transparent Application Failover (TAF)
+    - Transparent Application Failover (TAF)

package/LICENSE.md

@@ -223,28 +223,62 @@ limitations under the License.
 # NAN
 
 ```
-Copyright (c) 2015 NAN contributors
+The MIT License (MIT)
+=====================
 
-NAN contributors listed at https://github.com/rvagg/nan#contributors
+Copyright (c) 2017 NAN contributors
+-----------------------------------
 
-Permission is hereby granted, free of charge, to any person obtaining
-a copy of this software and associated documentation files (the
-"Software"), to deal in the Software without restriction, including
-without limitation the rights to use, copy, modify, merge, publish,
-distribute, sublicense, and/or sell copies of the Software, and to
-permit persons to whom the Software is furnished to do so, subject to
-the following conditions:
+NAN contributors listed at https://github.com/nodejs/nan#contributors
 
-The above copyright notice and this permission notice shall be
-included in all copies or substantial portions of the Software.
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute,
+sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
-NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
-LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
-OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
-WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
+
+-------------------------------------------------------------------------------
+
+WG Members / Collaborators
+
+Rod Vagg - https://github.com/rvagg http://twitter.com/rvagg
+Benjamin Byholm - https://github.com/kkoopa/
+Trevor Norris - https://github.com/trevnorris http://twitter.com/trevnorris
+Nathan Rajlich - https://github.com/TooTallNate http://twitter.com/TooTallNate
+Brett Lawson - https://github.com/brett19 http://twitter.com/brett19x
+Ben Noordhuis - https://github.com/bnoordhuis http://twitter.com/bnoordhuis
+David Siegel - https://github.com/agnat http://twitter.com/agnat
+Michael Ira Krufky - https://github.com/mkrufky http://twitter.com/mkrufky
+
+-------------------------------------------------------------------------------
+
+nan_string_bytes.h:
+
+Copyright Joyent, Inc. and other Node contributors.
+
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to permit
+persons to whom the Software is furnished to do so, subject to the
+following conditions:
+
+The above copyright notice and this permission notice shall be included
+in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN
+NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
+USE OR OTHER DEALINGS IN THE SOFTWARE.
 ```
 
 # Mocha

package/README.md

@@ -1,69 +1,35 @@
-# node-oracledb version 2.1
-
-## <a name="about"></a> About node-oracledb
+# node-oracledb version 2.3
 
 The node-oracledb add-on for Node.js powers high performance Oracle
 Database applications.
 
-Use node-oracledb to connect Node.js 4, 6, 8 and 9 to Oracle Database.
-
-The add-on is stable, well documented, and has a comprehensive test suite.
-
-The node-oracledb project is open source and maintained by Oracle Corp.
+Use node-oracledb to connect Node.js 6, 8 and 10 to Oracle Database.
 
-### Node-oracledb supports:
+Node-oracledb supports basic and advanced features of Oracle Database
+and Oracle Client.  See the
+[homepage](https://oracle.github.io/node-oracledb/) for a list.
 
-- [Async/Await][2], [Promises][3], [Callbacks][4] and [Streams][5]
-- [SQL and PL/SQL execution][6]
-- [REF CURSORs][7]
-- [Large Objects: CLOBs and BLOBs as Streams or Strings and Buffers][8]
-- [Oracle Database 12c JSON datatype][9]
-- [Query results as JavaScript objects or arrays][10]
-- [Smart mapping between JavaScript and Oracle types with manual override available][11]
-- [Data binding using JavaScript types, objects or arrays][12]
-- [Transaction Management][13]
-- [Inbuilt Connection Pool with Queuing, Aliasing and Liveness checking][14]
-- [Database Resident Connection Pooling (DRCP)][15]
-- [External Authentication][16]
-- [Array Fetches][17]
-- [Statement Caching][18]
-- [Client Result Caching][19]
-- [End-to-end Tracing, Mid-tier Authentication, and Auditing][20]
-- Oracle High Availability Features
-  - [Fast Application Notification (FAN)][21]
-  - [Runtime Load Balancing (RLB)][22]
-  - [Transparent Application Failover (TAF)][23]
+The node-oracledb module is open source and maintained by Oracle Corp.
+It is stable, well documented, and has a comprehensive test suite.
 
-We are actively working on supporting the best Oracle Database
-features, and on functionality requests from [users involved in the
-project][24].
-
-## <a name="start"></a> Getting Started
+## <a name="installation"></a> Installation
 
-See [Getting Started with Node-oracledb][1].
+See [Getting Started with Node-oracledb][1] and [Quick Start Node-oracledb Installation][37].
 
-## <a name="installation"></a> Installation
+## <a name="doc"></a> Documentation
 
-See [Quick Start Node-oracledb Installation][37].
+See [Documentation for the Oracle Database Node.js Add-on][32] and the [CHANGELOG][33].
 
 ## <a name="examples"></a> Examples
 
 See the [examples][30] directory.  Start with
 [examples/select1.js][31].
 
-## <a name="doc"></a> Documentation
-
-See [Documentation for the Oracle Database Node.js Add-on][32].
-
 ## <a name="help"></a> Help
 
 Issues and questions can be raised with the node-oracledb community on
 [GitHub][24].
 
-## <a name="changes"></a> Changes
-
-See [CHANGELOG][33].
-
 ## <a name="testing"></a> Tests
 
 To run the test suite see [test/README][34].
@@ -94,35 +60,36 @@ limitations under the License.
 
 
 
-[1]: https://github.com/oracle/node-oracledb/blob/master/doc/api.md#getstarted
-[2]: https://github.com/oracle/node-oracledb/blob/master/doc/api.md#asyncawaitoverview
-[3]: https://github.com/oracle/node-oracledb/blob/master/doc/api.md#promiseoverview
-[4]: https://github.com/oracle/node-oracledb/blob/master/doc/api.md#intro
-[5]: https://github.com/oracle/node-oracledb/blob/master/doc/api.md#querystream
-[6]: https://github.com/oracle/node-oracledb/blob/master/doc/api.md#sqlexecution
-[7]: https://github.com/oracle/node-oracledb/blob/master/doc/api.md#refcursors
-[8]: https://github.com/oracle/node-oracledb/blob/master/doc/api.md#lobhandling
-[9]: https://github.com/oracle/node-oracledb/blob/master/doc/api.md#jsondatatype
-[10]: https://github.com/oracle/node-oracledb/blob/master/doc/api.md#queryoutputformats
-[11]: https://github.com/oracle/node-oracledb/blob/master/doc/api.md#typemap
-[12]: https://github.com/oracle/node-oracledb/blob/master/doc/api.md#bind
-[13]: https://github.com/oracle/node-oracledb/blob/master/doc/api.md#transactionmgt
-[14]: https://github.com/oracle/node-oracledb/blob/master/doc/api.md#connpooling
-[15]: https://github.com/oracle/node-oracledb/blob/master/doc/api.md#drcp
-[16]: https://github.com/oracle/node-oracledb/blob/master/doc/api.md#extauth
-[17]: https://github.com/oracle/node-oracledb/blob/master/doc/api.md#propdbfetcharraysize
-[18]: https://github.com/oracle/node-oracledb/blob/master/doc/api.md#stmtcache
+[1]: https://oracle.github.io/node-oracledb/doc/api.html#getstarted
+[2]: https://oracle.github.io/node-oracledb/doc/api.html#asyncawaitoverview
+[3]: https://oracle.github.io/node-oracledb/doc/api.html#promiseoverview
+[4]: https://oracle.github.io/node-oracledb/doc/api.html#intro
+[5]: https://oracle.github.io/node-oracledb/doc/api.html#querystream
+[6]: https://oracle.github.io/node-oracledb/doc/api.html#sqlexecution
+[7]: https://oracle.github.io/node-oracledb/doc/api.html#refcursors
+[8]: https://oracle.github.io/node-oracledb/doc/api.html#lobhandling
+[9]: https://oracle.github.io/node-oracledb/doc/api.html#jsondatatype
+[10]: https://oracle.github.io/node-oracledb/doc/api.html#queryoutputformats
+[11]: https://oracle.github.io/node-oracledb/doc/api.html#typemap
+[12]: https://oracle.github.io/node-oracledb/doc/api.html#bind
+[13]: https://oracle.github.io/node-oracledb/doc/api.html#transactionmgt
+[14]: https://oracle.github.io/node-oracledb/doc/api.html#connpooling
+[15]: https://oracle.github.io/node-oracledb/doc/api.html#drcp
+[16]: https://oracle.github.io/node-oracledb/doc/api.html#extauth
+[17]: https://oracle.github.io/node-oracledb/doc/api.html#propdbfetcharraysize
+[18]: https://oracle.github.io/node-oracledb/doc/api.html#stmtcache
 [19]: https://docs.oracle.com/database/122/ADFNS/performance-and-scalability.htm#ADFNS464
-[20]: https://github.com/oracle/node-oracledb/blob/master/doc/api.md#endtoend
-[21]: https://docs.oracle.com/database/122/ADFNS/high-availability.htm#ADFNS538
-[22]: https://docs.oracle.com/database/122/ADFNS/connection_strategies.htm#ADFNS515
+[20]: https://oracle.github.io/node-oracledb/doc/api.html#endtoend
+[21]: https://oracle.github.io/node-oracledb/doc/api.html#connectionfan
+[22]: https://oracle.github.io/node-oracledb/doc/api.html#connectionrlb
 [23]: https://docs.oracle.com/database/122/ADFNS/high-availability.htm#ADFNS-GUID-96599425-9BDA-483C-9BA2-4A4D13013A37
 [24]: https://github.com/oracle/node-oracledb/issues
 [30]: https://github.com/oracle/node-oracledb/blob/master/examples
 [31]: https://github.com/oracle/node-oracledb/blob/master/examples/select1.js#L35
-[32]: https://github.com/oracle/node-oracledb/blob/master/doc/api.md
+[32]: https://oracle.github.io/node-oracledb/doc/api.html
 [33]: https://github.com/oracle/node-oracledb/blob/master/CHANGELOG.md
 [34]: https://github.com/oracle/node-oracledb/blob/master/test/README.md
 [35]: https://github.com/oracle/node-oracledb/blob/master/CONTRIBUTING.md
 [36]: http://www.apache.org/licenses/LICENSE-2.0
-[37]: https://github.com/oracle/node-oracledb/blob/master/INSTALL.md#quickstart
+[37]: https://oracle.github.io/node-oracledb/INSTALL.html#quickstart
+[38]: https://oracle.github.io/node-oracledb/doc/api.html#getconnectiondbattrsprivilege

package/binding.gyp

@@ -8,6 +8,7 @@
              "src/njsPool.cpp",
              "src/njsConnection.cpp",
              "src/njsResultSet.cpp",
+             "src/njsSubscription.cpp",
              "src/njsMessages.cpp",
              "src/njsIntLob.cpp",
              "odpi/src/dpiConn.c",
@@ -40,7 +41,7 @@
     [
       'OS=="linux"', {
         "variables" : {
-          "dpi_check%"    : "<!(INSTURL=\"https://github.com/oracle/node-oracledb/blob/master/INSTALL.md#github\"; ERR=\"oracledb ERR! Error:\"; if [ -f odpi/include/dpi.h ]; then echo \"Has dpi.h\"; else echo \"$ERR Cannot find odpi/include/dpi.h.  For GitHub ZIP downloads you must separately download the odpi subdirectory from GitHub.\" >&2; echo \"$ERR See $INSTURL\" >&2; echo \"\" >&2; fi;)"
+          "dpi_check%"    : "<!(INSTURL=\"https://oracle.github.io/node-oracledb/INSTALL.html#github\"; ERR=\"oracledb ERR! Error:\"; if [ -f odpi/include/dpi.h ]; then echo \"Has dpi.h\"; else echo \"$ERR Cannot find odpi/include/dpi.h.  For GitHub ZIP downloads you must separately download the odpi subdirectory from GitHub.\" >&2; echo \"$ERR See $INSTURL\" >&2; echo \"\" >&2; fi;)"
         },
         "cflags"        : ['-fexceptions'],
         "cflags_cc"     : ['-fexceptions'],
@@ -50,7 +51,7 @@
     [
       'OS=="mac"', {
         "variables" : {
-          "dpi_check%"    : "<!(INSTURL=\"https://github.com/oracle/node-oracledb/blob/master/INSTALL.md#github\"; ERR=\"oracledb ERR! Error:\"; if [ -f odpi/include/dpi.h ]; then echo \"Has dpi.h\"; else echo \"$ERR Cannot find odpi/include/dpi.h.  For GitHub ZIP downloads you must separately download the odpi subdirectory from GitHub.\" >&2; echo \"$ERR See $INSTURL\" >&2; echo \"\" >&2; fi;)"
+          "dpi_check%"    : "<!(INSTURL=\"https://oracle.github.io/node-oracledb/INSTALL.html#github\"; ERR=\"oracledb ERR! Error:\"; if [ -f odpi/include/dpi.h ]; then echo \"Has dpi.h\"; else echo \"$ERR Cannot find odpi/include/dpi.h.  For GitHub ZIP downloads you must separately download the odpi subdirectory from GitHub.\" >&2; echo \"$ERR See $INSTURL\" >&2; echo \"\" >&2; fi;)"
         },
         "xcode_settings": {
           "GCC_ENABLE_CPP_EXCEPTIONS": "YES",
@@ -62,7 +63,7 @@
     [
       'OS=="aix"', {
         "variables" : {
-          "dpi_check%"    : "<!(INSTURL=\"https://github.com/oracle/node-oracledb/blob/master/INSTALL.md#github\"; ERR=\"oracledb ERR! Error:\"; if [ -f odpi/include/dpi.h ]; then echo \"Has dpi.h\"; else echo \"$ERR Cannot find odpi/include/dpi.h.  For GitHub ZIP downloads you must separately download the odpi subdirectory from GitHub.\" >&2; echo \"$ERR See $INSTURL\" >&2; echo \"\" >&2; fi;)"
+          "dpi_check%"    : "<!(INSTURL=\"https://oracle.github.io/node-oracledb/INSTALL.html#github\"; ERR=\"oracledb ERR! Error:\"; if [ -f odpi/include/dpi.h ]; then echo \"Has dpi.h\"; else echo \"$ERR Cannot find odpi/include/dpi.h.  For GitHub ZIP downloads you must separately download the odpi subdirectory from GitHub.\" >&2; echo \"$ERR See $INSTURL\" >&2; echo \"\" >&2; fi;)"
         },
         "cflags"        : ['-fexceptions', '-fsigned-char'],
         "cflags_cc"     : ['-fexceptions', '-fsigned-char'],
@@ -72,7 +73,7 @@
     [
       'OS=="solaris"', {
         "variables" : {
-          "dpi_check%"    : "<!(INSTURL=\"https://github.com/oracle/node-oracledb/blob/master/INSTALL.md#github\"; ERR=\"oracledb ERR! Error:\"; if [ -f odpi/include/dpi.h ]; then echo \"Has dpi.h\"; else echo \"$ERR Cannot find odpi/include/dpi.h.  For GitHub ZIP downloads you must separately download the odpi subdirectory from GitHub.\" >&2; echo \"$ERR See $INSTURL\" >&2; echo \"\" >&2; fi;)"
+          "dpi_check%"    : "<!(INSTURL=\"https://oracle.github.io/node-oracledb/INSTALL.html#github\"; ERR=\"oracledb ERR! Error:\"; if [ -f odpi/include/dpi.h ]; then echo \"Has dpi.h\"; else echo \"$ERR Cannot find odpi/include/dpi.h.  For GitHub ZIP downloads you must separately download the odpi subdirectory from GitHub.\" >&2; echo \"$ERR See $INSTURL\" >&2; echo \"\" >&2; fi;)"
         },
         "cflags"        : ['-fexceptions'],
         "cflags_cc"     : ['-fexceptions'],