oracledb 6.3.0 → 6.5.0

package/LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2015, 2023 Oracle and/or its affiliates.
+Copyright (c) 2015, 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

package/NOTICE.txt

@@ -1 +1 @@
-Copyright (c) 2015, 2023, Oracle and/or its affiliates.
+Copyright (c) 2015, 2024, Oracle and/or its affiliates.

package/README.md

@@ -1,10 +1,10 @@
-# node-oracledb version 6.3.0
+# node-oracledb version 6.5.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.3.0 to connect Node.js 14.6, or later, to Oracle
+Use node-oracledb 6.5.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.
 
@@ -48,7 +48,7 @@ vulnerability disclosure process.
 
 ## License
 
-Copyright (c) 2015, 2023, Oracle and/or its affiliates.
+Copyright (c) 2015, 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

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

@@ -0,0 +1 @@
+oracledb-6.5.0-darwin-x64.node v20.11.1 91a7f419eccbfcd18513c19cd25f55f18a4d8ccc 42edf925eedae73b0d5bd7777167a21987bafc89 Tue, 30 Apr 2024 20:12:57 GMT

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

@@ -0,0 +1 @@
+91a7f419eccbfcd18513c19cd25f55f18a4d8ccc

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

@@ -0,0 +1 @@
+oracledb-6.5.0-linux-arm64.node v18.19.1 91a7f419eccbfcd18513c19cd25f55f18a4d8ccc 42edf925eedae73b0d5bd7777167a21987bafc89 Wed, 01 May 2024 04:29:37 GMT

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

@@ -0,0 +1 @@
+oracledb-6.5.0-linux-x64.node v16.20.2 91a7f419eccbfcd18513c19cd25f55f18a4d8ccc 42edf925eedae73b0d5bd7777167a21987bafc89 Wed, 01 May 2024 04:22:59 GMT

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

@@ -0,0 +1 @@
+oracledb-6.5.0-win32-x64.node v18.16.0 91a7f419eccbfcd18513c19cd25f55f18a4d8ccc 42edf925eedae73b0d5bd7777167a21987bafc89 Wed, 01 May 2024 04:34:23 GMT

package/examples/README.md

@@ -63,6 +63,7 @@ File Name                                                 | Description
 [`aqobject.js`](aqobject.js)                              | Oracle Advanced Queuing (AQ) example passing an Oracle Database object
 [`aqoptions.js`](aqoptions.js)                            | Oracle Advanced Queuing (AQ) example setting options and message attributes
 [`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
 [`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
@@ -112,6 +113,8 @@ File Name                                                 | Description
 [`resultset2.js`](resultset2.js)                          | Executes a query and uses a ResultSet to fetch batches of rows with `getRows()`
 [`resultsettoquerystream.js`](resultsettoquerystream.js)  | Converts a ResultSet returned from `execute()` into a Readable Stream.
 [`rowlimit.js`](rowlimit.js)                              | Shows ways to limit the number of records fetched by queries
+[`sampleazuretokenauth.js`](sampleazuretokenauth.js)      | Shows connection pooling with Azure token based authentication.
+[`sampleocitokenauth.js`](sampleocitokenauth.js)          | Shows connection pooling with OCI OAuth 2.0 token based authentication.
 [`select1.js`](select1.js)                                | Executes a basic query without using a connection pool or ResultSet
 [`select2.js`](select2.js)                                | Executes queries to show array and object output formats
 [`selectgeometry.js`](selectgeometry.js)                  | Insert and query Oracle Spatial geometries

package/lib/aqQueue.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2019, 2023, Oracle and/or its affiliates.
+// Copyright (c) 2019, 2024, Oracle and/or its affiliates.
 
 //-----------------------------------------------------------------------------
 //
@@ -169,7 +169,7 @@ class AqQueue {
     errors.assertArgCount(arguments, 1, 1);
     errors.assertParamValue(Number.isInteger(maxMessages) && maxMessages > 0,
       1);
-    const msgImpls = await this._impl.deqMany(maxMessages);
+    const msgImpls = await this._impl.deq(maxMessages);
     return  msgImpls.map(i => this._makeMessage(i));
   }
 
@@ -180,9 +180,9 @@ class AqQueue {
   //---------------------------------------------------------------------------
   async deqOne() {
     errors.assertArgCount(arguments, 0, 0);
-    const msgImpl = await this._impl.deqOne();
-    if (msgImpl)
-      return this._makeMessage(msgImpl);
+    const msgImpls = await this._impl.deq(1);
+    if (msgImpls.length > 0)
+      return this._makeMessage(msgImpls[0]);
   }
 
   //---------------------------------------------------------------------------
@@ -212,7 +212,7 @@ class AqQueue {
     for (let i = 0; i < messages.length; i++) {
       verifiedMessages[i] = this._verifyMessage(messages[i]);
     }
-    const msgImpls = await this._impl.enqMany(verifiedMessages);
+    const msgImpls = await this._impl.enq(verifiedMessages);
     return msgImpls.map(i => this._makeMessage(i));
   }
 
@@ -224,8 +224,8 @@ class AqQueue {
   async enqOne(message) {
     errors.assertArgCount(arguments, 1, 1);
     message = this._verifyMessage(message);
-    const msgImpl = await this._impl.enqOne(message);
-    return this._makeMessage(msgImpl);
+    const msgImpls = await this._impl.enq([message]);
+    return this._makeMessage(msgImpls[0]);
   }
 
   //---------------------------------------------------------------------------

package/lib/connection.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2016, 2023, Oracle and/or its affiliates.
+// Copyright (c) 2016, 2024, Oracle and/or its affiliates.
 
 //-----------------------------------------------------------------------------
 //
@@ -43,6 +43,7 @@ const constants = require('./constants.js');
 const settings = require('./settings.js');
 const transformer = require('./transformer.js');
 const types = require('./types.js');
+const oson = require('./impl/datahandlers/oson.js');
 
 // global mapping of subscriptions; these cannot be tied to a particular
 // connection or pool since subscriptions can be created with one connection
@@ -105,7 +106,10 @@ class Connection extends EventEmitter {
       const cls = this._getDbObjectClass(objType.elementTypeClass);
       objType.elementTypeClass = cls;
     }
-    nodbUtil.addTypeProperties(objType, "elementType");
+    if (objType.isCollection) {
+      nodbUtil.addTypeProperties(objType, "elementType");
+      objType.elementTypeInfo.type = objType.elementType;
+    }
     if (objType.attributes) {
       const props = {};
       for (const attr of objType.attributes) {
@@ -196,9 +200,13 @@ class Connection extends EventEmitter {
       typeof value === 'number' ||
       typeof value === 'string' ||
       typeof value === 'boolean' ||
+      typeof value === 'bigint' ||
       Array.isArray(value) ||
+      value instanceof Float32Array ||
+      value instanceof Float64Array ||
+      value instanceof Int8Array ||
       Buffer.isBuffer(value) ||
-      util.isDate(value) ||
+      util.types.isDate(value) ||
       value instanceof Lob ||
       value instanceof ResultSet ||
       value instanceof BaseDbObject
@@ -563,11 +571,8 @@ class Connection extends EventEmitter {
     } else {
 
       // fetchArraySize must be a positive integer
-      if (options.fetchArraySize !== undefined) {
-        errors.assertParamPropValue(Number.isInteger(options.fetchArraySize) &&
-          options.fetchArraySize > 0, 3, "fetchArraySize");
-        outOptions.fetchArraySize = options.fetchArraySize;
-      }
+      errors.assertParamPropUnsignedIntNonZero(options, 3, "fetchArraySize");
+      outOptions.fetchArraySize = options.fetchArraySize;
 
       // fetchInfo must be an object with keys containing an object with a
       // "type" property; these are converted to an array of objects for ease
@@ -833,6 +838,29 @@ class Connection extends EventEmitter {
     this._impl.setECID(value);
   }
 
+  //---------------------------------------------------------------------------
+  // decode()
+  //
+  // Decodes OSON Buffer to JS data type.
+  //---------------------------------------------------------------------------
+  decodeOSON(buf) {
+    errors.assertArgCount(arguments, 1, 1);
+    errors.assertParamValue(Buffer.isBuffer(buf), 1);
+    const decoder = new oson.OsonDecoder(buf);
+    return decoder.decode();
+  }
+
+
+  //---------------------------------------------------------------------------
+  // encode()
+  //
+  // Encodes the JS value into OSON bytes.
+  //---------------------------------------------------------------------------
+  encodeOSON(value) {
+    const encoder = new oson.OsonEncoder();
+    return encoder.encode(transformer.transformJsonValue(value), this._impl._osonMaxFieldNameSize);
+  }
+
   //---------------------------------------------------------------------------
   // execute()
   //
@@ -844,13 +872,24 @@ class Connection extends EventEmitter {
     let options = {};
 
     // process arguments
-    errors.assertArgCount(arguments, 1, 3);
-    errors.assertParamValue(typeof sql === 'string', 1);
-    if (arguments.length >= 2) {
-      binds = await this._processExecuteBinds(a2);
-    }
-    if (arguments.length == 3) {
-      options = this._verifyExecOpts(a3, false);
+    if (nodbUtil.isObject(sql) && typeof sql.statement === 'string') {
+      errors.assertArgCount(arguments, 1, 2);
+      if (sql.values) {
+        binds = await this._processExecuteBinds(sql.values);
+      }
+      sql = sql.statement;
+      if (arguments.length == 2) {
+        options = this._verifyExecOpts(a2, false);
+      }
+    } else {
+      errors.assertArgCount(arguments, 1, 3);
+      errors.assertParamValue(typeof sql === 'string', 1);
+      if (arguments.length >= 2) {
+        binds = await this._processExecuteBinds(a2);
+      }
+      if (arguments.length == 3) {
+        options = this._verifyExecOpts(a3, false);
+      }
     }
     this._addDefaultsToExecOpts(options);
     errors.assert(this._impl, errors.ERR_INVALID_CONNECTION);
@@ -886,8 +925,8 @@ class Connection extends EventEmitter {
 
     // process output binds
     if (result.outBinds !== undefined) {
-      for (const key in result.outBinds) {
-        const val = this._transformOutBind(result.outBinds[key], options);
+      for (const [key, value] of Object.entries(result.outBinds)) {
+        const val = this._transformOutBind(value, options);
         result.outBinds[key] = val;
       }
     }
@@ -896,10 +935,9 @@ class Connection extends EventEmitter {
     // array size fixed, or, if a result set is not requested, that all rows
     // are fetched
     if (result.implicitResults) {
-      for (const key in result.implicitResults) {
-        const resultSetImpl = result.implicitResults[key];
+      for (const [key, impl] of Object.entries(result.implicitResults)) {
         const resultSet = new ResultSet();
-        resultSet._setup(this, resultSetImpl);
+        resultSet._setup(this, impl);
         if (options.resultSet) {
           result.implicitResults[key] = resultSet;
         } else {
@@ -946,12 +984,17 @@ class Connection extends EventEmitter {
     const result = await this._impl.execute(sql, numIters, binds, options,
       true);
 
+    // convert ORA warnings to NJS
+    if (result.warning) {
+      result.warning = errors.transformErr(result.warning);
+    }
+
     // process output binds
     if (result.outBinds !== undefined) {
       for (let i = 0; i < result.outBinds.length; i++) {
         const outBind = result.outBinds[i];
-        for (const key in outBind) {
-          outBind[key] = this._transformOutBind(outBind[key], options);
+        for (const [key, value] of Object.entries(outBind)) {
+          outBind[key] = this._transformOutBind(value, options);
         }
       }
     }

package/lib/constants.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2022, 2023, Oracle and/or its affiliates.
+// Copyright (c) 2022, 2024, Oracle and/or its affiliates.
 
 //-----------------------------------------------------------------------------
 //
@@ -200,4 +200,10 @@ module.exports = {
   // TPC/XA two-phase commit flags
   TPC_END_NORMAL: 0,
   TPC_END_SUSPEND: 0x00100000,
+
+  // vector types
+  VECTOR_FORMAT_FLOAT32: 2,
+  VECTOR_FORMAT_FLOAT64: 3,
+  VECTOR_FORMAT_INT8: 4,
+
 };

package/lib/dbObject.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2019, 2023, Oracle and/or its affiliates.
+// Copyright (c) 2019, 2024, Oracle and/or its affiliates.
 
 //----------------------------------------------------------------------------
 //
@@ -32,6 +32,48 @@ const errors = require('./errors.js');
 const types = require('./types.js');
 const util = require('util');
 
+//---------------------------------------------------------------------------
+// validatePropertyValue
+//
+// Validate the value based on metadata.
+// For object type, metaData corresponds to the attribute which is set.
+// For collection type, metaData corresponds to element in the collection.
+//---------------------------------------------------------------------------
+function validatePropertyValue(objType, metaData, value, index) {
+  let valueLen, lengthErr = false;
+
+  if (value) {
+    switch (metaData.type) {
+      case types.DB_TYPE_VARCHAR:
+      case types.DB_TYPE_NVARCHAR:
+      case types.DB_TYPE_NCHAR:
+      case types.DB_TYPE_CHAR:
+        valueLen = Buffer.byteLength(value);
+        if (valueLen > metaData.maxSize) {
+          lengthErr = true;
+        }
+        break;
+      case types.DB_TYPE_RAW:
+        valueLen = value.length;
+        if (valueLen > metaData.maxSize) {
+          lengthErr = true;
+        }
+        break;
+      default:
+        break;
+    }
+    if (lengthErr) {
+      if (index !== undefined) {
+        errors.throwErr(errors.ERR_WRONG_LENGTH_FOR_DBOBJECT_ELEM,
+          index, objType.fqn, valueLen, metaData.maxSize);
+      } else {
+        errors.throwErr(errors.ERR_WRONG_LENGTH_FOR_DBOBJECT_ATTR,
+          metaData.name, objType.fqn, valueLen, metaData.maxSize);
+      }
+    }
+  }
+}
+
 // define base database object class; instances of this class are never
 // instantiated; instead, classes subclassed from this one will be
 // instantiated; a cache of these classes are maintained on each connection
@@ -61,6 +103,7 @@ class BaseDbObject {
     };
     const options = {allowArray: false};
     value = transformer.transformValueIn(info, value, options);
+    validatePropertyValue(this._objType, attr, value);
     this._impl.setAttrValue(attr, value);
   }
 
@@ -124,6 +167,13 @@ class BaseDbObject {
     };
     const options = {allowArray: false};
     value = transformer.transformValueIn(info, value, options);
+    let index = this._impl.getLastIndex();
+    if (index) {
+      index = index + 1; // element will be appended at index + 1.
+    } else {
+      index = 0; // undefined for initial append, so set it to 0
+    }
+    validatePropertyValue(this._objType, this._objType.elementTypeInfo, value, index);
     this._impl.append(value);
   }
 
@@ -344,6 +394,7 @@ class BaseDbObject {
     };
     const options = {allowArray: false};
     value = transformer.transformValueIn(info, value, options);
+    validatePropertyValue(this._objType, this._objType.elementTypeInfo, value, index);
     this._impl.setElement(index, value);
   }
 
@@ -388,6 +439,25 @@ class BaseDbObject {
     return (this._toPojo());
   }
 
+  //---------------------------------------------------------------------------
+  // toMap()
+  //
+  // Returns the Map object where the collection’s indexes are the keys and
+  // the elements are its values.
+  //---------------------------------------------------------------------------
+  toMap() {
+    errors.assertArgCount(arguments, 0, 0);
+    if (!this.isCollection) {
+      errors.throwErr(errors.ERR_OBJECT_IS_NOT_A_COLLECTION,
+        this.name);
+    }
+    const result = new Map();
+    this.getKeys().forEach(element => {
+      result.set(element, this.getElement(element));
+    });
+    return result;
+  }
+
 }
 
 // method for transforming the error
@@ -421,6 +491,7 @@ wrapFns(BaseDbObject.prototype,
   "getNextIndex",
   "getPrevIndex",
   "getValues",
+  "toMap",
   "hasElement",
   "setElement",
   "trim"

package/lib/errors.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2022, 2023, Oracle and/or its affiliates.
+// Copyright (c) 2022, 2024, Oracle and/or its affiliates.
 
 //-----------------------------------------------------------------------------
 //
@@ -107,7 +107,6 @@ const ERR_POOL_HAS_BUSY_CONNECTIONS = 104;
 const ERR_NAN_VALUE = 105;
 const ERR_INTERNAL = 106;
 const ERR_INVALID_REF_CURSOR = 107;
-const ERR_LOB_CLOSED = 108;
 const ERR_INVALID_TYPE_NUM = 109;
 const ERR_INVALID_ORACLE_TYPE_NUM = 110;
 const ERR_UNEXPECTED_NEGATIVE_INTEGER = 111;
@@ -138,6 +137,14 @@ const ERR_MISSING_BIND_VALUE = 137;
 const ERR_SERVER_VERSION_NOT_SUPPORTED = 138;
 const ERR_UNEXPECTED_XML_TYPE = 139;
 const ERR_WRONG_USER_FORMAT_EXTAUTH_PROXY = 140;
+const ERR_TOO_MANY_BATCH_ERRORS = 141;
+const ERR_WRONG_LENGTH_FOR_DBOBJECT_ATTR = 142;
+const ERR_WRONG_LENGTH_FOR_DBOBJECT_ELEM = 143;
+const ERR_VECTOR_FORMAT_NOT_SUPPORTED = 144;
+const ERR_VECTOR_VERSION_NOT_SUPPORTED = 145;
+const ERR_OBJECT_IS_NOT_A_COLLECTION = 146;
+const ERR_CURSOR_HAS_BEEN_CLOSED = 147;
+const ERR_DML_RETURNING_DUP_BINDS = 149;
 
 // Oracle Net layer errors start from 500
 const ERR_CONNECTION_CLOSED = 500;
@@ -168,9 +175,8 @@ const WRN_COMPILATION_CREATE = 700;
 // define mapping for ODPI-C, OCI & ORA errors that need to be wrapped
 // with NJS errors
 const adjustErrorXref = new Map();
-adjustErrorXref.set("DPI-1010", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("DPI-1010", ERR_INVALID_CONNECTION);
 adjustErrorXref.set("DPI-1024", [ERR_INVALID_COLL_INDEX_GET, 'at index ([0-9]+) does']);
-adjustErrorXref.set("DPI-1040", ERR_LOB_CLOSED);
 adjustErrorXref.set("DPI-1044", ERR_ORACLE_NUMBER_NO_REPR);
 adjustErrorXref.set("DPI-1055", ERR_NAN_VALUE);
 adjustErrorXref.set("DPI-1063", ERR_EXEC_MODE_ONLY_FOR_DML);
@@ -190,7 +196,7 @@ const messages = new Map();
 messages.set(ERR_INVALID_POOL,                          // NJS-002
   'invalid pool');
 messages.set(ERR_INVALID_CONNECTION,                    // NJS-003
-  'invalid connection');
+  'invalid or closed connection');
 messages.set(ERR_INVALID_PROPERTY_VALUE,                // NJS-004
   'invalid value for property "%s"');
 messages.set(ERR_INVALID_PARAMETER_VALUE,               // NJS-005
@@ -341,8 +347,6 @@ messages.set(ERR_INTERNAL,                              // NJS-106
   'internal error: %s');
 messages.set(ERR_INVALID_REF_CURSOR,                    // NJS-107
   'invalid cursor');
-messages.set(ERR_LOB_CLOSED,                            // NJS-108
-  'LOB was already closed');
 messages.set(ERR_INVALID_TYPE_NUM,                      // NJS-109
   'invalid type number %d');
 messages.set(ERR_INVALID_ORACLE_TYPE_NUM,               // NJS-110
@@ -354,7 +358,7 @@ messages.set(ERR_INTEGER_TOO_LARGE,                     // NJS-112
 messages.set(ERR_UNEXPECTED_DATA,                       // NJS-113
   'unexpected data received: %s');
 messages.set(ERR_OSON_FIELD_NAME_LIMITATION,            // NJS-114
-  'OSON field names may not exceed 255 UTF-8 encoded bytes');
+  'OSON field names may not exceed %d UTF-8 encoded bytes');
 messages.set(ERR_ORACLE_NUMBER_NO_REPR,                 // NJS-115
   'value cannot be represented as an Oracle Database number');
 messages.set(ERR_UNSUPPORTED_VERIFIER_TYPE,             // NJS-116
@@ -403,6 +407,22 @@ messages.set(ERR_UNEXPECTED_XML_TYPE,                   // NJS-139
   'unexpected XML type with flag %d');
 messages.set(ERR_WRONG_USER_FORMAT_EXTAUTH_PROXY,       // NJS-140
   'user name must be enclosed in [] when using external authentication with a proxy user');
+messages.set(ERR_TOO_MANY_BATCH_ERRORS,                 // NJS-141
+  'the number of batch errors from executemany() exceeds 65535');
+messages.set(ERR_WRONG_LENGTH_FOR_DBOBJECT_ATTR,        // NJS-142
+  'value too large for attribute %s of object %s (actual: %d, maximum: %d)');
+messages.set(ERR_WRONG_LENGTH_FOR_DBOBJECT_ELEM,        // NJS-143
+  'value too large for element %d of object %s (actual: %d, maximum: %d)');
+messages.set(ERR_VECTOR_FORMAT_NOT_SUPPORTED,           // NJS-144
+  'VECTOR format %d is not supported');
+messages.set(ERR_VECTOR_VERSION_NOT_SUPPORTED,          // NJS-145
+  'VECTOR version %d is not supported');
+messages.set(ERR_OBJECT_IS_NOT_A_COLLECTION,            // NJS-146
+  'object %s is not a collection');
+messages.set(ERR_CURSOR_HAS_BEEN_CLOSED,                // NJS-147
+  'cursor has been closed by the database');
+messages.set(ERR_DML_RETURNING_DUP_BINDS,               // NJS-149
+  'the bind variable placeholder "%s" cannot be used both before and after the RETURNING clause in a DML RETURNING statement');
 
 // Oracle Net layer errors
 
@@ -529,6 +549,19 @@ function assertParamPropUnsignedInt(obj, parameterNum, propName) {
   }
 }
 
+//-----------------------------------------------------------------------------
+// assertParamPropUnsignedIntNonZero()
+//
+// Asserts that the property value of a parameter is a positive integer value
+// (or undefined).
+//-----------------------------------------------------------------------------
+function assertParamPropUnsignedIntNonZero(obj, parameterNum, propName) {
+  if (obj[propName] !== undefined) {
+    assertParamPropValue(Number.isInteger(obj[propName]) && obj[propName] > 0,
+      parameterNum, propName);
+  }
+}
+
 //-----------------------------------------------------------------------------
 // assertParamPropString()
 //
@@ -625,7 +658,7 @@ function transformErr(err, fnOpt) {
       err.code = err.message.substr(0, pos);
       /* add Oracle Database Error Help Portal URL for database error
          messages, but only in thin mode since this is done
-         automatically in thick mode with Oracle Client 23c and higher
+         automatically in thick mode with Oracle Client 23ai and higher
       */
       const settings = require('./settings.js');
       if (err.errorNum && settings.thin) {
@@ -756,7 +789,6 @@ module.exports = {
   ERR_INVALID_REF_CURSOR,
   ERR_UNSUPPORTED_VERIFIER_TYPE,
   ERR_NAN_VALUE,
-  ERR_LOB_CLOSED,
   ERR_ORACLE_NUMBER_NO_REPR,
   ERR_INVALID_SERVICE_NAME,
   ERR_INVALID_SID,
@@ -789,6 +821,14 @@ module.exports = {
   ERR_SERVER_VERSION_NOT_SUPPORTED,
   ERR_UNEXPECTED_XML_TYPE,
   ERR_WRONG_USER_FORMAT_EXTAUTH_PROXY,
+  ERR_TOO_MANY_BATCH_ERRORS,
+  ERR_WRONG_LENGTH_FOR_DBOBJECT_ATTR,
+  ERR_WRONG_LENGTH_FOR_DBOBJECT_ELEM,
+  ERR_VECTOR_FORMAT_NOT_SUPPORTED,
+  ERR_VECTOR_VERSION_NOT_SUPPORTED,
+  ERR_OBJECT_IS_NOT_A_COLLECTION,
+  ERR_CURSOR_HAS_BEEN_CLOSED,
+  ERR_DML_RETURNING_DUP_BINDS,
   ERR_CONNECTION_CLOSED_CODE: `${ERR_PREFIX}-${ERR_CONNECTION_CLOSED}`,
   WRN_COMPILATION_CREATE,
   assert,
@@ -798,6 +838,7 @@ module.exports = {
   assertParamPropInt,
   assertParamPropString,
   assertParamPropUnsignedInt,
+  assertParamPropUnsignedIntNonZero,
   assertParamPropValue,
   assertParamValue,
   assertPropValue,

package/lib/impl/connection.js

@@ -37,6 +37,7 @@ class ConnectionImpl {
     this._inProgress = false;
     this._dbObjectTypes = new Map();
     this._requestQueue = [];
+    this._osonMaxFieldNameSize = 255;
   }
 
   //---------------------------------------------------------------------------
@@ -110,7 +111,7 @@ class ConnectionImpl {
   // removed once Node-API version 5 is used in the C extension.
   // ---------------------------------------------------------------------------
   _isDate(val) {
-    return (util.isDate(val));
+    return (util.types.isDate(val));
   }
 
   //---------------------------------------------------------------------------