oracledb 6.4.0 → 6.5.0

package/README.md

@@ -1,10 +1,10 @@
-# node-oracledb version 6.4.0
+# node-oracledb version 6.5.0
 
 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.4.0 to connect Node.js 14.6, or later, to Oracle
+Use node-oracledb 6.5.0 to connect Node.js 14.6, or later, to Oracle
 Database.  Older versions of node-oracledb may work with older versions of
 Node.js.
 

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

@@ -0,0 +1 @@
+oracledb-6.5.0-darwin-x64.node v20.11.1 91a7f419eccbfcd18513c19cd25f55f18a4d8ccc 42edf925eedae73b0d5bd7777167a21987bafc89 Tue, 30 Apr 2024 20:12:57 GMT

package/build/Release/oracledb-6.5.0-js-buildinfo.txt

@@ -0,0 +1 @@
+91a7f419eccbfcd18513c19cd25f55f18a4d8ccc

package/build/Release/oracledb-6.5.0-linux-arm64.node-buildinfo.txt

@@ -0,0 +1 @@
+oracledb-6.5.0-linux-arm64.node v18.19.1 91a7f419eccbfcd18513c19cd25f55f18a4d8ccc 42edf925eedae73b0d5bd7777167a21987bafc89 Wed, 01 May 2024 04:29:37 GMT

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

@@ -0,0 +1 @@
+oracledb-6.5.0-linux-x64.node v16.20.2 91a7f419eccbfcd18513c19cd25f55f18a4d8ccc 42edf925eedae73b0d5bd7777167a21987bafc89 Wed, 01 May 2024 04:22:59 GMT

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

@@ -0,0 +1 @@
+oracledb-6.5.0-win32-x64.node v18.16.0 91a7f419eccbfcd18513c19cd25f55f18a4d8ccc 42edf925eedae73b0d5bd7777167a21987bafc89 Wed, 01 May 2024 04:34:23 GMT

package/lib/aqQueue.js

@@ -181,7 +181,7 @@ class AqQueue {
   async deqOne() {
     errors.assertArgCount(arguments, 0, 0);
     const msgImpls = await this._impl.deq(1);
-    if (msgImpls)
+    if (msgImpls.length > 0)
       return this._makeMessage(msgImpls[0]);
   }
 

package/lib/connection.js

@@ -200,12 +200,13 @@ class Connection extends EventEmitter {
       typeof value === 'number' ||
       typeof value === 'string' ||
       typeof value === 'boolean' ||
+      typeof value === 'bigint' ||
       Array.isArray(value) ||
       value instanceof Float32Array ||
       value instanceof Float64Array ||
       value instanceof Int8Array ||
       Buffer.isBuffer(value) ||
-      util.isDate(value) ||
+      util.types.isDate(value) ||
       value instanceof Lob ||
       value instanceof ResultSet ||
       value instanceof BaseDbObject
@@ -570,11 +571,8 @@ class Connection extends EventEmitter {
     } else {
 
       // fetchArraySize must be a positive integer
-      if (options.fetchArraySize !== undefined) {
-        errors.assertParamPropValue(Number.isInteger(options.fetchArraySize) &&
-          options.fetchArraySize > 0, 3, "fetchArraySize");
-        outOptions.fetchArraySize = options.fetchArraySize;
-      }
+      errors.assertParamPropUnsignedIntNonZero(options, 3, "fetchArraySize");
+      outOptions.fetchArraySize = options.fetchArraySize;
 
       // fetchInfo must be an object with keys containing an object with a
       // "type" property; these are converted to an array of objects for ease
@@ -860,7 +858,7 @@ class Connection extends EventEmitter {
   //---------------------------------------------------------------------------
   encodeOSON(value) {
     const encoder = new oson.OsonEncoder();
-    return encoder.encode(transformer.transformJsonValue(value));
+    return encoder.encode(transformer.transformJsonValue(value), this._impl._osonMaxFieldNameSize);
   }
 
   //---------------------------------------------------------------------------
@@ -927,8 +925,8 @@ class Connection extends EventEmitter {
 
     // process output binds
     if (result.outBinds !== undefined) {
-      for (const key in result.outBinds) {
-        const val = this._transformOutBind(result.outBinds[key], options);
+      for (const [key, value] of Object.entries(result.outBinds)) {
+        const val = this._transformOutBind(value, options);
         result.outBinds[key] = val;
       }
     }
@@ -937,10 +935,9 @@ class Connection extends EventEmitter {
     // array size fixed, or, if a result set is not requested, that all rows
     // are fetched
     if (result.implicitResults) {
-      for (const key in result.implicitResults) {
-        const resultSetImpl = result.implicitResults[key];
+      for (const [key, impl] of Object.entries(result.implicitResults)) {
         const resultSet = new ResultSet();
-        resultSet._setup(this, resultSetImpl);
+        resultSet._setup(this, impl);
         if (options.resultSet) {
           result.implicitResults[key] = resultSet;
         } else {
@@ -996,8 +993,8 @@ class Connection extends EventEmitter {
     if (result.outBinds !== undefined) {
       for (let i = 0; i < result.outBinds.length; i++) {
         const outBind = result.outBinds[i];
-        for (const key in outBind) {
-          outBind[key] = this._transformOutBind(outBind[key], options);
+        for (const [key, value] of Object.entries(outBind)) {
+          outBind[key] = this._transformOutBind(value, options);
         }
       }
     }

package/lib/errors.js

@@ -143,6 +143,8 @@ const ERR_WRONG_LENGTH_FOR_DBOBJECT_ELEM = 143;
 const ERR_VECTOR_FORMAT_NOT_SUPPORTED = 144;
 const ERR_VECTOR_VERSION_NOT_SUPPORTED = 145;
 const ERR_OBJECT_IS_NOT_A_COLLECTION = 146;
+const ERR_CURSOR_HAS_BEEN_CLOSED = 147;
+const ERR_DML_RETURNING_DUP_BINDS = 149;
 
 // Oracle Net layer errors start from 500
 const ERR_CONNECTION_CLOSED = 500;
@@ -356,7 +358,7 @@ messages.set(ERR_INTEGER_TOO_LARGE,                     // NJS-112
 messages.set(ERR_UNEXPECTED_DATA,                       // NJS-113
   'unexpected data received: %s');
 messages.set(ERR_OSON_FIELD_NAME_LIMITATION,            // NJS-114
-  'OSON field names may not exceed 255 UTF-8 encoded bytes');
+  'OSON field names may not exceed %d UTF-8 encoded bytes');
 messages.set(ERR_ORACLE_NUMBER_NO_REPR,                 // NJS-115
   'value cannot be represented as an Oracle Database number');
 messages.set(ERR_UNSUPPORTED_VERIFIER_TYPE,             // NJS-116
@@ -417,6 +419,10 @@ messages.set(ERR_VECTOR_VERSION_NOT_SUPPORTED,          // NJS-145
   'VECTOR version %d is not supported');
 messages.set(ERR_OBJECT_IS_NOT_A_COLLECTION,            // NJS-146
   'object %s is not a collection');
+messages.set(ERR_CURSOR_HAS_BEEN_CLOSED,                // NJS-147
+  'cursor has been closed by the database');
+messages.set(ERR_DML_RETURNING_DUP_BINDS,               // NJS-149
+  'the bind variable placeholder "%s" cannot be used both before and after the RETURNING clause in a DML RETURNING statement');
 
 // Oracle Net layer errors
 
@@ -543,6 +549,19 @@ function assertParamPropUnsignedInt(obj, parameterNum, propName) {
   }
 }
 
+//-----------------------------------------------------------------------------
+// assertParamPropUnsignedIntNonZero()
+//
+// Asserts that the property value of a parameter is a positive integer value
+// (or undefined).
+//-----------------------------------------------------------------------------
+function assertParamPropUnsignedIntNonZero(obj, parameterNum, propName) {
+  if (obj[propName] !== undefined) {
+    assertParamPropValue(Number.isInteger(obj[propName]) && obj[propName] > 0,
+      parameterNum, propName);
+  }
+}
+
 //-----------------------------------------------------------------------------
 // assertParamPropString()
 //
@@ -639,7 +658,7 @@ function transformErr(err, fnOpt) {
       err.code = err.message.substr(0, pos);
       /* add Oracle Database Error Help Portal URL for database error
          messages, but only in thin mode since this is done
-         automatically in thick mode with Oracle Client 23c and higher
+         automatically in thick mode with Oracle Client 23ai and higher
       */
       const settings = require('./settings.js');
       if (err.errorNum && settings.thin) {
@@ -808,6 +827,8 @@ module.exports = {
   ERR_VECTOR_FORMAT_NOT_SUPPORTED,
   ERR_VECTOR_VERSION_NOT_SUPPORTED,
   ERR_OBJECT_IS_NOT_A_COLLECTION,
+  ERR_CURSOR_HAS_BEEN_CLOSED,
+  ERR_DML_RETURNING_DUP_BINDS,
   ERR_CONNECTION_CLOSED_CODE: `${ERR_PREFIX}-${ERR_CONNECTION_CLOSED}`,
   WRN_COMPILATION_CREATE,
   assert,
@@ -817,6 +838,7 @@ module.exports = {
   assertParamPropInt,
   assertParamPropString,
   assertParamPropUnsignedInt,
+  assertParamPropUnsignedIntNonZero,
   assertParamPropValue,
   assertParamValue,
   assertPropValue,

package/lib/impl/connection.js

@@ -37,6 +37,7 @@ class ConnectionImpl {
     this._inProgress = false;
     this._dbObjectTypes = new Map();
     this._requestQueue = [];
+    this._osonMaxFieldNameSize = 255;
   }
 
   //---------------------------------------------------------------------------
@@ -110,7 +111,7 @@ class ConnectionImpl {
   // removed once Node-API version 5 is used in the C extension.
   // ---------------------------------------------------------------------------
   _isDate(val) {
-    return (util.isDate(val));
+    return (util.types.isDate(val));
   }
 
   //---------------------------------------------------------------------------

package/lib/impl/datahandlers/constants.js

@@ -35,16 +35,15 @@ module.exports = {
   TNS_VECTOR_VERSION: 0,
 
   // vector flags
-  TNS_VECTOR_FLAG_DIM_UINT8: 0x0001,
-  TNS_VECTOR_FLAG_DIM_UINT32: 0x0002,
-  TNS_VECTOR_FLAG_NORMSRC: 0x0040,
-  TNS_VECTOR_FLAG_NORM: 0x0008,
+  TNS_VECTOR_FLAG_NORMSRC: 0x0010,
+  TNS_VECTOR_FLAG_NORM: 0x0002,
 
   // base JSON constants
   TNS_JSON_MAGIC_BYTE_1: 0xff,
   TNS_JSON_MAGIC_BYTE_2: 0x4a,       // 'J'
   TNS_JSON_MAGIC_BYTE_3: 0x5a,       // 'Z'
-  TNS_JSON_VERSION: 1,
+  TNS_JSON_VERSION_MAX_FNAME_255: 1,
+  TNS_JSON_VERSION_MAX_FNAME_65535: 3,
   TNS_JSON_FLAG_HASH_ID_UINT8: 0x0100,
   TNS_JSON_FLAG_HASH_ID_UINT16: 0x0200,
   TNS_JSON_FLAG_NUM_FNAMES_UINT16: 0x0400,
@@ -56,6 +55,7 @@ module.exports = {
   TNS_JSON_FLAG_LEN_IN_PCODE: 0x04,
   TNS_JSON_FLAG_NUM_FNAMES_UINT32: 0x08,
   TNS_JSON_FLAG_IS_SCALAR: 0x10,
+  TNS_JSON_FLAG_SEC_FNAMES_SEG_UINT16: 0x100,
 
   // JSON data types
   TNS_JSON_TYPE_NULL: 0x30,
@@ -79,6 +79,7 @@ module.exports = {
   TNS_JSON_TYPE_ARRAY: 0xc0,
   TNS_JSON_TYPE_EXTENDED: 0x7b,
   TNS_JSON_TYPE_VECTOR: 0x01,
+  TNS_JSON_TYPE_ID: 0x7e,
 
   // timezone offsets
   TZ_HOUR_OFFSET: 20,