oracledb 6.6.0 → 6.7.0

package/README.md

@@ -1,10 +1,10 @@
-# node-oracledb version 6.6.0
+# node-oracledb version 6.7.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.6.0 to connect Node.js 14.6, or later, to Oracle
+Use node-oracledb 6.7.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.7.0-darwin-arm64.node-buildinfo.txt

@@ -0,0 +1 @@
+oracledb-6.7.0-darwin-arm64.node v22.2.0 29e0b9cfc2f22f3df1e6b746323fb5f1f95ba492 3f4e00888d20e313374cfe0fb148de2180eaf93f Thu, 07 Nov 2024 06:28:34 GMT

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

@@ -0,0 +1 @@
+oracledb-6.7.0-darwin-x64.node v20.11.1 29e0b9cfc2f22f3df1e6b746323fb5f1f95ba492 3f4e00888d20e313374cfe0fb148de2180eaf93f Thu, 07 Nov 2024 06:21:29 GMT

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

@@ -0,0 +1 @@
+29e0b9cfc2f22f3df1e6b746323fb5f1f95ba492

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

@@ -0,0 +1 @@
+oracledb-6.7.0-linux-arm64.node v18.20.4 29e0b9cfc2f22f3df1e6b746323fb5f1f95ba492 3f4e00888d20e313374cfe0fb148de2180eaf93f Thu, 07 Nov 2024 16:48:12 GMT

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

@@ -0,0 +1 @@
+oracledb-6.7.0-linux-x64.node v16.20.2 29e0b9cfc2f22f3df1e6b746323fb5f1f95ba492 3f4e00888d20e313374cfe0fb148de2180eaf93f Thu, 07 Nov 2024 16:47:47 GMT

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

@@ -0,0 +1 @@
+oracledb-6.7.0-win32-x64.node v18.16.0 29e0b9cfc2f22f3df1e6b746323fb5f1f95ba492 3f4e00888d20e313374cfe0fb148de2180eaf93f Thu, 07 Nov 2024 16:23:47 GMT

package/examples/README.md

@@ -65,6 +65,7 @@ File Name                                                 | Description
 [`aqraw.js`](aqraw.js)                                    | Basic Oracle Advanced Queuing (AQ) example passing text messages
 [`aqutil.js`](aqutil.js)                                  | Common file to setup the user credentials for all the Advanced Queuing (AQ) examples.
 [`blobhttp.js`](blobhttp.js)                              | Simple web app that streams an image
+[`azureConfigProvider.js`](azureConfigProvider.js)        | Show how to connect to an Oracle Database using Azure Configuration Providers
 [`calltimeout.js`](calltimeout.js)                        | Shows how to cancel a SQL statement if it doesn't complete in a specified time
 [`connect.js`](connect.js)                                | Basic example for creating a standalone (non-pooled) connection
 [`connectionpool.js`](connectionpool.js)                  | Basic example creating a pool of connections
@@ -101,6 +102,7 @@ File Name                                                 | Description
 [`lobstream2.js`](lobstream2.js)                          | Shows using Stream data events to fetch a CLOB
 [`lowercasecolumns.js`](lowercasecolumns.js)              | Shows how a type handler can convert column names to lower case
 [`metadata.js`](metadata.js)                              | Shows the metadata available after executing SELECT statements
+[`ociConfigProvider.js`](ociConfigProvider.js)            | Show how to connect to an Oracle Database using OCI Configuration Providers
 [`plsqlarray.js`](plsqlarray.js)                          | Examples of binding PL/SQL "INDEX BY" tables
 [`plsqlfunc.js`](plsqlfunc.js)                            | How to call a PL/SQL function
 [`plsqlproc.js`](plsqlproc.js)                            | How to call a PL/SQL procedure

package/lib/configProviders/azure.js

@@ -40,11 +40,11 @@ class AzureProvider extends base {
   //---------------------------------------------------------------------------
   // init()
   //
-  // Require/import modules from azure
+  // Require/import modules from Azure SDK
   //---------------------------------------------------------------------------
   init() {
-    ({AppConfigurationClient } = require("@azure/app-configuration"));
-    ({ClientSecretCredential, ClientCertificateCredential, ChainedTokenCredential, ManagedIdentityCredential, EnvironmentCredential} = require("@azure/identity"));
+    ({ AppConfigurationClient } = require("@azure/app-configuration"));
+    ({ ClientSecretCredential, ClientCertificateCredential, ChainedTokenCredential, ManagedIdentityCredential, EnvironmentCredential } = require("@azure/identity"));
   }
 
   //---------------------------------------------------------------------------
@@ -112,11 +112,11 @@ class AzureProvider extends base {
   async returnConfig() {
     const configObject = {};
     const label = this.paramMap.get("label");
-    const credential = this._returnCredential();
+    this.credential = this._returnCredential();
     // azure config store
     const client = new AppConfigurationClient(
       "https://" + this.paramMap.get("appconfigname"), // ex: <https://<your appconfig resource>.azconfig.io>
-      credential
+      this.credential
     );
     // retrieve connect_description
     configObject.connectString = (await this._getConfigurationSetting(client, this.paramMap.get("key") + 'connect_descriptor', label)).value;
@@ -139,29 +139,40 @@ class AzureProvider extends base {
       configObject.user = null;
     }
     //retrieve password
-    let pwdJson = null;
+    configObject.password = await this.retrieveParamValueFromVault(client, label, 'password');
+    // retrieve wallet_location
+    configObject.walletContent = await this.retrieveParamValueFromVault(client, label, 'wallet_location');
+    if (configObject.walletContent) {
+      //only Pem file supported
+      if (!this.isPemFile(configObject.walletContent))
+        errors.throwErr(errors.ERR_WALLET_TYPE_NOT_SUPPORTED);
+    }
+    return configObject;
+  }
+  async retrieveParamValueFromVault(client, label, param) {
+    let paramJson = null;
     try {
-      pwdJson = await this._getConfigurationSetting(client, this.paramMap.get("key") + 'password', label);
+      paramJson = await this._getConfigurationSetting(client, this.paramMap.get("key") + param, label);
     } catch {
-      configObject.password = null;
+      return null;
     }
-    if (pwdJson) {
+    if (paramJson) {
       let obj;
       try {
-        obj = JSON.parse(pwdJson.value);
+        obj = JSON.parse(paramJson.value);
       } catch {
-        obj = pwdJson.value;
+        obj = paramJson.value;
       }
       if (obj.uri) {
         const { SecretClient } = require("@azure/keyvault-secrets");
         const vault_detail = await this._parsePwd(obj.uri);
-        const client1 = new SecretClient(vault_detail[0], credential);
-        configObject.password  = (await client1.getSecret(vault_detail[1])).value;
+        const client1 = new SecretClient(vault_detail[0], this.credential);
+        return  (await client1.getSecret(vault_detail[1])).value;
       } else {
-        configObject.password = pwdJson.value;
+        return paramJson.value;
       }
     }
-    return configObject;
+
   }
 }
 module.exports = AzureProvider;

package/lib/configProviders/base.js

@@ -26,49 +26,35 @@
 
 'use strict';
 
+const pemHeaders = [
+  '-----BEGIN CERTIFICATE-----',
+  '-----BEGIN PUBLIC KEY-----',
+  '-----BEGIN PRIVATE KEY-----',
+  '-----BEGIN RSA PRIVATE KEY-----',
+  '-----BEGIN DSA PRIVATE KEY-----',
+  '-----BEGIN EC PRIVATE KEY-----',
+  '-----BEGIN ENCRYPTED PRIVATE KEY-----'
+];
+const pemFooters = [
+  '-----END CERTIFICATE-----',
+  '-----END PUBLIC KEY-----',
+  '-----END PRIVATE KEY-----',
+  '-----END RSA PRIVATE KEY-----',
+  '-----END DSA PRIVATE KEY-----',
+  '-----END EC PRIVATE KEY-----',
+  '-----END ENCRYPTED PRIVATE KEY-----'
+];
 class base {
   constructor(url) {
     const params = new URLSearchParams(url);
     this.paramMap = new URLSearchParams([...params].map(([key, value]) => [key.toLowerCase(), value])); //parse the extended part and store parameters in Map
   }
 
-  /**
-  * Sets precedence for different parameters in cloudConfig/userConfig
-  * @param {cloudConfig} object - object retreived from cloud
-  * @param {userConfig} object -  user input Object
-  */
-  modifyOptionsPrecedence(cloudConfig, userConfig) {
-    // create a copy of userConfig object
-    userConfig = { ...userConfig };
-    if (!userConfig.user)
-      userConfig.user = cloudConfig.user;
-    if (!userConfig.password)
-      userConfig.password = cloudConfig.password;
-    if (cloudConfig.connectString) {
-      userConfig.connectString = cloudConfig.connectString;
-      userConfig.connectionString = undefined;
-    }
-    if (cloudConfig.poolMin)
-      userConfig.poolMin = cloudConfig.poolMin;
-    if (cloudConfig.poolMax)
-      userConfig.poolMax = cloudConfig.poolMax;
-    if (cloudConfig.poolIncrement)
-      userConfig.poolIncrement = cloudConfig.poolIncrement;
-    if (cloudConfig.poolTimeout)
-      userConfig.poolTimeout = cloudConfig.poolTimeout;
-    if (cloudConfig.poolPingInterval)
-      userConfig.poolPingInterval = cloudConfig.poolPingInterval;
-    if (cloudConfig.poolPingTimeout)
-      userConfig.poolPingTimeout = cloudConfig.poolPingTimeout;
-    if (cloudConfig.stmtCacheSize)
-      userConfig.stmtCacheSize = cloudConfig.stmtCacheSize;
-    if (cloudConfig.prefetchRows)
-      userConfig.prefetchRows = cloudConfig.prefetchRows;
-    if (cloudConfig.lobPrefetch)
-      userConfig.lobPrefetch = cloudConfig.lobPrefetch;
-
-    return userConfig;
-
+  isPemFile(content) {
+    //remove any line breaks at the end of the content
+    content = content.trim();
+    return pemHeaders.some(header => content.includes(header)) &&
+         pemFooters.some(footer => content.endsWith(footer));
   }
 
   //---------------------------------------------------------------------------

package/lib/configProviders/ociobject.js

@@ -29,10 +29,9 @@ const errors = require("../errors.js");
 const { base } = require("./base.js");
 const fs = require('fs');
 
-const cloud_net_naming_pattern_oci = new RegExp("(?<objservername>[A-Za-z0-9._-]+)/n/" + "(?<namespace>[A-Za-z0-9._-]+)/b/" + "(?<bucketname>[A-Za-z0-9._-]+)/o/" + "(?<filename>[A-Za-z0-9._-]+)" + "(/c/(?<alias>.+))?$");
+const cloud_net_naming_pattern_oci = new RegExp("(?<objservername>[A-Za-z0-9._-]+)/n/" + "(?<namespace>[A-Za-z0-9._-]+)/b/" + "(?<bucketname>[A-Za-z0-9._-]+)/o/" + "(?<filename>[A-Za-z0-9._-]+)$");
 // object to store module references that will be populated by init()
 const oci = {};
-
 class OCIProvider extends base {
   constructor(provider_arg, urlExtendedPart) {
     super(urlExtendedPart);
@@ -42,8 +41,6 @@ class OCIProvider extends base {
       this._addParam("namespace", match.groups.namespace);
       this._addParam("bucketname", match.groups.bucketname);
       this._addParam("filename", match.groups.filename);
-      if (match.groups.alias)
-        this._addParam("alias", match.groups.alias);
     }
   }
 
@@ -127,65 +124,41 @@ class OCIProvider extends base {
   //---------------------------------------------------------------------------
   async returnConfig() {
     const configObject = {};
-    const credential = await this._returnCredential();
+    this.credential = await this._returnCredential();
     // oci object store
     const client_oci = new (oci.objectstorage).ObjectStorageClient({
-      authenticationDetailsProvider: credential
+      authenticationDetailsProvider: this.credential
     });
     const getObjectRequest = {
       objectName: this.paramMap.get('filename'),
       bucketName: this.paramMap.get('bucketname'),
       namespaceName: this.paramMap.get('namespace')
     };
-    let credential1;
     const getObjectResponse = await client_oci.getObject(getObjectRequest);
     const resp = await this._streamToString(getObjectResponse.value);
     // Entire object we get from OCI Object Storage
-    let obj = JSON.parse(resp);
-    const userAlias = this.paramMap.get('alias');
+    this.obj = JSON.parse(resp);
+    const userAlias = this.paramMap.get('key'); // alias
     if (userAlias) {
-      obj = obj[userAlias];
+      this.obj = this.obj[userAlias];
     }
     const pmSection = 'node-oracledb';
-    const params = obj[pmSection];
+    const params = this.obj[pmSection];
     for (const key in params) {
       var val = params[key];
       configObject[key] = val;
     }
-    configObject.connectString = obj.connect_descriptor;
-    configObject.user = obj.user;
-    if (obj.password) {
-      if (obj.password.type == "vault-azure") {
-        if (obj.password.authentication) {
-          const { SecretClient } = require("@azure/keyvault-secrets");
-          const {ClientSecretCredential, ClientCertificateCredential} = require("@azure/identity");
-          if (obj.password.authentication.azure_client_secret)
-            credential1 = new ClientSecretCredential(obj.password.authentication.azure_tenant_id, obj.password.authentication.azure_client_id, obj.password.authentication.azure_client_secret);
-          else if (obj.password.authentication.azure_client_certificate_path)
-            credential1 = new ClientCertificateCredential(obj.password.authentication.azure_tenant_id, obj.password.authentication.azure_client_id, obj.password.authentication.azure_client_certificate_path);
-          else
-            errors.throwErr(errors.ERR_AZURE_VAULT_AUTH_FAILED);
-          const vault_detail = await this._parsePwd(obj.password.value);
-          const client1 = new SecretClient(vault_detail[0], credential1);
-          configObject.password = (await client1.getSecret(vault_detail[1])).value;
-        } else {
-          errors.throwErr(errors.ERR_AZURE_VAULT_AUTH_FAILED);
-        }
-      } else if (obj.password.type == "vault-oci") {
-        const secrets = require('oci-secrets');
-        const secretClientOci =  new secrets.SecretsClient({
-          authenticationDetailsProvider: credential
-        });
-        const getSecretBundleRequest = {
-          secretId: obj.password.value
-        };
-        const getSecretBundleResponse = await secretClientOci.getSecretBundle(getSecretBundleRequest);
-        configObject.password = getSecretBundleResponse.secretBundle.secretBundleContent.content;
-      } else if (obj.password) {
-        configObject.password = obj.password;
-      }
-    } else {
-      configObject.password = null;
+    configObject.connectString = this.obj.connect_descriptor;
+    configObject.user = this.obj.user;
+    if (this.obj.password) {
+      configObject.password = await this.retrieveParamValueFromVault('password');
+    }
+    if (this.obj.wallet_location) {
+      // retrieve wallet_location
+      configObject.walletContent = await this.retrieveParamValueFromVault('wallet_location');
+      //only Pem file supported
+      if (!this.isPemFile(configObject.walletContent))
+        errors.throwErr(errors.ERR_WALLET_TYPE_NOT_SUPPORTED);
     }
     return configObject;
   }
@@ -199,5 +172,40 @@ class OCIProvider extends base {
     const arr = objservername.split(".");
     return arr[1].toUpperCase().replaceAll('-', '_');
   }
+
+  async retrieveParamValueFromVault(param) {
+    if (this.obj[param].type == "azurevault") {
+      if (this.obj[param].authentication) {
+        const { SecretClient } = require("@azure/keyvault-secrets");
+        const {ClientSecretCredential, ClientCertificateCredential} = require("@azure/identity");
+        if (this.obj[param].authentication.azure_client_secret)
+          this.credential = new ClientSecretCredential(this.obj[param].authentication.azure_tenant_id, this.obj[param].authentication.azure_client_id, this.obj[param].authentication.azure_client_secret);
+        else if (this.obj[param].authentication.azure_client_certificate_path)
+          this.credential = new ClientCertificateCredential(this.obj[param].authentication.azure_tenant_id, this.obj[param].authentication.azure_client_id, this.obj[param].authentication.azure_client_certificate_path);
+        else
+          errors.throwErr(errors.ERR_AZURE_VAULT_AUTH_FAILED);
+        const vault_detail = await this._parsePwd(this.obj[param].value);
+        const client1 = new SecretClient(vault_detail[0], this.credential);
+        return (await client1.getSecret(vault_detail[1])).value;
+      } else {
+        errors.throwErr(errors.ERR_AZURE_VAULT_AUTH_FAILED);
+      }
+    } else if (this.obj[param].type == "ocivault") {
+      const secrets = require('oci-secrets');
+      const secretClientOci =  new secrets.SecretsClient({
+        authenticationDetailsProvider: this.credential
+      });
+      const getSecretBundleRequest = {
+        secretId: this.obj[param].value
+      };
+      const getSecretBundleResponse = await secretClientOci.getSecretBundle(getSecretBundleRequest);
+      const base64content = getSecretBundleResponse.secretBundle.secretBundleContent.content;
+      // decode base64 content
+      const returnVal = Buffer.from(base64content, "base64").toString("utf-8");
+      return returnVal;
+    }  else {
+      return this.obj[param];
+    }
+  }
 }
 module.exports = OCIProvider;

package/lib/connection.js

@@ -869,10 +869,15 @@ class Connection extends EventEmitter {
     let binds = [];
     let options = {};
 
+    errors.assert(this._impl, errors.ERR_INVALID_CONNECTION);
+
     // process arguments
     if (nodbUtil.isObject(sql) && typeof sql.statement === 'string') {
       errors.assertArgCount(arguments, 1, 2);
       if (sql.values) {
+        if (this._impl._callLevelTraceData) {
+          this._impl._callLevelTraceData.values = sql.values;
+        }
         binds = await this._processExecuteBinds(sql.values);
       }
       sql = sql.statement;
@@ -883,6 +888,9 @@ class Connection extends EventEmitter {
       errors.assertArgCount(arguments, 1, 3);
       errors.assertParamValue(typeof sql === 'string', 1);
       if (arguments.length >= 2) {
+        if (this._impl._callLevelTraceData) {
+          this._impl._callLevelTraceData.values = a2;
+        }
         binds = await this._processExecuteBinds(a2);
       }
       if (arguments.length == 3) {
@@ -890,11 +898,13 @@ class Connection extends EventEmitter {
       }
     }
     this._addDefaultsToExecOpts(options);
-    errors.assert(this._impl, errors.ERR_INVALID_CONNECTION);
 
     // perform actual execute
     let result;
     try {
+      if (this._impl._callLevelTraceData) {
+        this._impl._callLevelTraceData.statement = sql;
+      }
       result = await this._impl.execute(sql, numIters, binds, options, false);
     } catch (err) {
       if (err.errorNum === 1406)
@@ -1035,6 +1045,63 @@ class Connection extends EventEmitter {
     return this._impl && this._impl.getDbName();
   }
 
+  //---------------------------------------------------------------------------
+  // hostName (READONLY)
+  //
+  // Property for identifying the hostName of the Oracle Database.
+  //---------------------------------------------------------------------------
+  get hostName() {
+    return this._impl && this._impl.getHostName();
+  }
+
+  //---------------------------------------------------------------------------
+  // port (READONLY)
+  //
+  // Property for identifying the port to which client is connected.
+  //---------------------------------------------------------------------------
+  get port() {
+    return this._impl && this._impl.getPort();
+  }
+
+  //---------------------------------------------------------------------------
+  // protocol (READONLY)
+  //
+  // Property for identifying the protocol used to connect to Oracle Database.
+  //---------------------------------------------------------------------------
+  get protocol() {
+    return this._impl && this._impl.getProtocol();
+  }
+
+  //---------------------------------------------------------------------------
+  // connectString (READONLY)
+  //
+  // User provided connectString to connect to Oracle Database.
+  //---------------------------------------------------------------------------
+  get connectString() {
+    return this._impl && this._impl._connectString;
+  }
+
+  //---------------------------------------------------------------------------
+  // user
+  //
+  // User property provided to connect to Oracle Database.
+  //---------------------------------------------------------------------------
+  get user() {
+    if (this.currentSchema.length) {
+      return this.currentSchema;
+    }
+    return this._impl && this._impl._user;
+  }
+
+  //---------------------------------------------------------------------------
+  // connectTraceConfig
+  //
+  // Property for getting the connection related config.
+  //---------------------------------------------------------------------------
+  get connectTraceConfig() {
+    return this._impl && this._impl._getConnectTraceConfig();
+  }
+
   //---------------------------------------------------------------------------
   // getDbObjectClass()
   //
@@ -1584,9 +1651,9 @@ class Connection extends EventEmitter {
 // that cannot take place concurrently
 // NOTE: breakExecution() should not be serialized
 Connection.prototype.break =
-    nodbUtil.callbackify(Connection.prototype.breakExecution);
+    nodbUtil.callbackify(nodbUtil.wrapFn(Connection.prototype.breakExecution));
 Connection.prototype.tpcRecover =
-    nodbUtil.callbackify(Connection.prototype.tpcRecover);
+    nodbUtil.callbackify(nodbUtil.wrapFn(Connection.prototype.tpcRecover));
 nodbUtil.wrapFns(Connection.prototype,
   "changePassword",
   "close",

package/lib/errors.js

@@ -108,7 +108,7 @@ const ERR_MISSING_FILE = 91;
 const ERR_INVALID_NUMBER_OF_CONNECTIONS = 92;
 const ERR_EXEC_MODE_ONLY_FOR_DML = 95;
 const ERR_INVALID_BIND_NAME = 97;
-const ERR_WRONG_NUMBER_OF_POSITIONAL_BINDS = 98;
+const ERR_WRONG_NUMBER_OF_BINDS = 98;
 const ERR_BUFFER_LENGTH_INSUFFICIENT = 99;
 const ERR_NCHAR_CS_NOT_SUPPORTED = 100;
 const ERR_MISSING_CREDENTIALS = 101;
@@ -163,6 +163,7 @@ const ERR_INVALID_TRANSACTION_SIZE = 153;
 const ERR_INVALID_BRANCH_SIZE = 154;
 const ERR_OPERATION_NOT_SUPPORTED_ON_BFILE = 155;
 const ERR_OPERATION_ONLY_SUPPORTED_ON_BFILE = 156;
+const ERR_EXECMANY_NOT_ALLOWED_ON_QUERIES = 157;
 
 // Oracle Net layer errors start from 500
 const ERR_CONNECTION_CLOSED = 500;
@@ -193,6 +194,7 @@ 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_WALLET_TYPE_NOT_SUPPORTED = 529;
 
 // Oracle SUCCESS_WITH_INFO warning start from 700
 const WRN_COMPILATION_CREATE = 700;
@@ -352,8 +354,8 @@ messages.set(ERR_EXEC_MODE_ONLY_FOR_DML,                // NJS-095
   'setting "batchErrors" or "dmlRowCounts" to true is only permitted for DML statements');
 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_POSITIONAL_BINDS,      // NJS-098
-  '%s positional bind values are required but %s were provided');
+messages.set(ERR_WRONG_NUMBER_OF_BINDS,                 // NJS-098
+  '%s bind placeholders were used in the SQL statement but %s bind values were provided');
 messages.set(ERR_BUFFER_LENGTH_INSUFFICIENT,            // NJS-099
   'internal error: buffer of length %s insufficient to hold %s bytes');
 messages.set(ERR_NCHAR_CS_NOT_SUPPORTED,                // NJS-100
@@ -456,12 +458,14 @@ 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');
-messages.set(ERR_INVALID_BRANCH_SIZE,              // NJS-154
+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
   'operation is not supported on BFILE LOBs');
 messages.set(ERR_OPERATION_ONLY_SUPPORTED_ON_BFILE,     // NJS-156
   'operation is only supported on BFILE LOBs');
+messages.set(ERR_EXECMANY_NOT_ALLOWED_ON_QUERIES,       // NJS-157
+  'executeMany() cannot be used with SELECT statement or WITH SQL clause');
 
 // Oracle Net layer errors
 
@@ -474,7 +478,7 @@ messages.set(ERR_CONNECTION_INCOMPLETE,                 // NJS-503
 messages.set(ERR_PROXY_CONNECTION_FAILURE,              // NJS-504
   'connection establishment through a web proxy at host %s port %d failed. (CONNECTION_ID=%s)\n%s');
 messages.set(ERR_TLS_INIT_FAILURE,                      // NJS-505
-  'unable to initiate TLS connection. Please check if wallet credentials are valid');
+  'unable to initiate TLS connection. Please check if wallet credentials are valid\n%s');
 messages.set(ERR_TLS_AUTH_FAILURE,                      // NJS-506
   'connection to host %s port %d encountered TLS handshake failure. (CONNECTION_ID=%s)\n%s');
 messages.set(ERR_TLS_DNMATCH_FAILURE,                   // NJS-507
@@ -521,6 +525,7 @@ 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_WALLET_TYPE_NOT_SUPPORTED, 'Invalid wallet content format. Supported format is PEM');// NJS-529
 // Oracle SUCCESS_WITH_INFO warning
 
 messages.set(WRN_COMPILATION_CREATE,                           // NJS-700
@@ -837,8 +842,9 @@ module.exports = {
   ERR_CONFIG_PROVIDER_FAILED_TO_RETRIEVE_CONFIG,
   ERR_CONFIG_PROVIDER_NOT_SUPPORTED,
   ERR_CONFIG_PROVIDER_LOAD_FAILED,
+  ERR_WALLET_TYPE_NOT_SUPPORTED,
   ERR_INVALID_BIND_NAME,
-  ERR_WRONG_NUMBER_OF_POSITIONAL_BINDS,
+  ERR_WRONG_NUMBER_OF_BINDS,
   ERR_BUFFER_LENGTH_INSUFFICIENT,
   ERR_NCHAR_CS_NOT_SUPPORTED,
   ERR_MISSING_CREDENTIALS,
@@ -897,6 +903,7 @@ module.exports = {
   ERR_CONNECTION_CLOSED_CODE: `${ERR_PREFIX}-${ERR_CONNECTION_CLOSED}`,
   ERR_OPERATION_NOT_SUPPORTED_ON_BFILE,
   ERR_OPERATION_ONLY_SUPPORTED_ON_BFILE,
+  ERR_EXECMANY_NOT_ALLOWED_ON_QUERIES,
   WRN_COMPILATION_CREATE,
   assert,
   assertArgCount,

package/lib/impl/aqQueue.js

@@ -27,8 +27,9 @@
 'use strict';
 
 const errors = require('../errors.js');
+const BaseImpl = require('./base.js');
 
-class AqQueueImpl {
+class AqQueueImpl extends BaseImpl {
 
   //---------------------------------------------------------------------------
   // _getConnImpl()

package/lib/impl/base.js

@@ -0,0 +1,45 @@
+// Copyright (c) 2024, 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.
+//
+//-----------------------------------------------------------------------------
+
+'use strict';
+
+class BaseImpl {
+
+  //---------------------------------------------------------------------------
+  // _getConnectTraceConfig()
+  //
+  // Retrieves connect trace config from connection object.
+  //---------------------------------------------------------------------------
+  _getConnectTraceConfig() {
+    const connImpl = this._getConnImpl();
+    if (connImpl) {
+      return connImpl._getConnectTraceConfig();
+    }
+  }
+
+}
+
+module.exports = BaseImpl;