oracledb 3.1.2 → 4.2.0

package/README.md

@@ -1,13 +1,13 @@
-# node-oracledb version 3.1
+# node-oracledb version 4.2
 
 The node-oracledb add-on for Node.js powers high performance Oracle
 Database applications.
 
-Use node-oracledb to connect Node.js 6, 8, 10 and 11 to Oracle Database.
+Use node-oracledb 4.2 to connect Node.js 8.16, 10.16, 12, or later, to Oracle Database.
+Older versions of node-oracledb may work with older versions of Node.js.
 
 Node-oracledb supports basic and advanced features of Oracle Database
-and Oracle Client.  See the
-[homepage][4] for a list.
+and Oracle Client.  See the [homepage][4] for a list.
 
 The node-oracledb module is open source and maintained by Oracle Corp.
 It is stable, well documented, and has a comprehensive test suite.
@@ -22,8 +22,7 @@ See [Documentation for the Oracle Database Node.js Add-on][32] and the [CHANGELO
 
 ## <a name="examples"></a> Examples
 
-See the [examples][30] directory.  Start with
-[examples/example.js][31].
+See the [examples][30] directory.  Start with [examples/example.js][31].
 
 ## <a name="help"></a> Help
 
@@ -44,7 +43,7 @@ have been made by the community.
 
 ## <a name="license"></a> License
 
-Copyright (c) 2015, 2018, Oracle and/or its affiliates. All rights reserved.
+Copyright (c) 2015, 2020, Oracle and/or its affiliates. All rights reserved.
 
 You may not use the identified files except in compliance with the Apache
 License, Version 2.0 (the "License.")
@@ -65,7 +64,7 @@ limitations under the License.
 [3]: https://github.com/oracle/node-oracledb/issues
 [4]: https://oracle.github.io/node-oracledb
 [5]: https://node-oracledb.slack.com/
-[6]: https://node-oracledb.slack.com/join/shared_invite/enQtNDU4Mjc2NzM5OTA2LTdkMzczODY3OGY3MGI0Yjk3NmQ4NDU4MTI2OGVjNTYzMjE5OGY5YzVkNDY4MWNkNjFiMDM2ZDMwOWRjNWVhNTg
+[6]: https://join.slack.com/t/node-oracledb/shared_invite/enQtNDU4Mjc2NzM5OTA2LWMzY2ZlZDY5MDdlMGZiMGRkY2IzYjI5OGU4YTEzZWM5YjQ3ODUzMjcxNWQyNzE4MzM5YjNkYjVmNDk5OWU5NDM
 [30]: https://github.com/oracle/node-oracledb/blob/master/examples
 [31]: https://github.com/oracle/node-oracledb/blob/master/examples/example.js#L32
 [32]: https://oracle.github.io/node-oracledb/doc/api.html

package/build/Release/oracledb-4.2.0-darwin-x64.node-buildinfo.txt

@@ -0,0 +1 @@
+oracledb-4.2.0-darwin-x64.node v12.14.0 da38f81a6d5a455470eeac591d361d840f9d7ff7 3bfc57e44f88465440b046ff70be38097d2d4fd7 Thu, 16 Jan 2020 06:03:53 GMT

package/build/Release/oracledb-4.2.0-linux-x64.node-buildinfo.txt

@@ -0,0 +1 @@
+oracledb-4.2.0-linux-x64.node v10.18.1 da38f81a6d5a455470eeac591d361d840f9d7ff7 3bfc57e44f88465440b046ff70be38097d2d4fd7 Thu, 16 Jan 2020 06:04:31 GMT

package/build/Release/oracledb-4.2.0-win32-x64.node-buildinfo.txt

@@ -0,0 +1 @@
+oracledb-4.2.0-win32-x64.node v13.5.0 da38f81a6d5a455470eeac591d361d840f9d7ff7 3bfc57e44f88465440b046ff70be38097d2d4fd7 Thu, 16 Jan 2020 05:59:23 GMT

package/lib/aqDeqOptions.js

@@ -0,0 +1,29 @@
+// Copyright (c) 2019, Oracle and/or its affiliates. All rights reserved
+
+//-----------------------------------------------------------------------------
+//
+// You may not use the identified files except in compliance with the Apache
+// License, Version 2.0 (the "License.")
+//
+// You may obtain a copy of the License at
+// http://www.apache.org/licenses/LICENSE-2.0.
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+// WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+//
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+//-----------------------------------------------------------------------------
+
+'use strict';
+
+class AqDeqOptions {
+
+  _extend(oracledb) { //eslint-disable-line
+  }
+
+}
+
+module.exports = AqDeqOptions;

package/lib/aqEnqOptions.js

@@ -0,0 +1,29 @@
+// Copyright (c) 2019, Oracle and/or its affiliates. All rights reserved
+
+//-----------------------------------------------------------------------------
+//
+// You may not use the identified files except in compliance with the Apache
+// License, Version 2.0 (the "License.")
+//
+// You may obtain a copy of the License at
+// http://www.apache.org/licenses/LICENSE-2.0.
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+// WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+//
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+//-----------------------------------------------------------------------------
+
+'use strict';
+
+class AqEnqOptions {
+
+  _extend(oracledb) { //eslint-disable-line
+  }
+
+}
+
+module.exports = AqEnqOptions;

package/lib/aqMessage.js

@@ -0,0 +1,29 @@
+// Copyright (c) 2019, Oracle and/or its affiliates. All rights reserved
+
+//-----------------------------------------------------------------------------
+//
+// You may not use the identified files except in compliance with the Apache
+// License, Version 2.0 (the "License.")
+//
+// You may obtain a copy of the License at
+// http://www.apache.org/licenses/LICENSE-2.0.
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+// WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+//
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+//-----------------------------------------------------------------------------
+
+'use strict';
+
+class AqMessage {
+
+  _extend(oracledb) { //eslint-disable-line
+  }
+
+}
+
+module.exports = AqMessage;

package/lib/aqQueue.js

@@ -0,0 +1,84 @@
+// Copyright (c) 2019, Oracle and/or its affiliates. All rights reserved
+
+//-----------------------------------------------------------------------------
+//
+// You may not use the identified files except in compliance with the Apache
+// License, Version 2.0 (the "License.")
+//
+// You may obtain a copy of the License at
+// http://www.apache.org/licenses/LICENSE-2.0.
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+// WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+//
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+//-----------------------------------------------------------------------------
+
+'use strict';
+
+const nodbUtil = require('./util.js');
+
+//-----------------------------------------------------------------------------
+// deqOne
+//   Returns a single message from the queue, if one is available.
+//-----------------------------------------------------------------------------
+function deqOne(cb) {
+  nodbUtil.checkAsyncArgs(arguments, 1, 1);
+  this._deqOne(cb);
+}
+
+
+//-----------------------------------------------------------------------------
+// deqMany
+//   Returns an array of messages from the queue, up to the maximum specified,
+// if any are available.
+//----------------------------------------------------------------------------
+function deqMany(maxMessages, cb) {
+  nodbUtil.checkAsyncArgs(arguments, 2, 2);
+  nodbUtil.assert(typeof maxMessages === 'number', 'NJS-005', 1);
+
+  this._deqMany(maxMessages, cb);
+}
+
+
+//-----------------------------------------------------------------------------
+// enqOne
+//   Enqueues a single message into the queue.
+//-----------------------------------------------------------------------------
+function enqOne(message, cb) {
+  nodbUtil.checkAsyncArgs(arguments, 2, 2);
+  nodbUtil.assert(typeof message === 'object' || typeof message === 'string',
+    'NJS-005', 1);
+
+  this._enqOne(message, cb);
+}
+
+
+//-----------------------------------------------------------------------------
+// enqMany
+//   Returns an array of messages from the queue, up to the maximum specified,
+// if any are available.
+//----------------------------------------------------------------------------
+function enqMany(messages, cb) {
+  nodbUtil.checkAsyncArgs(arguments, 2, 2);
+  nodbUtil.assert(Array.isArray(messages), 'NJS-005', 1);
+
+  this._enqMany(messages, cb);
+}
+
+
+class AqQueue {
+
+  _extend(oracledb) {
+    this.deqOne = nodbUtil.promisify(oracledb, deqOne);
+    this.deqMany = nodbUtil.promisify(oracledb, deqMany);
+    this.enqOne = nodbUtil.promisify(oracledb, enqOne);
+    this.enqMany = nodbUtil.promisify(oracledb, enqMany);
+  }
+
+}
+
+module.exports = AqQueue;