oracledb 6.8.0 → 6.9.0

package/README.md

@@ -1,10 +1,10 @@
-# node-oracledb version 6.8.0
+# 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"/>
 
 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.8.0 to connect Node.js 14.6, or later, to Oracle
+Use node-oracledb 6.9.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.
 
@@ -16,8 +16,42 @@ It is stable, well documented, and has a comprehensive test suite.
 
 ## Installation
 
+Run `npm install oracledb`
+
 See [Getting Started with Node-oracledb][1] and [Quick Start Node-oracledb Installation][2].
 
+## Dependencies and Interoperability
+
+- Node.js versions 14.17 and later.
+
+  Pre-built packages are available on [npm][14] and other mirror repositories.
+
+  Source code is also available.
+
+  Previous versions of node-oracledb supported older Node.js versions.
+
+- Oracle Client libraries are *optional* starting from node-oracledb 6.0.
+  Older versions of node-oracledb require Oracle Client libraries.
+
+  **Thin mode**: By default node-oracledb (from version 6.0 onwards) runs in a
+  'Thin' mode which connects directly to Oracle Database.
+
+  **Thick mode**: Some advanced Oracle Database functionality is currently only
+  available when optional Oracle Client libraries are loaded by
+  node-oracledb. Libraries are available in the free [Oracle Instant
+  Client][15] packages. Node-oracledb can use Oracle Client
+  libraries 11.2 through 23ai.
+
+- Oracle Database
+
+  **Thin mode**: Oracle Database 12.1 (or later) is required.
+
+  **Thick mode**: Oracle Database 9.2 (or later) is required, depending on the
+  Oracle Client library version.  Oracle Database's standard client-server
+  version interoperability allows connection to both older and newer
+  databases. For example when node-oracledb uses Oracle Client 19c libraries,
+  then it can connect to Oracle Database 11.2 or later.
+
 ## Documentation
 
 See [Documentation for the Oracle Database Node.js Add-on][9] and the [release
@@ -34,7 +68,7 @@ to join Slack][6]).
 
 ## <a name="testing"></a> Tests
 
-To run the test suite see [test/README][11].
+To run the test suite, see [test/README][11].
 
 ## Contributing
 
@@ -83,3 +117,5 @@ limitations under the License.
 [11]: https://github.com/oracle/node-oracledb/blob/main/test/README.md
 [12]: https://github.com/oracle/node-oracledb/blob/main/CONTRIBUTING.md
 [13]: https://github.com/oracle/node-oracledb/blob/main/SECURITY.md
+[14]: https://www.npmjs.com/package/oracledb
+[15]: https://www.oracle.com/database/technologies/instant-client.html

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

@@ -0,0 +1 @@
+oracledb-6.9.0-darwin-arm64.node v23.10.0 2eb94e8660458ba0f6a59a00ebaa1d65e380cbd9 9cbfa993c59da0cfba2baa65e1c51fc0216bf586 Tue, 15 Jul 2025 11:23:44 GMT

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

@@ -0,0 +1 @@
+oracledb-6.9.0-darwin-x64.node v22.16.0 2eb94e8660458ba0f6a59a00ebaa1d65e380cbd9 9cbfa993c59da0cfba2baa65e1c51fc0216bf586 Tue, 15 Jul 2025 11:07:19 GMT

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

@@ -0,0 +1 @@
+2eb94e8660458ba0f6a59a00ebaa1d65e380cbd9

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

@@ -0,0 +1 @@
+oracledb-6.9.0-linux-arm64.node v20.19.2 2eb94e8660458ba0f6a59a00ebaa1d65e380cbd9 9cbfa993c59da0cfba2baa65e1c51fc0216bf586 Tue, 15 Jul 2025 11:06:47 GMT

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

@@ -0,0 +1 @@
+oracledb-6.9.0-linux-x64.node v22.13.1 2eb94e8660458ba0f6a59a00ebaa1d65e380cbd9 9cbfa993c59da0cfba2baa65e1c51fc0216bf586 Tue, 15 Jul 2025 11:48:53 GMT

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

@@ -0,0 +1 @@
+oracledb-6.9.0-win32-x64.node v20.17.0 2eb94e8660458ba0f6a59a00ebaa1d65e380cbd9 9cbfa993c59da0cfba2baa65e1c51fc0216bf586 Tue, 15 Jul 2025 11:04:06 GMT

package/lib/aqMessage.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2019, 2022, Oracle and/or its affiliates.
+// Copyright (c) 2019, 2025, Oracle and/or its affiliates.
 
 //-----------------------------------------------------------------------------
 //
@@ -48,6 +48,15 @@ class AqMessage {
     return this._impl.getDelay();
   }
 
+  //---------------------------------------------------------------------------
+  // enqTime
+  //
+  // Property to indicate the enqueue time for the message.
+  //---------------------------------------------------------------------------
+  get enqTime() {
+    return this._impl.getEnqTime();
+  }
+
   //---------------------------------------------------------------------------
   // deliveryMode
   //

package/lib/configProviders/file.js

@@ -0,0 +1,72 @@
+// Copyright (c) 2025, Oracle and/or its affiliates.
+
+//-----------------------------------------------------------------------------
+//
+// This software is dual-licensed to you under the Universal Permissive License
+// (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl and Apache License
+// 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose
+// either license.
+//
+// If you elect to accept the software under the Apache License, Version 2.0,
+// the following applies:
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//    https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+//-----------------------------------------------------------------------------
+const fs = require('fs').promises;
+const util = require('node:util');
+const oracledb = require('oracledb');
+class locaJson {
+
+  constructor(provider_arg, urlExtendedPart) {
+    const params = new URLSearchParams(urlExtendedPart);
+    this.paramMap = new URLSearchParams([...params].map(([key, value]) => [key.toLowerCase(), value])); //parse the extended part and store parameters in Map
+    this.paramMap.set('filepath', provider_arg);
+  }
+  //---------------------------------------------------------------------------
+  // init()
+  //
+  // Require/import modules from ociobject
+  //---------------------------------------------------------------------------
+  init() {
+  // nothing to require
+  }
+  async returnConfig() {
+    const alias = this.paramMap.get('alias');
+    // Read input file
+    const data = Buffer.from(await fs.readFile(this.paramMap.get("filepath"), { encoding: 'utf8', flag: 'r' }));
+    // Converting to JSON
+    const listofAliases = JSON.parse(data);
+    if (alias) {
+      this.obj = listofAliases[alias];
+    } else {
+      this.obj = listofAliases;
+    }
+    return this.obj;
+  }
+}
+//---------------------------------------------------------------------------
+//  hookFn()
+//  hookFn will get registered to the driver while loading the plugins
+//---------------------------------------------------------------------------
+async function hookFn(args) {
+  const configProvider = new locaJson(args.provider_arg, args.urlExtendedPart);
+  try {
+    configProvider.init();
+  } catch (err) {
+    const errmsg = util.format('Centralized Config Provider failed to load required libraries. Please install the required libraries.\n %s', err.message);
+    throw new Error(errmsg);
+  }
+  return [await configProvider.returnConfig(), configProvider.credential];
+}
+oracledb.registerConfigurationProviderHook('file', hookFn);

package/lib/connection.js

@@ -110,6 +110,8 @@ class Connection extends EventEmitter {
     options.connection = this;
     if (options.keepInStmtCache === undefined)
       options.keepInStmtCache = true;
+    if (options.suspendOnSuccess === undefined)
+      options.suspendOnSuccess = false;
     settings.addToOptions(options,
       "autoCommit",
       "dbObjectAsPojo",
@@ -138,7 +140,12 @@ class Connection extends EventEmitter {
         }
         return (proxy);
       } else if (initialValue !== undefined) {
-        Object.assign(this, initialValue);
+        for (const attr of objType.attributes) {
+          const value = initialValue[attr.name];
+          if (value !== undefined) {
+            this._setAttrValue(attr, value);
+          }
+        }
       }
     };
     DbObject.prototype = Object.create(BaseDbObject.prototype);
@@ -591,6 +598,11 @@ class Connection extends EventEmitter {
       outOptions.keepInStmtCache = options.keepInStmtCache;
     }
 
+    if (options.suspendOnSuccess !== undefined) {
+      errors.assertParamPropBool(options, 2, "suspendOnSucess");
+      outOptions.suspendOnSuccess = options.suspendOnSuccess;
+    }
+
     // handle options specific to executeMany()
     if (inExecuteMany) {
 
@@ -701,6 +713,29 @@ class Connection extends EventEmitter {
     this._impl.setAction(value);
   }
 
+  //---------------------------------------------------------------------------
+  // beginSessionlessTransaction()
+  //
+  // Begin a new sessionless transaction with provided transactionId.
+  // If transactionId wasn't provided a random-generated transactionId will be
+  // used and returned.
+  //---------------------------------------------------------------------------
+  async beginSessionlessTransaction(options = {}) {
+    errors.assertArgCount(arguments, 0, 1);
+    errors.assertParamValue(nodbUtil.isObject(options), 1);
+    if (options.transactionId !== undefined)
+      errors.assertParamPropValue(
+        nodbUtil.isTransactionId(options.transactionId), 1, 'transactionId');
+    errors.assertParamPropUnsignedIntNonZero(options, 1, 'timeout');
+    errors.assertParamPropBool(options, 1, 'deferRoundTrip');
+    const normalizedTransactionId =
+      nodbUtil.normalizeTransactionId(options.transactionId);
+    const {timeout = 60, deferRoundTrip = false} = options;
+    await this._impl.startSessionlessTransaction(normalizedTransactionId,
+      timeout, constants.TPC_BEGIN_NEW, deferRoundTrip);
+    return normalizedTransactionId;
+  }
+
   //---------------------------------------------------------------------------
   // breakExecution()
   //
@@ -1255,6 +1290,18 @@ class Connection extends EventEmitter {
     this._impl.setInternalName(value);
   }
 
+  //---------------------------------------------------------------------------
+  // ltxid
+  //
+  // Property for identifying the logical transaction ID to avoid duplicate
+  // transactions. Used with Oracle Transaction Guard.
+  //---------------------------------------------------------------------------
+  get ltxid() {
+    if (this._impl)
+      return this._impl.getLTXID();
+    return undefined;
+  }
+
   //--------------------------------------------------------------------------
   // isHealthy()
   //
@@ -1407,6 +1454,25 @@ class Connection extends EventEmitter {
     return (stream);
   }
 
+  //---------------------------------------------------------------------------
+  // resumeSessionlessTransaction()
+  //
+  // Resume an existing sessionlesss transaction using given transactionId
+  //---------------------------------------------------------------------------
+  async resumeSessionlessTransaction(transactionId, options = {}) {
+    errors.assertArgCount(arguments, 1, 2);
+    errors.assertParamValue(nodbUtil.isTransactionId(transactionId), 1);
+    errors.assertParamValue(nodbUtil.isObject(options), 2);
+    errors.assertParamPropUnsignedInt(options, 2, 'timeout');
+    errors.assertParamPropBool(options, 2, 'deferRoundTrip');
+    const normalizedTransactionId =
+      nodbUtil.normalizeTransactionId(transactionId);
+    const {timeout = 60, deferRoundTrip = false} = options;
+    await this._impl.startSessionlessTransaction(normalizedTransactionId,
+      timeout, constants.TPC_BEGIN_RESUME, deferRoundTrip);
+    return normalizedTransactionId;
+  }
+
   //---------------------------------------------------------------------------
   // rollback()
   //
@@ -1521,6 +1587,17 @@ class Connection extends EventEmitter {
     return outValue;
   }
 
+  //---------------------------------------------------------------------------
+  // suspendSessionlessTransaction()
+  //
+  // Suspend any active sessionless transaction immediately
+  //---------------------------------------------------------------------------
+  async suspendSessionlessTransaction() {
+    errors.assertArgCount(arguments, 0, 0);
+    errors.assert(this._impl, errors.ERR_INVALID_CONNECTION);
+    await this._impl.suspendSessionlessTransaction();
+  }
+
   //---------------------------------------------------------------------------
   // tag
   //
@@ -1711,7 +1788,12 @@ class Connection extends EventEmitter {
     errors.assert(this._impl, errors.ERR_INVALID_CONNECTION);
     errors.assert(_subscriptions.has(name), errors.ERR_INVALID_SUBSCR);
     await this._impl.unsubscribe(_subscriptions.get(name));
-    _subscriptions.delete(name);
+
+    // Delay decreasing the reference count
+    // as NJS layer starts cleanup (uv_close) of async handle asynchronously.
+    setTimeout(() => {
+      _subscriptions.delete(name);
+    }, 0);
   }
 
 }
@@ -1724,6 +1806,7 @@ Connection.prototype.break =
 Connection.prototype.tpcRecover =
     nodbUtil.callbackify(nodbUtil.wrapFn(Connection.prototype.tpcRecover));
 nodbUtil.wrapFns(Connection.prototype,
+  "beginSessionlessTransaction",
   "changePassword",
   "close",
   "commit",
@@ -1734,10 +1817,12 @@ nodbUtil.wrapFns(Connection.prototype,
   "getQueue",
   "getStatementInfo",
   "ping",
+  "resumeSessionlessTransaction",
   "rollback",
   "shutdown",
   "startup",
   "subscribe",
+  "suspendSessionlessTransaction",
   "tpcBegin",
   "tpcCommit",
   "tpcEnd",

package/lib/dbObject.js

@@ -200,6 +200,15 @@ class BaseDbObject {
         if (implAttr.typeClass) {
           attr.typeClass = implAttr.typeClass;
         }
+        if (implAttr.precision != null) {
+          attr.precision = implAttr.precision;
+        }
+        if (implAttr.scale != null) {
+          attr.scale = implAttr.scale;
+        }
+        if (implAttr.maxSize != null) {
+          attr.maxSize = implAttr.maxSize;
+        }
         attrs[implAttr.name] = attr;
       }
       this._attributes = attrs;

package/lib/errors.js

@@ -175,6 +175,9 @@ const ERR_DB_FETCH_TYPE_HANDLER_CONVERTER = 166;
 const ERR_DB_FETCH_TYPE_HANDLER_RETURN_VALUE = 167;
 const ERR_ACCESS_TOKEN = 168;
 const ERR_CALLOUT_FN = 169;
+const ERR_SESSIONLESS_DIFFERING_METHODS = 170;
+const ERR_SESSIONLESS_ALREADY_ACTIVE = 171;
+const ERR_SESSIONLESS_INACTIVE = 172;
 
 // Oracle Net layer errors start from 500
 const ERR_CONNECTION_CLOSED = 500;
@@ -198,19 +201,15 @@ const ERR_INVALID_SERVICE_NAME = 518;
 const ERR_INVALID_SID = 519;
 const ERR_TNS_NAMES_FILE_MISSING = 520;
 const ERR_CONNECTION_EOF = 521;
-const ERR_AZURE_CONFIG_PROVIDER_AUTH_FAILED = 522;
 const ERR_CONFIG_PROVIDER_FAILED_TO_RETRIEVE_CONFIG = 523;
-const ERR_CONFIG_PROVIDER_NOT_SUPPORTED = 524;
-const ERR_CONFIG_PROVIDER_LOAD_FAILED = 525;
-const ERR_OCIOBJECT_CONFIG_PROVIDER_AUTH_FAILED = 526;
-const ERR_AZURE_VAULT_AUTH_FAILED = 527;
-const ERR_AZURE_SERVICE_PRINCIPAL_AUTH_FAILED = 528;
+const ERR_REGISTER_HOOKFN_CONFIGPROVIDER = 524;
 const ERR_WALLET_TYPE_NOT_SUPPORTED = 529;
 const ERR_HOST_NOT_FOUND = 530;
 const ERR_ANO_PACKET = 531;
 const ERR_ANO_STATUS = 532;
 const ERR_ANO_NEGOTIATION = 533;
 const ERR_DATA_COMPRESSION = 534;
+const ERR_CONFIG_PROVIDER_PARAM_TYPE = 535;
 
 // Oracle SUCCESS_WITH_INFO warning start from 700
 const WRN_COMPILATION_CREATE = 700;
@@ -228,11 +227,39 @@ adjustErrorXref.set("DPI-1080", ERR_CONNECTION_CLOSED);
 adjustErrorXref.set("OCI-22303", [ERR_INVALID_OBJECT_TYPE_NAME, 'type "([^"]*"."[^"]*)"']);
 adjustErrorXref.set("OCI-22164", ERR_DELETE_ELEMENTS_OF_VARRAY);
 adjustErrorXref.set("OCI-22165", [ERR_INVALID_COLL_INDEX_SET, /index \[([0-9]+)\] must be in the range of \[([0-9]+)\] to \[([0-9]+)\]/]);
+adjustErrorXref.set("ORA-00022", ERR_CONNECTION_CLOSED);
 adjustErrorXref.set("ORA-00028", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-00031", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-00045", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-00378", ERR_CONNECTION_CLOSED);
 adjustErrorXref.set("ORA-00600", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-00602", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-00603", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-00609", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-01012", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-01041", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-01043", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-01089", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-01092", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-02396", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-03113", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-03114", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-03122", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-03135", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-12153", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-12537", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-12547", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-12570", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-12583", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-27146", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-28511", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-56600", ERR_CONNECTION_CLOSED);
 adjustErrorXref.set("ORA-24338", ERR_INVALID_REF_CURSOR);
 adjustErrorXref.set("ORA-25708", ERR_TOKEN_HAS_EXPIRED);
 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);
 
 // define mapping for error messages
 const messages = new Map();
@@ -247,7 +274,7 @@ messages.set(ERR_INVALID_PARAMETER_VALUE,               // NJS-005
 messages.set(ERR_INVALID_PROPERTY_VALUE_IN_PARAM,       // NJS-007
   'invalid value for "%s" in parameter %d');
 messages.set(ERR_INVALID_NUMBER_OF_PARAMETERS,          // NJS-009
-  'invalid number of parameters');
+  'invalid number of function parameters: %d provided but expected between %d and %d');
 // used in C -- keep synchronized!
 messages.set(ERR_UNSUPPORTED_DATA_TYPE,                 // NJS-010
   'unsupported data type %d in column %d');
@@ -473,7 +500,7 @@ messages.set(ERR_INVALID_TPC_END_FLAGS,                 // NJS-151
 messages.set(ERR_UNKNOWN_TRANSACTION_STATE,             // NJS-152
   'internal error: unknown transaction state {state} in Two Phase Commit');
 messages.set(ERR_INVALID_TRANSACTION_SIZE,              // NJS-153
-  'size of the transaction ID is %d and cannot exceed 64');
+  'size of the transaction ID must be non-zero and must not exceed 64. Its current size is %d.');
 messages.set(ERR_INVALID_BRANCH_SIZE,                   // NJS-154
   'size of the branch ID is %d and cannot exceed 64');
 messages.set(ERR_OPERATION_NOT_SUPPORTED_ON_BFILE,      // NJS-155
@@ -498,19 +525,25 @@ messages.set(ERR_VECTOR_SPARSE_INVALID_INPUT,           // NJS-164
   'SPARSE VECTOR Invalid Input Data');
 messages.set(ERR_VECTOR_SPARSE_INDICES_ELEM_IS_NOT_VALID,    // NJS-165
   'SPARSE VECTOR indices element at index %d is not valid');
-messages.set(ERR_DB_FETCH_TYPE_HANDLER_CONVERTER,          // NJS-166
+messages.set(ERR_DB_FETCH_TYPE_HANDLER_CONVERTER,       // NJS-166
   'DBFetchTypeHandler return value attribute "converter" must be a function');
-messages.set(ERR_DB_FETCH_TYPE_HANDLER_RETURN_VALUE,       // NJS-167
+messages.set(ERR_DB_FETCH_TYPE_HANDLER_RETURN_VALUE,    // NJS-167
   'DBFetchTypeHandler return value must be an object');
 messages.set(ERR_ACCESS_TOKEN,                          // NJS-168
   'access token function failed.');
-messages.set(ERR_CALLOUT_FN,                         // NJS-169
+messages.set(ERR_CALLOUT_FN,                            // NJS-169
   'External function call failed.');
+messages.set(ERR_SESSIONLESS_DIFFERING_METHODS,         //NJS-170
+  'Different ways to start or suspend sessionless transactions are being used(server procedures and client APIs)');
+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');
 
 // Oracle Net layer errors
 
 messages.set(ERR_CONNECTION_CLOSED,                     // NJS-500
-  'connection to the Oracle Database was broken');
+  'connection to Oracle Database was closed or broken');
 messages.set(ERR_CONNECTION_LOSTCONTACT,                // NJS-501
   'connection to host %s port %d terminated unexpectedly. (CONNECTION_ID=%s)\n%s');
 messages.set(ERR_CONNECTION_INCOMPLETE,                 // NJS-503
@@ -551,20 +584,10 @@ messages.set(ERR_TNS_NAMES_FILE_MISSING,                // NJS-520
   'cannot connect to Oracle Database. File tnsnames.ora not found in %s');
 messages.set(ERR_CONNECTION_EOF,                        // NJS-521
   'connection to host %s port %d received end-of-file on communication channel. (CONNECTION_ID=%s)');
-messages.set(ERR_AZURE_CONFIG_PROVIDER_AUTH_FAILED,     // NJS-522
-  'Azure Authentication Failed: The authentication parameter value %s may be incorrect');
 messages.set(ERR_CONFIG_PROVIDER_FAILED_TO_RETRIEVE_CONFIG,   // NJS-523
   'Failed to retrieve configuration from Centralized Configuration Provider:\n %s');
-messages.set(ERR_CONFIG_PROVIDER_NOT_SUPPORTED,         // NJS-524
-  'Configuration Provider not supported: %s');
-messages.set(ERR_CONFIG_PROVIDER_LOAD_FAILED,           // NJS-525
-  'Centralized Config Provider failed to load required libraries. Please install the required libraries.\n %s');
-messages.set(ERR_OCIOBJECT_CONFIG_PROVIDER_AUTH_FAILED, // NJS-526
-  'OCI authentication failed: The authentication parameter value %s may be incorrect');
-messages.set(ERR_AZURE_VAULT_AUTH_FAILED,               // NJS-527
-  'Azure Vault: Provide correct Azure Vault authentication details');
-messages.set(ERR_AZURE_SERVICE_PRINCIPAL_AUTH_FAILED,   // NJS-528
-  'Azure service principal authentication requires either a client certificate path or a client secret string');
+messages.set(ERR_REGISTER_HOOKFN_CONFIGPROVIDER,         // NJS-524
+  '%s Configuration provider plugin not registered. Please register the hook function for the same');
 messages.set(ERR_WALLET_TYPE_NOT_SUPPORTED,             // NJS-529
   'Invalid wallet content format. Supported format is PEM');
 messages.set(ERR_HOST_NOT_FOUND,                        // NJS-530
@@ -577,6 +600,8 @@ messages.set(ERR_ANO_NEGOTIATION,                       // NJS-533
   'Advanced Networking Option service negotiation failed. Native Network Encryption and DataIntegrity only supported in node-oracledb thick mode.\nCause: ORA-%s');
 messages.set(ERR_DATA_COMPRESSION, 'Error during data compression/decompression: %s\n'); //NJS-534
 // Oracle SUCCESS_WITH_INFO warning
+messages.set(ERR_CONFIG_PROVIDER_PARAM_TYPE,               // NJS-535
+  'Parameter does not have a valid type: %s\n');
 messages.set(WRN_COMPILATION_CREATE,                    // NJS-700
   'creation succeeded with compilation errors');
 
@@ -601,7 +626,7 @@ function assert(condition) {
 //-----------------------------------------------------------------------------
 function assertArgCount(args, minArgCount, maxArgCount) {
   assert(args.length >= minArgCount && args.length <= maxArgCount,
-    ERR_INVALID_NUMBER_OF_PARAMETERS);
+    ERR_INVALID_NUMBER_OF_PARAMETERS, args.length, minArgCount, maxArgCount);
 }
 
 //-----------------------------------------------------------------------------
@@ -728,6 +753,7 @@ function getErr(errorNum) {
   args[0] = `${code}: ${baseText}`;
   const err = new Error(util.format(...args));
   err.code = code;
+  err.isRecoverable = (errorNum === ERR_CONNECTION_CLOSED);
   Error.captureStackTrace(err, getErr);
   return err;
 }
@@ -904,13 +930,9 @@ module.exports = {
   ERR_NO_CONFIG_DIR,
   ERR_TNS_ENTRY_NOT_FOUND,
   ERR_CONNECTION_EOF,
-  ERR_AZURE_CONFIG_PROVIDER_AUTH_FAILED,
-  ERR_OCIOBJECT_CONFIG_PROVIDER_AUTH_FAILED,
-  ERR_AZURE_VAULT_AUTH_FAILED,
-  ERR_AZURE_SERVICE_PRINCIPAL_AUTH_FAILED,
   ERR_CONFIG_PROVIDER_FAILED_TO_RETRIEVE_CONFIG,
-  ERR_CONFIG_PROVIDER_NOT_SUPPORTED,
-  ERR_CONFIG_PROVIDER_LOAD_FAILED,
+  ERR_CONFIG_PROVIDER_PARAM_TYPE,
+  ERR_REGISTER_HOOKFN_CONFIGPROVIDER,
   ERR_DATA_COMPRESSION,
   ERR_WALLET_TYPE_NOT_SUPPORTED,
   ERR_HOST_NOT_FOUND,
@@ -974,6 +996,9 @@ module.exports = {
   ERR_UNKNOWN_TRANSACTION_STATE,
   ERR_INVALID_TRANSACTION_SIZE,
   ERR_INVALID_BRANCH_SIZE,
+  ERR_SESSIONLESS_DIFFERING_METHODS,
+  ERR_SESSIONLESS_ALREADY_ACTIVE,
+  ERR_SESSIONLESS_INACTIVE,
   ERR_CONNECTION_CLOSED_CODE: `${ERR_PREFIX}-${ERR_CONNECTION_CLOSED}`,
   ERR_OPERATION_NOT_SUPPORTED_ON_BFILE,
   ERR_OPERATION_ONLY_SUPPORTED_ON_BFILE,

package/lib/impl/connection.js

@@ -289,6 +289,15 @@ class ConnectionImpl {
     errors.throwNotImplemented("getting the internal name");
   }
 
+  //---------------------------------------------------------------------------
+  // getLTXID()
+  //
+  // Returns the the logical transaction ID for database transactions.
+  //---------------------------------------------------------------------------
+  getLTXID() {
+    errors.throwNotImplemented("getting the logical transaction id");
+  }
+
   //---------------------------------------------------------------------------
   // getMaxIdentifierLength()
   //

package/lib/impl/pool.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2022, Oracle and/or its affiliates.
+// Copyright (c) 2022, 2025, Oracle and/or its affiliates.
 
 //-----------------------------------------------------------------------------
 //
@@ -165,6 +165,15 @@ class PoolImpl {
     errors.throwNotImplemented("getting the pool timeout");
   }
 
+  //---------------------------------------------------------------------------
+  // getMaxLifetimeSession()
+  //
+  // Returns the pool max lifetime for a session.
+  //---------------------------------------------------------------------------
+  getMaxLifetimeSession() {
+    errors.throwNotImplemented("getting the pool max lifetime");
+  }
+
   //---------------------------------------------------------------------------
   // getStmtCacheSize()
   //

package/lib/impl/resultset.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2022, 2023, Oracle and/or its affiliates.
+// Copyright (c) 2022, 2025, Oracle and/or its affiliates.
 
 //-----------------------------------------------------------------------------
 //
@@ -43,8 +43,9 @@ class ResultSetImpl extends BaseImpl {
   // _determineFetchType()
   //
   // Determine the fetch type to use for the specified metadata.
+  // Param rowsetMetaData includes metadata of all the columns fetched.
   //---------------------------------------------------------------------------
-  _determineFetchType(metadata, options) {
+  _determineFetchType(metadata, options, rowsetMetaData) {
 
     // clear any previous fetch type and converter functions that may have been
     // retained
@@ -54,7 +55,7 @@ class ResultSetImpl extends BaseImpl {
     // if a fetch type handler is specified, call it; if no value (undefined)
     // is returned, the normal processing takes place
     if (options.fetchTypeHandler) {
-      const result = options.fetchTypeHandler(metadata);
+      const result = options.fetchTypeHandler(metadata, rowsetMetaData);
       if (result !== undefined) {
         errors.assert(typeof result === 'object',
           errors.ERR_FETCH_TYPE_HANDLER_RETURN_VALUE);
@@ -232,7 +233,7 @@ class ResultSetImpl extends BaseImpl {
         info.dbTypeClass = cls;
       }
       nodbUtil.addTypeProperties(info, "dbType");
-      this._determineFetchType(info, options);
+      this._determineFetchType(info, options, metaData);
       if (info.fetchType === types.DB_TYPE_CURSOR) {
         this.nestedCursorIndices.push(i);
       } else if (info.fetchType === types.DB_TYPE_CLOB ||

package/lib/lob.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2016, 2024, Oracle and/or its affiliates.
+// Copyright (c) 2016, 2025, Oracle and/or its affiliates.
 
 //-----------------------------------------------------------------------------
 //
@@ -246,6 +246,14 @@ class Lob extends Duplex {
     this._checkIsBfile();
     errors.assertArgCount(arguments, 1, 1);
     errors.assertParamValue(nodbUtil.isObject(a1), 1);
+    errors.assertParamValue(Object.hasOwn(a1, "dirName"), 1);
+    errors.assertParamValue(Object.hasOwn(a1, "fileName"), 1);
+    errors.assertPropValue(
+      a1.dirName != "" && a1.dirName != null, "dirName"
+    );
+    errors.assertPropValue(
+      a1.fileName != "" && a1.fileName != null, "fileName"
+    );
     this._impl.setDirFileName(a1);
   }