Update a few test cases and move to 6.5.1 dev

Author: sharadraju

README.md

@@ -1,10 +1,12 @@
-# node-oracledb version 6.5.0
+# node-oracledb version 6.5.1-dev
+
+**This release is under development and information may be incomplete**
 
 The node-oracledb add-on for Node.js powers high performance Oracle Database
 applications.  Applications can be written in TypeScript, or directly in
 JavaScript.
 
-Use node-oracledb 6.5.0 to connect Node.js 14.6, or later, to Oracle
+Use node-oracledb 6.5.1-dev to connect Node.js 14.6, or later, to Oracle
 Database.  Older versions of node-oracledb may work with older versions of
 Node.js.
 

doc/src/api_manual/oracledb.rst

@@ -187,7 +187,10 @@ instead of ``result.metadata[0].fetchType == 2001``.
 
         .. versionadded:: 6.5
 
-Note that the values for these constants changed in node-oracledb 4.0.
+.. versionchanged:: 4.0
+
+    The values of the constants were changed. This change is not applicable to
+    the constants introduced after node-oracledb 4.0.
 
 .. _oracledbconstantsnodbtype:
 
@@ -890,10 +893,10 @@ Constants for the :ref:`vectorFormat <execmetadata>` attribute.
     * - ``oracledb.VECTOR_FORMAT_FLOAT32``
       - 2
       - The storage format of each dimension value in the vector column is a 32-bit floating-point number.
-    * - ``VECTOR_FORMAT_FLOAT64``
+    * - ``oracledb.VECTOR_FORMAT_FLOAT64``
       - 3
       - The storage format of each dimension value in the vector column is a 64-bit floating-point number.
-    * - ``VECTOR_FORMAT_INT8``
+    * - ``oracledb.VECTOR_FORMAT_INT8``
       - 4
       - The storage format of each dimension value in the vector column is an 8-bit signed integer.
 

doc/src/release_notes.rst

@@ -51,6 +51,12 @@ Common Changes
     See `PR #1572 <https://github.com/oracle/node-oracledb/pull/1572>`__
     (Slawomir Osoba).
 
+#)  Test case improvements and additions for the supported Oracle Database
+    23ai features.
+
+#)  Documentation updates and additions for the supported Oracle Database
+    23ai features.
+
 Thin Mode Changes
 ++++++++++++++++++
 

examples/README.md

@@ -130,5 +130,7 @@ File Name                                                 | Description
 [`soda1.js`](soda1.js)                                    | Basic Simple Oracle Document Access (SODA) example
 [`typehandlerdate.js`](typehandlerdate.js)                | Show how a type handler can format a queried date in a locale-specific way
 [`typehandlernum.js`](typehandlernum.js)                  | Show how a type handler can alter queried numbers
+[`vectortype1.js`](vectortype1.js)                        | Insert and query VECTOR columns.
+[`vectortype2.js`](vectortype2.js)                        | Insert data into VECTOR columns and verify vector operations.
 [`version.js`](version.js)                                | Shows the node-oracledb version attributes
 [`webapp.js`](webapp.js)                                  | A simple web application using a connection pool

lib/version.js

@@ -31,6 +31,6 @@
 module.exports = {
   VERSION_MAJOR: 6,
   VERSION_MINOR: 5,
-  VERSION_PATCH: 0,
-  VERSION_SUFFIX: ''
+  VERSION_PATCH: 1,
+  VERSION_SUFFIX: '-dev'
 };

package.json

@@ -1,6 +1,6 @@
 {
   "name": "oracledb",
-  "version": "6.5.0",
+  "version": "6.5.1-dev",
   "description": "A Node.js module for Oracle Database access from JavaScript and TypeScript",
   "license": "(Apache-2.0 OR UPL-1.0)",
   "homepage": "http://oracle.github.io/node-oracledb/",

test/blobDMLBindAsBuffer.js

@@ -1,4 +1,4 @@
-/* Copyright (c) 2017, 2023, Oracle and/or its affiliates. */
+/* Copyright (c) 2017, 2024, Oracle and/or its affiliates. */
 
 /******************************************************************************
  *
@@ -429,7 +429,7 @@ describe('82.blobDMLBindAsBuffer.js', function() {
       await checkInsertResult(id, content_2);
     }); // 82.2.1
 
-    it('82.2.2 update a cloumn with EMPTY_BLOB', async function() {
+    it('82.2.2 update a column with EMPTY_BLOB', async function() {
       const id = insertID++;
       const contentLength_1 = 50000;
       const specialStr_1 = "82.2.2";

test/clobDMLBindAsString.js

@@ -1,4 +1,4 @@
-/* Copyright (c) 2017, 2023, Oracle and/or its affiliates. */
+/* Copyright (c) 2017, 2024, Oracle and/or its affiliates. */
 
 /******************************************************************************
  *
@@ -415,7 +415,7 @@ describe('81. clobDMLBindAsString.js', function() {
       await checkInsertResult(id, content_2, specialStr_2);
     }); // 81.2.1
 
-    it('81.2.2 update a cloumn with EMPTY_CLOB', async function() {
+    it('81.2.2 update a column with EMPTY_CLOB', async function() {
       const id = insertID++;
       const contentLength_1 = 50000;
       const specialStr_1 = "81.2.2";

test/list.txt

@@ -1657,7 +1657,7 @@ Overview of node-oracledb functional tests
         81.1.19 works with bind in maxSize smaller than string length
      81.2 CLOB, UPDATE
         81.2.1 update EMPTY_CLOB column
-        81.2.2 update a cloumn with EMPTY_CLOB
+        81.2.2 update a column with EMPTY_CLOB
         81.2.3 update EMPTY_CLOB column with empty string
         81.2.4 update empty string column
         81.2.5 update a column with empty string
@@ -1685,7 +1685,7 @@ Overview of node-oracledb functional tests
         82.1.19 works with bind in maxSize smaller than buffer size
     82.2 BLOB, UPDATE
         82.2.1 update EMPTY_BLOB column
-        82.2.2 update a cloumn with EMPTY_BLOB
+        82.2.2 update a column with EMPTY_BLOB
         82.2.3 update EMPTY_BLOB column with empty buffer
         82.2.4 update empty buffer column
         82.2.5 update a column with empty buffer

test/listIndexes.js

@@ -1,4 +1,4 @@
-/* Copyright (c) 2023, Oracle and/or its affiliates. */
+/* Copyright (c) 2023, 2024, Oracle and/or its affiliates. */
 
 /******************************************************************************
  *
@@ -42,11 +42,17 @@ describe('286. listIndexes.js', function() {
   let conn = null;
 
   before(async function() {
-    const runnable = await testsUtil.isSodaRunnable();
+    let runnable = await testsUtil.isSodaRunnable();
+    // For listIndexes, Oracle Client library version 19.13 (or later DBRU)
+    // or version 21.3 (or higher) is needed
+    runnable = runnable && (testsUtil.getClientVersion >= 1913000000 ||
+      (testsUtil.getClientVersion >= 2100000000 && testsUtil.getClientVersion >= 2103000000))
+    if (!oracledb.thin) {
+      await sodaUtil.cleanup();
+    }
     if (!runnable) {
       this.skip();
     }
-    await sodaUtil.cleanup();
     conn = await oracledb.getConnection(dbconfig);
   });
 

test/sodaOpLock.js

@@ -1,4 +1,4 @@
-/* Copyright (c) 2020, 2023, Oracle and/or its affiliates. */
+/* Copyright (c) 2020, 2024, Oracle and/or its affiliates. */
 
 /******************************************************************************
  *
@@ -46,7 +46,8 @@ describe('287. sodaOpLock.js', () => {
     const clientVersion = testsUtil.getClientVersion();
 
     let isClientOK;
-    if (clientVersion < 2000000000) {
+    if (clientVersion < 2000000000 ||
+        (clientVersion >= 2100000000 && clientVersion < 2103000000)) {
       isClientOK = false;
     } else {
       isClientOK = true;