Final changes and example updates for 6.8 release

Author: sharadraju

doc/src/release_notes.rst

@@ -8,7 +8,7 @@ node-oracledb Release Notes
 For deprecated and desupported features, see
 :ref:`Deprecations and desupported features <deprecations>`.
 
-node-oracledb `v6.8.0 <https://github.com/oracle/node-oracledb/compare/v6.7.1...v6.8.0>`__ (TBD)
+node-oracledb `v6.8.0 <https://github.com/oracle/node-oracledb/compare/v6.7.1...v6.8.0>`__ (26 Feb 2025)
 ---------------------------------------------------------------------------------------------------------
 
 Common Changes

examples/sampleocicloudnativetokenauth.js

@@ -79,6 +79,7 @@ async function run() {
   //   connectString:       The NODE_ORACLEDB_CONNECTIONSTRING environment
   //                        variable set to the Oracle Net alias or connect
   //                        descriptor of your Oracle Autonomous Database
+  //   walletPassword:      Required if we are using mTLS connection
   // Configuration for tokenAuthConfigOci:
   //   authType:            Must be set to authentication type.
   //                        Types are:
@@ -96,6 +97,7 @@ async function run() {
     externalAuth: true,
     homogeneous: true,
     connectString: process.env.NODE_ORACLEDB_CONNECTIONSTRING,
+    walletPassword: process.env.NODE_ORACLEDB_WALLET_PASSWORD,
   };
 
   try {
@@ -136,7 +138,7 @@ async function createConnection() {
 }
 
 async function closePoolAndExit() {
-  console.log('\nTerminating');
+  console.log('\nExiting the program');
   try {
     // Get the pool from the pool cache and close it
     await oracledb.getPool().close(0);

examples/sampleocitokenauth.js

@@ -1,4 +1,4 @@
-/* Copyright (c) 2023, 2024, Oracle and/or its affiliates. */
+/* Copyright (c) 2023, 2025, Oracle and/or its affiliates. */
 
 /******************************************************************************
  *
@@ -149,6 +149,7 @@ async function run() {
   //   connectString:       The NODE_ORACLEDB_CONNECTIONSTRING environment
   //                        variable set to the Oracle Net alias or connect
   //                        descriptor of your Oracle Autonomous Database
+  //   walletPassword:      Required if we are using mTLS connection
   //   accessTokenConfig:   Parameter values needed for token generation
   //                        through OCI SDK.
   // Configuration for accessTokenConfig:
@@ -165,6 +166,7 @@ async function run() {
     externalAuth: true,
     homogeneous: true,
     connectString: process.env.NODE_ORACLEDB_CONNECTIONSTRING,
+    walletPassword: process.env.NODE_ORACLEDB_WALLET_PASSWORD,
   };
 
   try {
@@ -205,7 +207,7 @@ async function createConnection() {
 }
 
 async function closePoolAndExit() {
-  console.log('\nTerminating');
+  console.log('\nExiting the program');
   try {
     // Get the pool from the pool cache and close it
     await oracledb.getPool().close(0);

test/binding_DMLInsert.js

@@ -1,4 +1,4 @@
-/* Copyright (c) 2017, 2023, Oracle and/or its affiliates. */
+/* Copyright (c) 2017, 2025, Oracle and/or its affiliates. */
 
 /******************************************************************************
  *
@@ -104,7 +104,9 @@ describe('92.binding_DMLInsert.js', function() {
             },
             // ORA-01877: string is too long for internal buffer
             // ORA-01866: the datetime class is invalid
-            /ORA-01877:|ORA-01866:/
+            // ORA-01830: The string being converted to a date is too long to
+            // match the date format 'DD-MON-RR HH.MI.SSXFF AM'
+            /ORA-01877:|ORA-01866:|ORA-01830:/
           );
         }
         if (dbColType === "BLOB" || dbColType.indexOf("RAW") > -1) {

test/connection.js

@@ -849,7 +849,14 @@ describe('1. connection.js', function() {
 
       // Whitespaces, comma, ( and ) are replaced by ? for the program name
       // in V$SESSION
-      const sanitizedProgName = process.argv0.replace(/[\s(),]/g, '?');
+      let sanitizedProgName = process.argv0.replace(/[\s(),]/g, '?');
+      /*
+        In Oracle < 23.0 DB, The program name (program column in v$session view)
+        can be set only upto 48 characters.
+      */
+      const serverVersion = conn.oracleServerVersion;
+      if (serverVersion < 2300000000)
+        sanitizedProgName = sanitizedProgName.substring(0, 48);
 
       // Fetch values from v$session
       let res = await conn.execute(sqlSessionDetails);
@@ -875,7 +882,6 @@ describe('1. connection.js', function() {
         In Oracle 12.1.1 DB, The driver name (CLIENT_DRIVER column in V$SESSION_CONNECT_INFO view)
         can be set only upto 8 characters.
       */
-      const serverVersion = conn.oracleServerVersion;
       if (serverVersion < 1201000200)
         assert.strictEqual(res.rows[0][0], "node-ora");
       else assert.strictEqual(res.rows[0][0], "node-oracledb : " + oracledb.versionString + " thn");