Bump min supported Node.js version to 14.17

Author: sharadraju

README.md

@@ -4,7 +4,7 @@ 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.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.
 
@@ -22,7 +22,7 @@ See [Getting Started with Node-oracledb][1] and [Quick Start Node-oracledb Insta
 
 ## Dependencies and Interoperability
 
-- Node.js versions 14.6 and later.
+- Node.js versions 14.17 and later.
 
   Pre-built packages are available on [npm][14] and other mirror repositories.
 

doc/src/release_notes.rst

@@ -66,6 +66,9 @@ Common Changes
 #)  Fixed bug which does not trigger PL/SQL functions registered for callbacks
     properly when using implicit pooling with temporary LOBs creation.
 
+#)  Bumped the minimum Node.js version required to 14.17 since
+    ``crypto.randomUUID()`` is used for Sessionless Transactions.
+
 #)  Improved NJS error messages.
 
 Thin Mode Changes

doc/src/user_guide/installation.rst

@@ -226,7 +226,7 @@ Installation Requirements
 
 To use node-oracledb, you need:
 
-- Node.js 14.6 or later.
+- Node.js 14.17 or later.
 
 - Access to an Oracle Database either local or remote, on-premises, or in the
   :ref:`Cloud <connectionadb>`. You will need to know the `database

lib/oracledb.js

@@ -34,15 +34,15 @@ const impl = require('./impl');
 const process = require('process');
 const util = require('util');
 
-// This version of node-oracledb works with Node.js 14.6 or later.
+// This version of node-oracledb works with Node.js 14.17 or later.
 // Note: the checked version is the minimum required for Node-API
 // compatibility.  When new Node.js versions are released, older Node.js
 // versions are dropped from the node-oracledb test plan.
 //
 // Keep this code in sync with package/install.js
 const vs = process.version.substring(1).split(".").map(Number);
-errors.assert(vs[0] > 14 || (vs[0] === 14 && vs[1] >= 6),
-  errors.ERR_NODE_TOO_OLD, nodbUtil.PACKAGE_JSON_VERSION, "14.6");
+errors.assert(vs[0] > 14 || (vs[0] === 14 && vs[1] >= 17),
+  errors.ERR_NODE_TOO_OLD, nodbUtil.PACKAGE_JSON_VERSION, "14.17");
 
 const AqDeqOptions = require('./aqDeqOptions.js');
 const AqEnqOptions = require('./aqEnqOptions.js');

package.json

@@ -40,7 +40,7 @@
     "buildpackage": "node package/buildpackage.js"
   },
   "engines": {
-    "node": ">=14.6"
+    "node": ">=14.17"
   },
   "maintainers": [
     {

package/buildpackage.js

@@ -1,4 +1,4 @@
-/* Copyright (c) 2018, 2023, Oracle and/or its affiliates. */
+/* Copyright (c) 2018, 2025, Oracle and/or its affiliates. */
 
 /******************************************************************************
  *
@@ -59,7 +59,7 @@ if (fs.existsSync('.npmignore')) {
 }
 
 // Create the npm package
-async function packageUp() {
+function packageUp() {
   console.log('Creating the npm package for node-oracledb ' + packageJSON.version);
   try {
 
@@ -77,15 +77,9 @@ async function packageUp() {
     packageJSON.scripts.prune = 'node package/prunebinaries.js';
     fs.writeFileSync('package.json', JSON.stringify(packageJSON, null, 2) + '\n');
 
-    // Use 'await fs.promises' to remove the directory & its contents instead
-    // of fs.rmSync() for compatability with Node.js 14.6 - 14.13 versions.
-    // fs.rmSync() was introduced in Node.js 14.14 version.
+    // Remove the directory & its contents
     try {
-      const vs = process.version.substring(1).split(".").map(Number);
-      if (vs[0] > 14 || (vs[0] === 14 && vs[1] >= 14))
-        fs.rmSync(nodbUtil.RELEASE_DIR, { recursive: true, force: true });
-      else
-        await fs.promises.rmdir(nodbUtil.RELEASE_DIR, { recursive: true, force: true });
+      fs.rmSync(nodbUtil.RELEASE_DIR, { recursive: true, force: true });
     } catch (err) {
       if (err && !err.message.match(/ENOENT/))
         console.error(err.message);
@@ -127,10 +121,10 @@ async function packageUp() {
 // Copy a directory
 function copyDir(srcDir, destDir) {
   try {
-    let f = fs.readdirSync(srcDir);
+    const f = fs.readdirSync(srcDir);
     for (let i = 0; i < f.length; i++) {
       fs.copyFileSync(srcDir + '/' + f[i], destDir + '/' + f[i]);
-      let mode = f[i].match(/\.txt$/) ? 0o644 : 0o755;
+      const mode = f[i].match(/\.txt$/) ? 0o644 : 0o755;
       fs.chmodSync(destDir + '/' + f[i], mode);
     }
   } catch (err) {

package/install.js

@@ -68,16 +68,16 @@ function warn(message) { // eslint-disable-line
   console.error.apply(console, args);
 }
 
-// This version of node-oracledb works with Node.js 14.6 or later.
+// This version of node-oracledb works with Node.js 14.17 or later.
 // Note: the checked version is the minimum required for Node-API
 // compatibility.  When new Node.js versions are released, older Node.js
 // versions are dropped from the node-oracledb test plan.
 //
 // Keep this code in sync with lib/oracledb.js
 function checkVersion() {
   const vs = process.version.substring(1).split(".").map(Number);
-  errors.assert(vs[0] > 14 || (vs[0] === 14 && vs[1] >= 6),
-    errors.ERR_NODE_TOO_OLD, nodbUtil.PACKAGE_JSON_VERSION, "14.6");
+  errors.assert(vs[0] > 14 || (vs[0] === 14 && vs[1] >= 17),
+    errors.ERR_NODE_TOO_OLD, nodbUtil.PACKAGE_JSON_VERSION, "14.17");
 }
 
 // Check for the binary node-oracledb module needed for "Thick mode".

package/prunebinaries.js

@@ -1,4 +1,4 @@
-/* Copyright (c) 2019, 2023, Oracle and/or its affiliates. */
+/* Copyright (c) 2019, 2025, Oracle and/or its affiliates. */
 
 /******************************************************************************
  *
@@ -47,11 +47,11 @@ const nodbUtil = require('../lib/util.js');
 
 const dir = nodbUtil.RELEASE_DIR; // contains the binaries
 
-let re = new RegExp(nodbUtil.BINARY_FILE);
+const re = new RegExp(nodbUtil.BINARY_FILE);
 
 try {
-  let f = fs.readdirSync(dir);
-  let opt = process.argv[2];
+  const f = fs.readdirSync(dir);
+  const opt = process.argv[2];
 
   if (opt) {
     // 'npm run prune <option>' is called
@@ -76,18 +76,12 @@ try {
   console.error(err.message);
 }
 
-async function removeFileorDir(fileOrDirPath) {
+function removeFileorDir(fileOrDirPath) {
   try {
     const isDir = fs.statSync(fileOrDirPath).isDirectory();
     if (isDir) {
       // Remove the directory and its files recursively
-      // Use fs.promises for Node.js versions 14.6-14.13,
-      // which do not support fs.rmSync()
-      const vs = process.version.substring(1).split(".").map(Number);
-      if (vs[0] > 14 || (vs[0] === 14 && vs[1] >= 14))
-        fs.rmSync(fileOrDirPath, { recursive: true, force: true });
-      else
-        await fs.promises.rmdir(fileOrDirPath, { recursive: true, force: true });
+      fs.rmSync(fileOrDirPath, { recursive: true, force: true });
     } else {
       // Remove the file or the symlink synchronously
       fs.unlinkSync(fileOrDirPath);