oracledb 6.6.0 → 6.7.1

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

@@ -0,0 +1 @@
+oracledb-6.7.1-darwin-arm64.node v22.2.0 3f1f1cc28d6ee3c6489f660d243b4a79ada60299 ca4b004c471033328549f8b4d461cb5985fe2230 Fri, 13 Dec 2024 13:19:16 GMT

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

@@ -0,0 +1 @@
+oracledb-6.7.1-darwin-x64.node v20.11.1 3f1f1cc28d6ee3c6489f660d243b4a79ada60299 ca4b004c471033328549f8b4d461cb5985fe2230 Fri, 13 Dec 2024 11:43:56 GMT

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

@@ -0,0 +1 @@
+3f1f1cc28d6ee3c6489f660d243b4a79ada60299

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

@@ -0,0 +1 @@
+oracledb-6.7.1-linux-arm64.node v20.16.0 3f1f1cc28d6ee3c6489f660d243b4a79ada60299 ca4b004c471033328549f8b4d461cb5985fe2230 Fri, 13 Dec 2024 14:47:19 GMT

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

@@ -0,0 +1 @@
+oracledb-6.7.1-linux-x64.node v20.16.0 3f1f1cc28d6ee3c6489f660d243b4a79ada60299 ca4b004c471033328549f8b4d461cb5985fe2230 Fri, 13 Dec 2024 14:40:02 GMT

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

@@ -0,0 +1 @@
+oracledb-6.7.1-win32-x64.node v20.0.0 3f1f1cc28d6ee3c6489f660d243b4a79ada60299 ca4b004c471033328549f8b4d461cb5985fe2230 Fri, 13 Dec 2024 14:18:47 GMT

package/examples/example.js

@@ -1,4 +1,4 @@
-/* Copyright (c) 2018, 2023, Oracle and/or its affiliates. */
+/* Copyright (c) 2018, 2024, Oracle and/or its affiliates. */
 
 /******************************************************************************
  *
@@ -47,16 +47,16 @@ const dbConfig = require('./dbconfig.js');
 if (process.env.NODE_ORACLEDB_DRIVER_MODE === 'thick') {
 
   // Thick mode requires Oracle Client or Oracle Instant Client libraries.
-  // On Windows and macOS Intel you can specify the directory containing the
+  // On Windows and macOS you can specify the directory containing the
   // libraries at runtime or before Node.js starts.  On other platforms (where
   // Oracle libraries are available) the system library search path must always
   // include the Oracle library path before Node.js starts.  If the search path
   // is not correct, you will get a DPI-1047 error.  See the node-oracledb
   // installation documentation.
   let clientOpts = {};
-  // On Windows and macOS Intel platforms, set the environment
-  // variable NODE_ORACLEDB_CLIENT_LIB_DIR to the Oracle Client library path
-  if (process.platform === 'win32' || (process.platform === 'darwin' && process.arch === 'x64')) {
+  // On Windows and macOS platforms, set the environment variable
+  // NODE_ORACLEDB_CLIENT_LIB_DIR to the Oracle Client library path
+  if (process.platform === 'win32' || process.platform === 'darwin') {
     clientOpts = { libDir: process.env.NODE_ORACLEDB_CLIENT_LIB_DIR };
   }
   oracledb.initOracleClient(clientOpts);  // enable node-oracledb Thick mode

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

@@ -748,6 +748,11 @@ class Connection extends EventEmitter {
     }
 
     delete this._impl;
+    if (!this.thin) {
+      for (const cls of this._dbObjectClasses.values()) {
+        cls._objType.refCleanup();
+      }
+    }
     this._dbObjectClasses.clear();
     this.emit('_afterConnClose');
   }
@@ -869,10 +874,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 +893,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 +903,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 +1050,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 +1656,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,8 @@ 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;
+const ERR_HOST_NOT_FOUND = 530;
 
 // Oracle SUCCESS_WITH_INFO warning start from 700
 const WRN_COMPILATION_CREATE = 700;
@@ -352,8 +355,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 +459,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 +479,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
@@ -507,23 +512,27 @@ 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
+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
+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
+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
+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');
-// Oracle SUCCESS_WITH_INFO warning
+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
+  'The host addresses or URLs provided by the connect string are incorrect or unresolvable in your network.');
 
-messages.set(WRN_COMPILATION_CREATE,                           // NJS-700
+// Oracle SUCCESS_WITH_INFO warning
+messages.set(WRN_COMPILATION_CREATE,                          // NJS-700
   'creation succeeded with compilation errors');
 
 //-----------------------------------------------------------------------------
@@ -837,8 +846,10 @@ 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_HOST_NOT_FOUND,
   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 +908,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()