oracledb 6.7.2 → 6.8.0

package/LICENSE.txt

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

package/README.md

@@ -1,10 +1,10 @@
-# node-oracledb version 6.7.2
+# node-oracledb version 6.8.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.7.2 to connect Node.js 14.6, or later, to Oracle
+Use node-oracledb 6.8.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.8.0-darwin-arm64.node-buildinfo.txt

@@ -0,0 +1 @@
+oracledb-6.8.0-darwin-arm64.node v22.2.0 1e47f3ef9289df6513744f8cff1ad648f989c8af 6fa744509b8144c7bd2a25a1cb1e7dd8f746d31f Wed, 12 Feb 2025 09:02:05 GMT

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

@@ -0,0 +1 @@
+oracledb-6.8.0-darwin-x64.node v20.11.1 1e47f3ef9289df6513744f8cff1ad648f989c8af 6fa744509b8144c7bd2a25a1cb1e7dd8f746d31f Wed, 12 Feb 2025 08:49:37 GMT

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

@@ -0,0 +1 @@
+1e47f3ef9289df6513744f8cff1ad648f989c8af

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

@@ -0,0 +1 @@
+oracledb-6.8.0-linux-arm64.node v20.16.0 1e47f3ef9289df6513744f8cff1ad648f989c8af 6fa744509b8144c7bd2a25a1cb1e7dd8f746d31f Wed, 12 Feb 2025 09:53:19 GMT

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

@@ -0,0 +1 @@
+oracledb-6.8.0-linux-x64.node v20.16.0 1e47f3ef9289df6513744f8cff1ad648f989c8af 6fa744509b8144c7bd2a25a1cb1e7dd8f746d31f Wed, 12 Feb 2025 09:52:45 GMT

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

@@ -0,0 +1 @@
+oracledb-6.8.0-win32-x64.node v20.0.0 1e47f3ef9289df6513744f8cff1ad648f989c8af 6fa744509b8144c7bd2a25a1cb1e7dd8f746d31f Wed, 12 Feb 2025 09:31:59 GMT

package/lib/connection.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2016, 2024, Oracle and/or its affiliates.
+// Copyright (c) 2016, 2025, Oracle and/or its affiliates.
 
 //-----------------------------------------------------------------------------
 //
@@ -50,6 +50,48 @@ const oson = require('./impl/datahandlers/oson.js');
 // and destroyed with another!
 const _subscriptions = new Map();
 
+// default closure for NUMBER type.
+const defaultNumberConverter = (v) => (v === null) ? null : parseFloat(v);
+
+//---------------------------------------------------------------------------
+// _determineDbObjTypeConverter()
+//
+// Determines the converter associated with each DB type and its metadata.
+// This function is called once during metadata construction and the
+// converters are invoked when retriving DBObject values.
+//---------------------------------------------------------------------------
+function _determineDbObjTypeConverter(metadata, options) {
+  // clear any previous converter functions that may have been
+  // retained
+  delete metadata.converter;
+
+  // If a DBfetch type handler is specified, update converter,
+  // if available.
+  if (options.dbObjectTypeHandler) {
+    const result = options.dbObjectTypeHandler(metadata);
+    if (result !== undefined) {
+      errors.assert(typeof result === 'object',
+        errors.ERR_DB_FETCH_TYPE_HANDLER_RETURN_VALUE);
+      if (result.converter !== undefined) {
+        errors.assert(typeof result.converter === 'function',
+          errors.ERR_DB_FETCH_TYPE_HANDLER_CONVERTER);
+      }
+      if ([types.DB_TYPE_CLOB, types.DB_TYPE_NCLOB, types.DB_TYPE_BLOB,
+        types.DB_TYPE_BFILE].includes(metadata.type)) {
+        // converters for LOB's are not supported.
+        return errors.throwErr(errors.ERR_NOT_IMPLEMENTED,
+          'DbObjConverter for LOBs');
+      }
+      metadata.converter = result.converter;
+    }
+  }
+  if (metadata.type === types.DB_TYPE_NUMBER && !metadata.converter) {
+    // set default converter for NUMBER type as they are returned as strings
+    // from DB.
+    metadata.converter = defaultNumberConverter;
+  }
+}
+
 // define class
 class Connection extends EventEmitter {
 
@@ -106,9 +148,11 @@ class Connection extends EventEmitter {
       const cls = this._getDbObjectClass(objType.elementTypeClass);
       objType.elementTypeClass = cls;
     }
+    const options = {dbObjectTypeHandler: settings.dbObjectTypeHandler};
     if (objType.isCollection) {
       nodbUtil.addTypeProperties(objType, "elementType");
       objType.elementTypeInfo.type = objType.elementType;
+      _determineDbObjTypeConverter(objType.elementTypeInfo, options);
     }
     if (objType.attributes) {
       const props = {};
@@ -126,6 +170,10 @@ class Connection extends EventEmitter {
           }
         };
         props[attr.name] = prop;
+
+        // calculate for each attribute metadata as converters might change
+        // based on precision, scale, maxSize,..
+        _determineDbObjTypeConverter(attr, options);
       }
       Object.defineProperties(DbObject.prototype, props);
     }
@@ -368,7 +416,9 @@ class Connection extends EventEmitter {
         bindInfo.type !== types.DB_TYPE_TIMESTAMP &&
         bindInfo.type !== types.DB_TYPE_TIMESTAMP_LTZ &&
         bindInfo.type !== types.DB_TYPE_TIMESTAMP_TZ &&
-        bindInfo.type !== types.DB_TYPE_RAW) {
+        bindInfo.type !== types.DB_TYPE_RAW &&
+        bindInfo.type !== types.DB_TYPE_INTERVAL_YM &&
+        bindInfo.type !== types.DB_TYPE_INTERVAL_DS) {
       errors.throwErr(errors.ERR_INVALID_TYPE_FOR_ARRAY_BIND);
     }
 
@@ -1216,6 +1266,20 @@ class Connection extends EventEmitter {
       this._impl.isHealthy());
   }
 
+  isCompressionEnabled() {
+    return (this._impl && this._impl.isCompressionEnabled());
+  }
+
+  //---------------------------------------------------------------------------
+  // maxIdentifierLength
+  //
+  // Returns the maximum length of identifiers supported by the database to
+  // which this connection has been established.
+  //---------------------------------------------------------------------------
+  get maxIdentifierLength() {
+    return this._impl && this._impl.getMaxIdentifierLength();
+  }
+
   //---------------------------------------------------------------------------
   // maxOpenCursors
   //

package/lib/dbObject.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2019, 2024, Oracle and/or its affiliates.
+// Copyright (c) 2019, 2025, Oracle and/or its affiliates.
 
 //----------------------------------------------------------------------------
 //
@@ -86,7 +86,7 @@ class BaseDbObject {
   //---------------------------------------------------------------------------
   _getAttrValue(attr) {
     const value = this._impl.getAttrValue(attr);
-    return this._transformValueOut(value, attr.typeClass);
+    return this._transformValueOut(value, attr.typeClass, attr);
   }
 
   //---------------------------------------------------------------------------
@@ -138,16 +138,21 @@ class BaseDbObject {
   //
   // Transforms a value going out to the caller from the implementation.
   //---------------------------------------------------------------------------
-  _transformValueOut(value, cls) {
+  _transformValueOut(value, cls, metaData) {
     let outValue = value;
     if (value instanceof impl.LobImpl) {
       outValue = new Lob();
       outValue._setup(value, true);
-    } else if (value instanceof impl.DbObjectImpl) {
-      outValue = Object.create(cls.prototype);
-      outValue._impl = value;
-      if (outValue.isCollection) {
-        outValue = new Proxy(outValue, BaseDbObject._collectionProxyHandler);
+    } else {
+      if (value instanceof impl.DbObjectImpl) {
+        outValue = Object.create(cls.prototype);
+        outValue._impl = value;
+        if (outValue.isCollection) {
+          outValue = new Proxy(outValue, BaseDbObject._collectionProxyHandler);
+        }
+      }
+      if (metaData.converter) {
+        outValue = metaData.converter(outValue);
       }
     }
     return outValue;
@@ -202,6 +207,21 @@ class BaseDbObject {
     return this._attributes;
   }
 
+  //---------------------------------------------------------------------------
+  // copy
+  //
+  // Creates and returns a copy of the object. The copy is independent of
+  // the original object that was copied.
+  //---------------------------------------------------------------------------
+  copy() {
+    errors.assertArgCount(arguments, 0, 0);
+    const newObj = Object.create(this);
+    newObj._impl = this._impl.copy();
+    if (this.isCollection)
+      return new Proxy(newObj, BaseDbObject._collectionProxyHandler);
+    return newObj;
+  }
+
   //---------------------------------------------------------------------------
   // deleteElement()
   //
@@ -253,6 +273,17 @@ class BaseDbObject {
     return this._objType.fqn;
   }
 
+  //---------------------------------------------------------------------------
+  // length
+  //
+  // Length of the database object type, if it is a collection. Else it
+  // returns undefined.
+  //---------------------------------------------------------------------------
+  get length() {
+    if (this.isCollection)
+      return this._impl.getLength();
+    return undefined;
+  }
   //---------------------------------------------------------------------------
   // getElement()
   //
@@ -262,7 +293,7 @@ class BaseDbObject {
     errors.assertArgCount(arguments, 1, 1);
     errors.assertParamValue(Number.isInteger(index), 1);
     const value = this._impl.getElement(index);
-    return this._transformValueOut(value, this.elementTypeClass);
+    return this._transformValueOut(value, this.elementTypeClass, this._objType.elementTypeInfo);
   }
 
   //---------------------------------------------------------------------------
@@ -326,7 +357,7 @@ class BaseDbObject {
     errors.assertArgCount(arguments, 0, 0);
     const values = this._impl.getValues();
     for (let i = 0; i < values.length; i++) {
-      values[i] = this._transformValueOut(values[i], this.elementTypeClass);
+      values[i] = this._transformValueOut(values[i], this.elementTypeClass, this._objType.elementTypeInfo);
     }
     return values;
   }
@@ -483,6 +514,7 @@ wrapFns(BaseDbObject.prototype,
   "_getAttrValue",
   "_setAttrValue",
   "append",
+  "copy",
   "deleteElement",
   "getElement",
   "getKeys",

package/lib/errors.js

@@ -1,5 +1,4 @@
-// Copyright (c) 2022, 2024, Oracle and/or its affiliates.
-
+// Copyright (c) 2022, 2025, Oracle and/or its affiliates.
 //-----------------------------------------------------------------------------
 //
 // This software is dual-licensed to you under the Universal Permissive License
@@ -164,6 +163,18 @@ 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;
+const ERR_VECTOR_SPARSE_INDICES_IS_NOT_ARRAY = 158;
+const ERR_VECTOR_SPARSE_VALUES_IS_NOT_ARRAY = 159;
+const ERR_VECTOR_SPARSE_DIMS_IS_NOT_INTEGER = 160;
+const ERR_VECTOR_SPARSE_INDICES_VALUES_NOT_EQUAL = 161;
+const ERR_VECTOR_SPARSE_INVALID_JSON = 162;
+const ERR_VECTOR_SPARSE_INVALID_STRING = 163;
+const ERR_VECTOR_SPARSE_INVALID_INPUT = 164;
+const ERR_VECTOR_SPARSE_INDICES_ELEM_IS_NOT_VALID = 165;
+const ERR_DB_FETCH_TYPE_HANDLER_CONVERTER = 166;
+const ERR_DB_FETCH_TYPE_HANDLER_RETURN_VALUE = 167;
+const ERR_ACCESS_TOKEN = 168;
+const ERR_CALLOUT_FN = 169;
 
 // Oracle Net layer errors start from 500
 const ERR_CONNECTION_CLOSED = 500;
@@ -196,6 +207,10 @@ 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;
+const ERR_ANO_PACKET = 531;
+const ERR_ANO_STATUS = 532;
+const ERR_ANO_NEGOTIATION = 533;
+const ERR_DATA_COMPRESSION = 534;
 
 // Oracle SUCCESS_WITH_INFO warning start from 700
 const WRN_COMPILATION_CREATE = 700;
@@ -416,7 +431,7 @@ messages.set(ERR_INVALID_OBJECT_TYPE_NAME,              // NJS-129
 messages.set(ERR_TDS_TYPE_NOT_SUPPORTED,                // NJS-130
   'Oracle TDS data type %d is not supported');
 messages.set(ERR_INVALID_COLL_INDEX_SET,                // NJS-131
-  'given index %d must be in the range of %d to %d');
+  'given index [%d] must be in the range of [%d] to [%d]');
 messages.set(ERR_INVALID_COLL_INDEX_GET,                // NJS-132
   'element at index %d does not exist');
 messages.set(ERR_DELETE_ELEMENTS_OF_VARRAY,             // NJS-133
@@ -467,6 +482,30 @@ 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');
+messages.set(ERR_VECTOR_SPARSE_INDICES_IS_NOT_ARRAY,    // NJS-158
+  'SPARSE VECTOR indices is not Uint32Array or an Array');
+messages.set(ERR_VECTOR_SPARSE_VALUES_IS_NOT_ARRAY,     // NJS-159
+  'SPARSE VECTOR values is not an Array');
+messages.set(ERR_VECTOR_SPARSE_DIMS_IS_NOT_INTEGER,     // NJS-160
+  'SPARSE VECTOR dimensions is not an Positive Integer');
+messages.set(ERR_VECTOR_SPARSE_INDICES_VALUES_NOT_EQUAL, // NJS-161
+  'SPARSE VECTOR indices and values must be of same length');
+messages.set(ERR_VECTOR_SPARSE_INVALID_JSON,           // NJS-162
+  'SPARSE VECTOR string data is not valid JSON');
+messages.set(ERR_VECTOR_SPARSE_INVALID_STRING,         // NJS-163
+  'SPARSE VECTOR string data Array should have exactly 3 elements');
+messages.set(ERR_VECTOR_SPARSE_INVALID_INPUT,           // NJS-164
+  'SPARSE VECTOR Invalid Input Data');
+messages.set(ERR_VECTOR_SPARSE_INDICES_ELEM_IS_NOT_VALID,    // NJS-165
+  'SPARSE VECTOR indices element at index %d is not valid');
+messages.set(ERR_DB_FETCH_TYPE_HANDLER_CONVERTER,          // NJS-166
+  'DBFetchTypeHandler return value attribute "converter" must be a function');
+messages.set(ERR_DB_FETCH_TYPE_HANDLER_RETURN_VALUE,       // NJS-167
+  'DBFetchTypeHandler return value must be an object');
+messages.set(ERR_ACCESS_TOKEN,                          // NJS-168
+  'access token function failed.');
+messages.set(ERR_CALLOUT_FN,                         // NJS-169
+  'External function call failed.');
 
 // Oracle Net layer errors
 
@@ -516,23 +555,29 @@ 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
   'Failed to retrieve configuration from Centralized Configuration Provider:\n %s');
-messages.set(ERR_CONFIG_PROVIDER_NOT_SUPPORTED,               // NJS-524
+messages.set(ERR_CONFIG_PROVIDER_NOT_SUPPORTED,         // NJS-524
   'Configuration Provider not supported: %s');
-messages.set(ERR_CONFIG_PROVIDER_LOAD_FAILED,                 // NJS-525
+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
+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_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,                   // NJS-529
+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
+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(ERR_ANO_PACKET,                            // NJS-531
+  'Error in Advanced Networking Option packet received from the server');
+messages.set(ERR_ANO_STATUS,                            // NJS-532
+  '%s service recieved status failure');
+messages.set(ERR_ANO_NEGOTIATION,                       // NJS-533
+  'Advanced Networking Option service negotiation failed. Native Network Encryption and DataIntegrity only supported in node-oracledb thick mode.\nCause: ORA-%s');
+messages.set(ERR_DATA_COMPRESSION, 'Error during data compression/decompression: %s\n'); //NJS-534
 // Oracle SUCCESS_WITH_INFO warning
-messages.set(WRN_COMPILATION_CREATE,                          // NJS-700
+messages.set(WRN_COMPILATION_CREATE,                    // NJS-700
   'creation succeeded with compilation errors');
 
 //-----------------------------------------------------------------------------
@@ -697,6 +742,14 @@ function throwErr() {
   throw (getErr(...arguments));
 }
 
+function throwErrWithORAError() {
+  const err =  (getErr(...arguments));
+  const pos = err.message.indexOf("ORA-");
+  const oraError = err.message.substring(pos + 4, pos + 9);
+  err.message = err.message + '\nHelp: https://docs.oracle.com/error-help/db/ora-' + oraError;
+  throw err;
+}
+
 //-----------------------------------------------------------------------------
 // throwNotImplemented()
 //
@@ -706,6 +759,7 @@ function throwNotImplemented(feature) {
   throwErr(ERR_NOT_IMPLEMENTED, feature);
 }
 
+
 //-----------------------------------------------------------------------------
 // transformErr()
 //
@@ -754,6 +808,17 @@ function transformErr(err, fnOpt) {
   return err;
 }
 
+//-----------------------------------------------------------------------------
+// throwWrapErr()
+//
+// Throws error by wrapping exceptions with a specific error.
+//-----------------------------------------------------------------------------
+function throwWrapErr(err, fnOpt) {
+  const newErr = getErr(fnOpt);
+  newErr.stack = err.stack;
+  throw newErr;
+}
+
 // define exports
 module.exports = {
   ERR_INTEGRITY_ERROR_CODES,
@@ -846,8 +911,12 @@ module.exports = {
   ERR_CONFIG_PROVIDER_FAILED_TO_RETRIEVE_CONFIG,
   ERR_CONFIG_PROVIDER_NOT_SUPPORTED,
   ERR_CONFIG_PROVIDER_LOAD_FAILED,
+  ERR_DATA_COMPRESSION,
   ERR_WALLET_TYPE_NOT_SUPPORTED,
   ERR_HOST_NOT_FOUND,
+  ERR_ANO_PACKET,
+  ERR_ANO_STATUS,
+  ERR_ANO_NEGOTIATION,
   ERR_INVALID_BIND_NAME,
   ERR_WRONG_NUMBER_OF_BINDS,
   ERR_BUFFER_LENGTH_INSUFFICIENT,
@@ -909,6 +978,18 @@ module.exports = {
   ERR_OPERATION_NOT_SUPPORTED_ON_BFILE,
   ERR_OPERATION_ONLY_SUPPORTED_ON_BFILE,
   ERR_EXECMANY_NOT_ALLOWED_ON_QUERIES,
+  ERR_VECTOR_SPARSE_INDICES_IS_NOT_ARRAY,
+  ERR_VECTOR_SPARSE_VALUES_IS_NOT_ARRAY,
+  ERR_VECTOR_SPARSE_DIMS_IS_NOT_INTEGER,
+  ERR_VECTOR_SPARSE_INDICES_VALUES_NOT_EQUAL,
+  ERR_VECTOR_SPARSE_INVALID_JSON,
+  ERR_VECTOR_SPARSE_INVALID_STRING,
+  ERR_VECTOR_SPARSE_INVALID_INPUT,
+  ERR_VECTOR_SPARSE_INDICES_ELEM_IS_NOT_VALID,
+  ERR_DB_FETCH_TYPE_HANDLER_CONVERTER,
+  ERR_DB_FETCH_TYPE_HANDLER_RETURN_VALUE,
+  ERR_ACCESS_TOKEN,
+  ERR_CALLOUT_FN,
   WRN_COMPILATION_CREATE,
   assert,
   assertArgCount,
@@ -923,6 +1004,8 @@ module.exports = {
   assertPropValue,
   getErr,
   throwErr,
+  throwErrWithORAError,
   throwNotImplemented,
-  transformErr
+  transformErr,
+  throwWrapErr
 };

package/lib/impl/connection.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2022, 2023, Oracle and/or its affiliates.
+// Copyright (c) 2022, 2025, Oracle and/or its affiliates.
 
 //-----------------------------------------------------------------------------
 //
@@ -289,6 +289,16 @@ class ConnectionImpl {
     errors.throwNotImplemented("getting the internal name");
   }
 
+  //---------------------------------------------------------------------------
+  // getMaxIdentifierLength()
+  //
+  // Returns the maximum length of identifiers supported by the database to
+  // which this connection has been established.
+  //---------------------------------------------------------------------------
+  getMaxIdentifierLength() {
+    errors.throwNotImplemented("getting the maximum identifier length");
+  }
+
   //---------------------------------------------------------------------------
   // getMaxOpenCursors()
   //
@@ -399,6 +409,10 @@ class ConnectionImpl {
     errors.throwNotImplemented("getting the health of the connection");
   }
 
+  isCompressionEnabled() {
+    errors.throwNotImplemented("getting the data compression status on the connection");
+  }
+
   //---------------------------------------------------------------------------
   // ping()
   //

package/lib/impl/datahandlers/buffer.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2022, 2024, Oracle and/or its affiliates.
+// Copyright (c) 2022, 2025, Oracle and/or its affiliates.
 
 //-----------------------------------------------------------------------------
 //
@@ -188,6 +188,36 @@ class BaseBuffer {
       buf[5] - 1, buf[6] - 1, fseconds, 0);
   }
 
+  //---------------------------------------------------------------------------
+  // parseOracleIntervalYM()
+  //
+  // Parses an Oracle interval year-to-month (YM) from the supplied buffer
+  // and returns a corresponding IntervalYM object representing that value.
+  // This object contains attributes for years and months.
+  //---------------------------------------------------------------------------
+  parseOracleIntervalYM(buf) {
+    const years = buf.readUInt32BE() - constants.TNS_DURATION_MID;
+    const months = buf[4] - constants.TNS_DURATION_OFFSET;
+    return new types.IntervalYM({ years: years, months: months });
+  }
+
+  //---------------------------------------------------------------------------
+  // parseOracleIntervalDS()
+  //
+  // Parses an Oracle interval day-to-second (DS) from the supplied buffer
+  // and returns a corresponding IntervalDS object representing that value.
+  // This object contains attributes for day and time units.
+  //---------------------------------------------------------------------------
+  parseOracleIntervalDS(buf) {
+    const days = buf.readUInt32BE() - constants.TNS_DURATION_MID;
+    const fseconds = buf.readUInt32BE(7) - constants.TNS_DURATION_MID;
+    const hours = buf[4] - constants.TNS_DURATION_OFFSET;
+    const minutes = buf[5] - constants.TNS_DURATION_OFFSET;
+    const seconds = buf[6] - constants.TNS_DURATION_OFFSET;
+    return new types.IntervalDS({ days: days, hours: hours, minutes: minutes,
+      seconds: seconds, fseconds: fseconds });
+  }
+
   //---------------------------------------------------------------------------
   // parseOracleNumber()
   //
@@ -430,6 +460,34 @@ class BaseBuffer {
     return this.parseOracleDate(buf, useLocalTime);
   }
 
+  //---------------------------------------------------------------------------
+  // readOracleIntervalYM()
+  //
+  // Reads interval year to month value from the buffer and returns a
+  // JavaScript object representing that value.
+  //---------------------------------------------------------------------------
+  readOracleIntervalYM() {
+    const buf = this.readBytesWithLength();
+    if (!buf) {
+      return null;
+    }
+    return this.parseOracleIntervalYM(buf);
+  }
+
+  //---------------------------------------------------------------------------
+  // readOracleIntervalDS()
+  //
+  // Reads interval day to second value from the buffer and returns a
+  // JavaScript object representing that value.
+  //---------------------------------------------------------------------------
+  readOracleIntervalDS() {
+    const buf = this.readBytesWithLength();
+    if (!buf) {
+      return null;
+    }
+    return this.parseOracleIntervalDS(buf);
+  }
+
   //---------------------------------------------------------------------------
   // readOracleNumber()
   //
@@ -801,6 +859,39 @@ class BaseBuffer {
     }
   }
 
+  //---------------------------------------------------------------------------
+  // writeOracleIntervalYM()
+  //
+  // Writes a time interval to the buffer in Oracle Interval Year To Month
+  // format. It is assumed that the 'value' parameter is a valid IntervalYM
+  // object at this stage.
+  //---------------------------------------------------------------------------
+  writeOracleIntervalYM(value, writeLength = true) {
+    if (writeLength) {
+      this.writeUInt8(5);
+    }
+    this.writeUInt32BE(value.years + constants.TNS_DURATION_MID);
+    this.writeUInt8(value.months + constants.TNS_DURATION_OFFSET);
+  }
+
+  //---------------------------------------------------------------------------
+  // writeOracleIntervalDS()
+  //
+  // Writes a time interval to the buffer in Oracle Interval Day To Second
+  // format. It is assumed that the 'value' parameter is a valid IntervalDS
+  // object at this stage.
+  //---------------------------------------------------------------------------
+  writeOracleIntervalDS(value, writeLength = true) {
+    if (writeLength) {
+      this.writeUInt8(11);
+    }
+    this.writeUInt32BE(value.days + constants.TNS_DURATION_MID);
+    this.writeUInt8(value.hours + constants.TNS_DURATION_OFFSET);
+    this.writeUInt8(value.minutes + constants.TNS_DURATION_OFFSET);
+    this.writeUInt8(value.seconds + constants.TNS_DURATION_OFFSET);
+    this.writeUInt32BE(value.fseconds + constants.TNS_DURATION_MID);
+  }
+
   //---------------------------------------------------------------------------
   // writeOracleNumber()
   //

package/lib/impl/datahandlers/constants.js

@@ -34,10 +34,12 @@ module.exports = {
   TNS_VECTOR_MAGIC_BYTE: 0xDB,
   TNS_VECTOR_VERSION_BASE: 0,
   TNS_VECTOR_VERSION_WITH_BINARY: 1,
+  TNS_VECTOR_VERSION_WITH_SPARSE: 2,
 
   // vector flags
   TNS_VECTOR_FLAG_NORMSRC: 0x0010,
   TNS_VECTOR_FLAG_NORM: 0x0002,
+  TNS_VECTOR_FLAG_SPARSE: 0x0020,
 
   // base JSON constants
   TNS_JSON_MAGIC_BYTE_1: 0xff,

package/lib/impl/datahandlers/oson.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2023, 2024, Oracle and/or its affiliates.
+// Copyright (c) 2023, 2025, Oracle and/or its affiliates.
 
 //-----------------------------------------------------------------------------
 //
@@ -138,6 +138,12 @@ class OsonDecoder extends BaseBuffer {
     } else if (nodeType === constants.TNS_JSON_TYPE_BINARY_DOUBLE) {
       return this.parseBinaryDouble(this.readBytes(8));
 
+    // handle interval datatypes
+    } else if (nodeType === constants.TNS_JSON_TYPE_INTERVAL_YM) {
+      return this.parseOracleIntervalYM(this.readBytes(5));
+    } else if (nodeType === constants.TNS_JSON_TYPE_INTERVAL_DS) {
+      return this.parseOracleIntervalDS(this.readBytes(11));
+
     // handle scalars with lengths stored outside the node itself
     } else if (nodeType === constants.TNS_JSON_TYPE_STRING_LENGTH_UINT8) {
       return this.readBytes(this.readUInt8()).toString();
@@ -573,6 +579,14 @@ class OsonTreeSegment extends GrowableBuffer {
         this.writeOracleDate(value, types.DB_TYPE_TIMESTAMP, false);
       }
 
+    // handle interval data types
+    } else if (value instanceof types.IntervalYM) {
+      this.writeUInt8(constants.TNS_JSON_TYPE_INTERVAL_YM);
+      this.writeOracleIntervalYM(value, false);
+    } else if (value instanceof types.IntervalDS) {
+      this.writeUInt8(constants.TNS_JSON_TYPE_INTERVAL_DS);
+      this.writeOracleIntervalDS(value, false);
+
     // handle buffers
     } else if (Buffer.isBuffer(value)) {
       if (value.length < 65536) {