oracledb 6.4.0 → 6.5.1

package/README.md

@@ -1,10 +1,10 @@
-# node-oracledb version 6.4.0
+# node-oracledb version 6.5.1
 
 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.1 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.1-darwin-x64.node-buildinfo.txt

@@ -0,0 +1 @@
+oracledb-6.5.1-darwin-x64.node v20.11.1 572ce8bae4965b47d3554fa08a0d131acb4dc70b 077b92ae23b597c7854563e2ab4506966aa5fe40 Fri, 17 May 2024 14:57:54 GMT

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

@@ -0,0 +1 @@
+572ce8bae4965b47d3554fa08a0d131acb4dc70b

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

@@ -0,0 +1 @@
+oracledb-6.5.1-linux-arm64.node v18.19.1 572ce8bae4965b47d3554fa08a0d131acb4dc70b 077b92ae23b597c7854563e2ab4506966aa5fe40 Fri, 17 May 2024 15:07:07 GMT

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

@@ -0,0 +1 @@
+oracledb-6.5.1-linux-x64.node v16.20.2 572ce8bae4965b47d3554fa08a0d131acb4dc70b 077b92ae23b597c7854563e2ab4506966aa5fe40 Fri, 17 May 2024 15:08:37 GMT

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

@@ -0,0 +1 @@
+oracledb-6.5.1-win32-x64.node v18.16.0 572ce8bae4965b47d3554fa08a0d131acb4dc70b 077b92ae23b597c7854563e2ab4506966aa5fe40 Fri, 17 May 2024 15:09:11 GMT

package/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

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

@@ -31,6 +31,17 @@ const util = require('util');
 // define error prefix for all messages
 const ERR_PREFIX = "NJS";
 
+const ERR_INTEGRITY_ERROR_CODES = [
+  1,     // unique constraint violated
+  1400,  // cannot insert NULL
+  1438,  // value larger than specified precision
+  2290,  // check constraint violated
+  2291,  // integrity constraint violated - parent key not found
+  2292,  // integrity constraint violated - child record found
+  21525, // attribute or collection element violated its constraints
+  40479, // internal JSON serializer error
+];
+
 // define error number constants (used in JavaScript library)
 const ERR_INVALID_POOL = 2;
 const ERR_INVALID_CONNECTION = 3;
@@ -143,6 +154,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 +369,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 +430,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 +560,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 +669,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) {
@@ -676,6 +706,7 @@ function transformErr(err, fnOpt) {
 
 // define exports
 module.exports = {
+  ERR_INTEGRITY_ERROR_CODES,
   ERR_INVALID_POOL,
   ERR_INVALID_CONNECTION,
   ERR_INVALID_PROPERTY_VALUE,
@@ -808,6 +839,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 +850,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/buffer.js

@@ -843,8 +843,8 @@ class BaseBuffer {
     }
 
     // throw exception if number cannot be represented as an Oracle Number
-    if (value.length > constants.NUMBER_MAX_DIGITS || exponent > 126 ||
-        exponent < -129) {
+    if (value.length > constants.NUMBER_MAX_DIGITS || exponent >= 126 ||
+        exponent <= -131) {
       errors.throwErr(errors.ERR_ORACLE_NUMBER_NO_REPR);
     }
 

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,