oracledb 6.9.0 → 6.10.0

package/README.md

@@ -1,10 +1,10 @@
-# node-oracledb version 6.9.0 <img src="https://img.shields.io/npm/v/oracledb.svg" alt="oracledb"/>  <img src="https://img.shields.io/npm/dm/oracledb.svg" alt="oracledb"/>
+# node-oracledb version 6.10.0 <img src="https://img.shields.io/npm/v/oracledb.svg" alt="oracledb"/>  <img src="https://img.shields.io/npm/dm/oracledb.svg" alt="oracledb"/>
 
 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.9.0 to connect Node.js 14.17, or later, to Oracle
+Use node-oracledb 6.10.0 to connect Node.js 14.17, or later, to Oracle
 Database.  Older versions of node-oracledb may work with older versions of
 Node.js.
 

package/build/Release/oracledb-6.10.0-darwin-arm64.node-buildinfo.txt

@@ -0,0 +1 @@
+oracledb-6.10.0-darwin-arm64.node v22.17.1 71ba4e79b3fb8ffe6191e84eb0422c9bdfbb6c9d 8b14d5980d7d6116abb8865c7baed9e458698dbf Thu, 09 Oct 2025 15:26:22 GMT

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

@@ -0,0 +1 @@
+oracledb-6.10.0-darwin-x64.node v20.11.1 71ba4e79b3fb8ffe6191e84eb0422c9bdfbb6c9d 8b14d5980d7d6116abb8865c7baed9e458698dbf Thu, 09 Oct 2025 15:33:20 GMT

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

@@ -0,0 +1 @@
+71ba4e79b3fb8ffe6191e84eb0422c9bdfbb6c9d

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

@@ -0,0 +1 @@
+oracledb-6.10.0-linux-arm64.node v20.19.2 71ba4e79b3fb8ffe6191e84eb0422c9bdfbb6c9d 8b14d5980d7d6116abb8865c7baed9e458698dbf Thu, 09 Oct 2025 13:43:20 GMT

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

@@ -0,0 +1 @@
+oracledb-6.10.0-linux-x64.node v22.16.0 71ba4e79b3fb8ffe6191e84eb0422c9bdfbb6c9d 8b14d5980d7d6116abb8865c7baed9e458698dbf Thu, 09 Oct 2025 13:31:19 GMT

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

@@ -0,0 +1 @@
+oracledb-6.10.0-win32-x64.node v22.17.1 71ba4e79b3fb8ffe6191e84eb0422c9bdfbb6c9d 8b14d5980d7d6116abb8865c7baed9e458698dbf Thu, 09 Oct 2025 13:31:10 GMT

package/lib/aqDeqOptions.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2019, 2023, Oracle and/or its affiliates.
+// Copyright (c) 2019, 2025, Oracle and/or its affiliates.
 
 //-----------------------------------------------------------------------------
 //
@@ -74,6 +74,23 @@ class AqDeqOptions {
     this._impl.setCorrelation(value);
   }
 
+  //---------------------------------------------------------------------------
+  // deliveryMode
+  //
+  // Property for the delivery mode to use for dequeuing messages.
+  //---------------------------------------------------------------------------
+  get deliveryMode() {
+    return null;
+  }
+
+  set deliveryMode(value) {
+    errors.assertPropValue(value === constants.AQ_MSG_DELIV_MODE_PERSISTENT ||
+      value === constants.AQ_MSG_DELIV_MODE_BUFFERED ||
+      value === constants.AQ_MSG_DELIV_MODE_PERSISTENT_OR_BUFFERED,
+    "deliveryMode");
+    this._impl.setDeliveryMode(value);
+  }
+
   //---------------------------------------------------------------------------
   // mode
   //

package/lib/aqQueue.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2019, 2024, Oracle and/or its affiliates.
+// Copyright (c) 2019, 2025, Oracle and/or its affiliates.
 
 //-----------------------------------------------------------------------------
 //
@@ -87,17 +87,21 @@ class AqQueue {
       }
     }
 
-    // validate payload
+    // validate payload/queue type compatibility
     if (this._isJson) {
       message.payload = transformer.transformJsonValue(payload);
-    } else if (typeof payload === 'string') {
+    } else if (typeof payload === 'string' || Buffer.isBuffer(payload)) {
       message.payload = Buffer.from(payload);
-    } else if (Buffer.isBuffer(payload)) {
-      message.payload = payload;
-    } else {
+    } else if (this._payloadType == types.DB_TYPE_OBJECT) {
+      if (!(payload instanceof BaseDbObject) ||
+        (this._payloadTypeName !== payload._impl._objType.name))
+        errors.throwErr(errors.ERR_PAYLOAD_CANNOT_BE_ENQUEUED);
       message.payload = payload._impl;
+    } else {
+      errors.throwErr(errors.ERR_PAYLOAD_CANNOT_BE_ENQUEUED);
     }
 
+
     // validate options, if applicable
     if (message.correlation !== undefined) {
       errors.assertParamPropValue(typeof message.correlation === 'string', 1,

package/lib/connection.js

@@ -827,7 +827,12 @@ class Connection extends EventEmitter {
 
     this._closing = true;
     try {
-      await this._impl.close(options);
+      // If connection is part of a pool, notify the pool of its availability
+      if (this._pool) {
+        await this._pool._release(this._impl, options);
+      } else {
+        await this._impl.close(options);
+      }
     } finally {
       this._closing = false;
     }
@@ -839,7 +844,6 @@ class Connection extends EventEmitter {
       }
     }
     this._dbObjectClasses.clear();
-    this.emit('_afterConnClose');
   }
 
   //---------------------------------------------------------------------------

package/lib/dbObject.js

@@ -79,6 +79,18 @@ function validatePropertyValue(objType, metaData, value, index) {
 // instantiated; a cache of these classes are maintained on each connection
 class BaseDbObject {
 
+  //---------------------------------------------------------------------------
+  // _ensureCollection()
+  //
+  // Ensures that the object is a collection.
+  //---------------------------------------------------------------------------
+  _ensureCollection() {
+    if (!this.isCollection) {
+      errors.throwErr(errors.ERR_OBJECT_IS_NOT_A_COLLECTION,
+        this.name);
+    }
+  }
+
   //---------------------------------------------------------------------------
   // _getAttrValue()
   //
@@ -165,6 +177,7 @@ class BaseDbObject {
   //---------------------------------------------------------------------------
   append(value) {
     errors.assertArgCount(arguments, 1, 1);
+    this._ensureCollection();
     const info = {
       fqn: this._objType.fqn,
       type: this._objType.elementType,
@@ -238,6 +251,7 @@ class BaseDbObject {
   //---------------------------------------------------------------------------
   deleteElement(index) {
     errors.assertArgCount(arguments, 1, 1);
+    this._ensureCollection();
     errors.assertParamValue(Number.isInteger(index), 1);
     return this._impl.deleteElement(index);
   }
@@ -300,6 +314,7 @@ class BaseDbObject {
   //---------------------------------------------------------------------------
   getElement(index) {
     errors.assertArgCount(arguments, 1, 1);
+    this._ensureCollection();
     errors.assertParamValue(Number.isInteger(index), 1);
     const value = this._impl.getElement(index);
     return this._transformValueOut(value, this.elementTypeClass, this._objType.elementTypeInfo);
@@ -312,6 +327,7 @@ class BaseDbObject {
   //---------------------------------------------------------------------------
   getKeys() {
     errors.assertArgCount(arguments, 0, 0);
+    this._ensureCollection();
     return this._impl.getKeys();
   }
 
@@ -322,6 +338,7 @@ class BaseDbObject {
   //---------------------------------------------------------------------------
   getFirstIndex() {
     errors.assertArgCount(arguments, 0, 0);
+    this._ensureCollection();
     return this._impl.getFirstIndex();
   }
 
@@ -332,6 +349,7 @@ class BaseDbObject {
   //---------------------------------------------------------------------------
   getLastIndex() {
     errors.assertArgCount(arguments, 0, 0);
+    this._ensureCollection();
     return this._impl.getLastIndex();
   }
 
@@ -342,6 +360,7 @@ class BaseDbObject {
   //---------------------------------------------------------------------------
   getNextIndex(index) {
     errors.assertArgCount(arguments, 1, 1);
+    this._ensureCollection();
     errors.assertParamValue(Number.isInteger(index), 1);
     return this._impl.getNextIndex(index);
   }
@@ -353,6 +372,7 @@ class BaseDbObject {
   //---------------------------------------------------------------------------
   getPrevIndex(index) {
     errors.assertArgCount(arguments, 1, 1);
+    this._ensureCollection();
     errors.assertParamValue(Number.isInteger(index), 1);
     return this._impl.getPrevIndex(index);
   }
@@ -364,6 +384,7 @@ class BaseDbObject {
   //---------------------------------------------------------------------------
   getValues() {
     errors.assertArgCount(arguments, 0, 0);
+    this._ensureCollection();
     const values = this._impl.getValues();
     for (let i = 0; i < values.length; i++) {
       values[i] = this._transformValueOut(values[i], this.elementTypeClass, this._objType.elementTypeInfo);
@@ -378,6 +399,7 @@ class BaseDbObject {
   //---------------------------------------------------------------------------
   hasElement(index) {
     errors.assertArgCount(arguments, 1, 1);
+    this._ensureCollection();
     errors.assertParamValue(Number.isInteger(index), 1);
     return this._impl.hasElement(index);
   }
@@ -426,6 +448,7 @@ class BaseDbObject {
   //---------------------------------------------------------------------------
   setElement(index, value) {
     errors.assertArgCount(arguments, 2, 2);
+    this._ensureCollection();
     errors.assertParamValue(Number.isInteger(index), 1);
     const info = {
       fqn: this._objType.fqn,
@@ -445,6 +468,7 @@ class BaseDbObject {
   //---------------------------------------------------------------------------
   trim(numToTrim) {
     errors.assertArgCount(arguments, 1, 1);
+    this._ensureCollection();
     errors.assertParamValue(Number.isInteger(numToTrim) && numToTrim >= 0, 1);
     this._impl.trim(numToTrim);
   }
@@ -487,10 +511,7 @@ class BaseDbObject {
   //---------------------------------------------------------------------------
   toMap() {
     errors.assertArgCount(arguments, 0, 0);
-    if (!this.isCollection) {
-      errors.throwErr(errors.ERR_OBJECT_IS_NOT_A_COLLECTION,
-        this.name);
-    }
+    this._ensureCollection();
     const result = new Map();
     this.getKeys().forEach(element => {
       result.set(element, this.getElement(element));

package/lib/errors.js

@@ -178,6 +178,8 @@ const ERR_CALLOUT_FN = 169;
 const ERR_SESSIONLESS_DIFFERING_METHODS = 170;
 const ERR_SESSIONLESS_ALREADY_ACTIVE = 171;
 const ERR_SESSIONLESS_INACTIVE = 172;
+const ERR_INVALID_SERVER_RESPONSE = 173;
+const ERR_PAYLOAD_CANNOT_BE_ENQUEUED = 174;
 
 // Oracle Net layer errors start from 500
 const ERR_CONNECTION_CLOSED = 500;
@@ -260,6 +262,7 @@ adjustErrorXref.set("ORA-24344", WRN_COMPILATION_CREATE);
 adjustErrorXref.set("ORA-26202", ERR_SESSIONLESS_INACTIVE);
 adjustErrorXref.set("ORA-26211", ERR_SESSIONLESS_DIFFERING_METHODS);
 adjustErrorXref.set("ORA-26216", ERR_SESSIONLESS_ALREADY_ACTIVE);
+adjustErrorXref.set("DPI-1071", ERR_PAYLOAD_CANNOT_BE_ENQUEUED);
 
 // define mapping for error messages
 const messages = new Map();
@@ -398,9 +401,9 @@ messages.set(ERR_EXEC_MODE_ONLY_FOR_DML,                // NJS-095
 messages.set(ERR_INVALID_BIND_NAME,                     // NJS-097
   'no bind placeholder named ":%s" was found in the statement text');
 messages.set(ERR_WRONG_NUMBER_OF_BINDS,                 // NJS-098
-  '%s bind placeholders were used in the SQL statement but %s bind values were provided');
+  '%d bind placeholders were used in the SQL statement but %d bind values were provided');
 messages.set(ERR_BUFFER_LENGTH_INSUFFICIENT,            // NJS-099
-  'internal error: buffer of length %s insufficient to hold %s bytes');
+  'internal error: buffer of length %d insufficient to hold %d bytes');
 messages.set(ERR_NCHAR_CS_NOT_SUPPORTED,                // NJS-100
   'national character set id %d is not supported by node-oracledb in Thin mode');
 messages.set(ERR_MISSING_CREDENTIALS,                   // NJS-101
@@ -539,6 +542,11 @@ messages.set(ERR_SESSIONLESS_ALREADY_ACTIVE,            //NJS-171
   'Suspend, commit or rollback the currently active sessionless transaction before beginning or resuming another one.');
 messages.set(ERR_SESSIONLESS_INACTIVE,                  //NJS-172
   'No sessionless transaction is active');
+messages.set(ERR_INVALID_SERVER_RESPONSE,               //NJS-173
+  'Invalid server response to connection request');
+messages.set(ERR_PAYLOAD_CANNOT_BE_ENQUEUED,            // NJS-174
+  "Payload cannot be enqueued since it does not match the payload type supported by the queue");
+
 
 // Oracle Net layer errors
 
@@ -670,8 +678,8 @@ function assertParamPropInt(obj, parameterNum, propName) {
 //-----------------------------------------------------------------------------
 // assertParamPropUnsignedInt()
 //
-// Asserts that the property value of a parameter is a positive integer value
-// (or undefined).
+// Asserts that the property value of a parameter is a non-negative integer
+// value (or undefined).
 //-----------------------------------------------------------------------------
 function assertParamPropUnsignedInt(obj, parameterNum, propName) {
   if (obj[propName] !== undefined) {
@@ -999,6 +1007,8 @@ module.exports = {
   ERR_SESSIONLESS_DIFFERING_METHODS,
   ERR_SESSIONLESS_ALREADY_ACTIVE,
   ERR_SESSIONLESS_INACTIVE,
+  ERR_INVALID_SERVER_RESPONSE,
+  ERR_PAYLOAD_CANNOT_BE_ENQUEUED,
   ERR_CONNECTION_CLOSED_CODE: `${ERR_PREFIX}-${ERR_CONNECTION_CLOSED}`,
   ERR_OPERATION_NOT_SUPPORTED_ON_BFILE,
   ERR_OPERATION_ONLY_SUPPORTED_ON_BFILE,

package/lib/impl/aqDeqOptions.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2022, Oracle and/or its affiliates.
+// Copyright (c) 2022, 2025, Oracle and/or its affiliates.
 
 //-----------------------------------------------------------------------------
 //
@@ -138,6 +138,15 @@ class AqDeqOptionsImpl {
     errors.throwNotImplemented("setting correlation (dequeue options)");
   }
 
+  //---------------------------------------------------------------------------
+  // setDeliveryMode()
+  //
+  // Sets the delivery mode to use for dequeuing messages.
+  //---------------------------------------------------------------------------
+  setDeliveryMode() {
+    errors.throwNotImplemented("setting deliveryMode (dequeue options)");
+  }
+
   //---------------------------------------------------------------------------
   // setMode()
   //

package/lib/impl/datahandlers/buffer.js

@@ -397,6 +397,18 @@ class BaseBuffer {
     return buf;
   }
 
+  //---------------------------------------------------------------------------
+  // readBytesAndLength()
+  //
+  // Reads the UB4 length from the buffer and then returns a Buffer containing
+  // the specified number of bytes.
+  //---------------------------------------------------------------------------
+  readBytesAndLength() {
+    const numBytes = this.readUB4();
+    if (numBytes > 0)
+      return this.readBytesWithLength();
+  }
+
   //---------------------------------------------------------------------------
   // readBytesWithLength()
   //
@@ -548,6 +560,17 @@ class BaseBuffer {
     return Buffer.from(buf).swap16().toString('utf16le');
   }
 
+  //---------------------------------------------------------------------------
+  // readStrAndLength()
+  //
+  // Reads a length from the buffer and then, if the length is non-zero, reads
+  // string from the buffer and returns it.
+  //---------------------------------------------------------------------------
+  readStrAndLength() {
+    const buf = this.readBytesAndLength();
+    return buf ? buf.toString() : null;
+  }
+
   //---------------------------------------------------------------------------
   // readUB2()
   //
@@ -997,6 +1020,32 @@ class BaseBuffer {
     this.buf.writeInt32BE(n, pos);
   }
 
+  //---------------------------------------------------------------------------
+  // writeSB4()
+  //
+  // Writes a signed integer (up to 4 bytes in length) in variable length
+  // format to the buffer.
+  //---------------------------------------------------------------------------
+  writeSB4(value) {
+    let sign = 0;
+    if (value < 0) {
+      value = -value;
+      sign = 0x80;
+    }
+    if (value === 0) {
+      this.writeUInt8(0);
+    } else if (value <= 0xff) {
+      this.writeUInt8(1 | sign);
+      this.writeUInt8(value);
+    } else if (value <= 0xffff) {
+      this.writeUInt8(2 | sign);
+      this.writeUInt16BE(value);
+    } else {
+      this.writeUInt8(4 | sign);
+      this.writeUInt32BE(value);
+    }
+  }
+
   //---------------------------------------------------------------------------
   // writeUB4()
   //

package/lib/impl/datahandlers/oson.js

@@ -549,8 +549,13 @@ class OsonTreeSegment extends GrowableBuffer {
 
     // handle numbers
     } else if (typeof value === 'number') {
-      this.writeUInt8(constants.TNS_JSON_TYPE_NUMBER_LENGTH_UINT8);
-      this.writeOracleNumber(value.toString());
+      if (Number.isNaN(value)) {
+        this.writeUInt8(constants.TNS_JSON_TYPE_BINARY_DOUBLE);
+        this.writeBinaryDouble(value);
+      } else {
+        this.writeUInt8(constants.TNS_JSON_TYPE_NUMBER_LENGTH_UINT8);
+        this.writeOracleNumber(value.toString());
+      }
 
     // handle strings
     } else if (typeof value === 'string') {

package/lib/impl/sodaDocument.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2022, 2023, Oracle and/or its affiliates.
+// Copyright (c) 2022, 2025, Oracle and/or its affiliates.
 
 //-----------------------------------------------------------------------------
 //
@@ -31,21 +31,12 @@ const errors = require('../errors.js');
 class SodaDocumentImpl {
 
   //---------------------------------------------------------------------------
-  // getContentAsBuffer()
+  // getContent()
   //
-  // Returns the document content as a Buffer object.
+  // Returns the document content.
   //---------------------------------------------------------------------------
-  getContentAsBuffer() {
-    errors.throwNotImplemented("getting doc content as a buffer");
-  }
-
-  //---------------------------------------------------------------------------
-  // getContentAsString()
-  //
-  // Returns the document content as a string.
-  //---------------------------------------------------------------------------
-  getContentAsString() {
-    errors.throwNotImplemented("getting doc content as a string");
+  getContent() {
+    errors.throwNotImplemented("getting doc content");
   }
 
   //---------------------------------------------------------------------------

package/lib/oracledb.js

@@ -585,7 +585,10 @@ async function _verifyOptions(options, inCreatePool) {
       errors.throwErr(errors.ERR_WRONG_CRED_FOR_EXTAUTH);
     }
     if (outOptions.user) {
-      if (inCreatePool) {
+
+      if (inCreatePool && !settings.thin) {
+        // Thick mode currently does not allow proxy users to specified
+        // during pool creation.
         errors.throwErr(errors.ERR_WRONG_CRED_FOR_EXTAUTH);
       } else if (outOptions.user[0] !== '[' || outOptions.user.slice(-1) !== ']') {
         // username is not enclosed in [].
@@ -914,6 +917,7 @@ async function _setConfigParameters(obj, credential, configProvider) {
     configObject[key] = val;
   }
   configObject.connectString = obj.connect_descriptor;
+  configObject.configTTL = obj.config_time_to_live;
   if (!configObject.connectString)
     errors.throwErr(errors.ERR_CONFIG_PROVIDER_FAILED_TO_RETRIEVE_CONFIG, 'connect_descriptor must be set');
 
@@ -986,32 +990,37 @@ async function _retrieveParamValueFromVault(paramObj, credential, configProvider
 //-----------------------------------------------------------------------------
 // _checkConfigProvider()
 //
-// Look for the config provider in the connection string and retreives
+// Look for the config provider in the connection string and retrieves
 // object stored in the config Provider.
 // Returns object based on precedence between input object and the one retrieved
 // from Config Provider.
 //-----------------------------------------------------------------------------
 async function _checkConfigProvider(options) {
   // Time for Cache entries to be deleted in milliseconds
-  const cacheEntriesDuration = settings.configProviderCacheTimeout * 1000;
-  let secondOpts;
+  let cacheEntriesDuration = settings.configProviderCacheTimeout * 1000;
+  let secondOpts, cachedConfigEntry;
   const url = options.connectString || options.connectionString;
   if (!url)
     return options;
 
-  if (configProviderCache && configProviderCache.has(url) && ((Date.now() - configProviderCache.get(url).timeAdded) < cacheEntriesDuration)) {
-    const cacheOpts1 = configProviderCache.get(url).cacheOpts;
-    secondOpts = { ...cacheOpts1};
+  if (configProviderCache && (cachedConfigEntry = configProviderCache.get(url))) {
+    const config = cachedConfigEntry.cacheOpts;
+    if (config.configTTL)
+      cacheEntriesDuration = config.configTTL * 1000;
 
-    //deobfuscate password
-    if (secondOpts.password)
-      secondOpts.password = protocolUtil.getDeobfuscatedValue(secondOpts.password.value, secondOpts.password.obfuscatedValue);
+    if ((Date.now() - cachedConfigEntry.timeAdded) < cacheEntriesDuration) {
+      secondOpts = { ...config};
 
-    //deobfuscate walletContent
-    if (secondOpts.walletContent)
-      secondOpts.walletContent = protocolUtil.getDeobfuscatedValue(secondOpts.walletContent.value, secondOpts.walletContent.obfuscatedValue);
+      //deobfuscate password
+      if (secondOpts.password)
+        secondOpts.password = protocolUtil.getDeobfuscatedValue(secondOpts.password.value, secondOpts.password.obfuscatedValue);
 
-  } else {
+      //deobfuscate walletContent
+      if (secondOpts.walletContent)
+        secondOpts.walletContent = protocolUtil.getDeobfuscatedValue(secondOpts.walletContent.value, secondOpts.walletContent.obfuscatedValue);
+    }
+  }
+  if (!secondOpts) {
     let parsedUrl = url;
     let urlExtendedPart;
     const baseRegex = new RegExp("^config-(?<provider>[A-Za-z0-9]+)(://)(?<provider_arg>[^?]+)");