oracledb 6.5.0 → 6.5.1

package/README.md

@@ -1,10 +1,10 @@
-# node-oracledb version 6.5.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.5.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/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;
@@ -695,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,

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/oracledb.js

@@ -118,33 +118,6 @@ function _initializeThinDriver() {
   require('./thin');
 }
 
-//---------------------------------------------------------------------------
-// _isPrivilege()
-//
-// Returns a boolean indicating if the supplied value is a valid privilege.
-//---------------------------------------------------------------------------
-function _isPrivilege(value) {
-  // Privileges are mutually exclusive and cannot be specified together
-  // except SYSPRELIM, which cannot be specified alone, it is specified in a
-  // combo with SYSOPER or SYSDBA.  SYSPRELIM is used only for
-  // startup/shutdown
-
-  // If SYSPRELIM specified, clear the bit
-  if (value & constants.SYSPRELIM) {
-    value = value ^ constants.SYSPRELIM;
-  }
-
-  return (
-    value === constants.SYSASM ||
-    value === constants.SYSBACKUP ||
-    value === constants.SYSDBA ||
-    value === constants.SYSDG ||
-    value === constants.SYSKM ||
-    value === constants.SYSOPER ||
-    value === constants.SYSRAC
-  );
-}
-
 //-----------------------------------------------------------------------------
 // _verifyOptions()
 //
@@ -331,6 +304,13 @@ async function _verifyOptions(options, inCreatePool) {
     outOptions.connectionIdPrefix = options.connectionIdPrefix;
   }
 
+  // privilege must be one of a set of named constants
+  if (options.privilege !== undefined) {
+    errors.assertParamPropValue(nodbUtil.isPrivilege(options.privilege), 1,
+      "privilege");
+    outOptions.privilege = options.privilege;
+  }
+
   // check pool specific options
   if (inCreatePool) {
 
@@ -444,13 +424,6 @@ async function _verifyOptions(options, inCreatePool) {
       outOptions.newPassword = options.newPassword;
     }
 
-    // privilege must be one of a set of named constants
-    if (options.privilege !== undefined) {
-      errors.assertParamPropValue(_isPrivilege(options.privilege), 1,
-        "privilege");
-      outOptions.privilege = options.privilege;
-    }
-
     // shardingKey must be an array of values
     if (options.shardingKey !== undefined) {
       const value = options.shardingKey;

package/lib/pool.js

@@ -238,6 +238,13 @@ class Pool extends EventEmitter {
       outOptions.superShardingKey = options.superShardingKey;
     }
 
+    // privilege must be one of a set of named constants
+    if (options.privilege !== undefined) {
+      errors.assertParamPropValue(nodbUtil.isPrivilege(options.privilege), 1,
+        "privilege");
+      outOptions.privilege = options.privilege;
+    }
+
     return outOptions;
   }
 

package/lib/thin/protocol/constants.js

@@ -724,6 +724,7 @@ module.exports = {
   TNS_XML_TYPE_FLAG_SKIP_NEXT_4: 0x100000,
 
   // errors
+  TNS_ERR_INCONSISTENT_DATA_TYPES: 932,
   TNS_ERR_VAR_NOT_IN_SELECT_LIST: 1007,
   TNS_ERR_INBAND_MESSAGE: 12573,
   TNS_ERR_INVALID_SERVICE_NAME: 12514,

package/lib/thin/protocol/messages/withData.js

@@ -113,9 +113,18 @@ class MessageWithData extends Message {
       this.errorInfo.num = 0;
       this.errorOccurred = false;
       this.statement.moreRowsToFetch = false;
+    } else if (this.retry) {
+      this.retry = false;
+    } else if (this.statement.isQuery &&
+      (this.errorInfo.num === constants.TNS_ERR_VAR_NOT_IN_SELECT_LIST
+        || this.errorInfo.num === constants.TNS_ERR_INCONSISTENT_DATA_TYPES)) {
+      this.retry = true;
+      this.connection.statementCache.clearCursor(this.statement);
     } else if (this.errorInfo.num !== 0 && this.errorInfo.cursorId !== 0) {
-      this.connection.statementCache._cachedStatements.delete(this.statement.sql);
-      this.statement.returnToCache = false;
+      if (!errors.ERR_INTEGRITY_ERROR_CODES.includes(this.errorInfo.num)) {
+        this.connection.statementCache.clearCursor(this.statement);
+        this.statement.returnToCache = false;
+      }
     }
     if (this.errorInfo.batchErrors) {
       this.errorOccurred = false;

package/lib/thin/protocol/protocol.js

@@ -174,6 +174,10 @@ class Protocol {
       if (callTimeoutExpired) {
         errors.throwErr(errors.ERR_CALL_TIMEOUT_EXCEEDED, this.callTimeout);
       }
+      if (message.retry) {
+        message.errorOccurred = false;
+        return await this._processMessage(message);
+      }
       let err = new Error(message.errorInfo.message);
       err.offset = message.errorInfo.pos;
       err.errorNum = message.errorInfo.num;

package/lib/thin/sqlnet/packet.js

@@ -296,7 +296,9 @@ function RedirectPacket(packet) {
  */
 function MarkerPacket(isLargeSDU) {
   this.len = constants.NSPMKDAT + 1; /* Packet length */
-  this.buf = Buffer.allocUnsafe(constants.NSPMKDAT + 1); /* Packet Buffer */
+
+  // Packet Buffer
+  this.buf = Buffer.allocUnsafe(constants.NSPMKDAT + 1).fill(0);
 
   if (isLargeSDU) {
     this.buf.writeUInt32BE(this.len, constants.NSPHDLEN);

package/lib/thin/statement.js

@@ -29,6 +29,7 @@
 const { Buffer } = require('buffer');
 const constants = require('../constants');
 const errors = require('../errors');
+const protoConstants = require('./protocol/constants');
 
 /**
  * It is used to cache the metadata about bind information
@@ -519,6 +520,9 @@ class Statement {
   // cursor also requires a full execute.
   //---------------------------------------------------------------------------
   _setVariable(bindInfo, variable) {
+    if (variable.type._oraTypeNum === protoConstants.TNS_DATA_TYPE_CURSOR) {
+      this.requiresFullExecute = true;
+    }
     if (variable.maxSize !== bindInfo.maxSize
         || variable.dir !== bindInfo.dir
         || variable.isArray !== bindInfo.isArray

package/lib/thin/statementCache.js

@@ -146,6 +146,11 @@ class StatementCache {
     return stmt;
   }
 
+  clearCursor(statement) {
+    this._addCursorToClose(statement);
+    statement.cursorId = 0;
+  }
+
   //---------------------------------------------------------------------------
   // returnStatement()
   // Return the statement to the statement cache, if applicable. If the

package/lib/util.js

@@ -31,6 +31,7 @@ const errors = require('./errors.js');
 const process = require('process');
 const util = require('util');
 const types = require('./types.js');
+const constants = require('./constants.js');
 
 // node-oracledb version number
 let packageJSON;
@@ -224,6 +225,32 @@ function isObjectOrArray(value) {
   return (value !== null && typeof value === 'object') || Array.isArray(value);
 }
 
+//---------------------------------------------------------------------------
+// isPrivilege()
+//
+// Returns a boolean indicating if the supplied value is a valid privilege.
+//---------------------------------------------------------------------------
+function isPrivilege(value) {
+  // Privileges are mutually exclusive and cannot be specified together
+  // except SYSPRELIM, which cannot be specified alone, it is specified in a
+  // combo with SYSOPER or SYSDBA.  SYSPRELIM is used only for
+  // startup/shutdown
+
+  // If SYSPRELIM specified, clear the bit
+  if (value & constants.SYSPRELIM) {
+    value = value ^ constants.SYSPRELIM;
+  }
+  return (
+    value === constants.SYSASM ||
+    value === constants.SYSBACKUP ||
+    value === constants.SYSDBA ||
+    value === constants.SYSDG ||
+    value === constants.SYSKM ||
+    value === constants.SYSOPER ||
+    value === constants.SYSRAC
+  );
+}
+
 function isShardingKey(value) {
   if (!Array.isArray(value))
     return false;
@@ -369,6 +396,7 @@ module.exports = {
   isArrayOfStrings,
   isObject,
   isObjectOrArray,
+  isPrivilege,
   isShardingKey,
   isSodaDocument,
   isTokenExpired,

package/lib/version.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oracledb",
-  "version": "6.5.0",
+  "version": "6.5.1",
   "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/",

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

@@ -1 +0,0 @@
-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

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

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

@@ -1 +0,0 @@
-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

@@ -1 +0,0 @@
-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

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