oracledb 6.7.2 → 6.9.0

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,21 @@ 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;
+const ERR_SESSIONLESS_DIFFERING_METHODS = 170;
+const ERR_SESSIONLESS_ALREADY_ACTIVE = 171;
+const ERR_SESSIONLESS_INACTIVE = 172;
 
 // Oracle Net layer errors start from 500
 const ERR_CONNECTION_CLOSED = 500;
@@ -187,15 +201,15 @@ const ERR_INVALID_SERVICE_NAME = 518;
 const ERR_INVALID_SID = 519;
 const ERR_TNS_NAMES_FILE_MISSING = 520;
 const ERR_CONNECTION_EOF = 521;
-const ERR_AZURE_CONFIG_PROVIDER_AUTH_FAILED = 522;
 const ERR_CONFIG_PROVIDER_FAILED_TO_RETRIEVE_CONFIG = 523;
-const ERR_CONFIG_PROVIDER_NOT_SUPPORTED = 524;
-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_REGISTER_HOOKFN_CONFIGPROVIDER = 524;
 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;
+const ERR_CONFIG_PROVIDER_PARAM_TYPE = 535;
 
 // Oracle SUCCESS_WITH_INFO warning start from 700
 const WRN_COMPILATION_CREATE = 700;
@@ -213,11 +227,39 @@ adjustErrorXref.set("DPI-1080", ERR_CONNECTION_CLOSED);
 adjustErrorXref.set("OCI-22303", [ERR_INVALID_OBJECT_TYPE_NAME, 'type "([^"]*"."[^"]*)"']);
 adjustErrorXref.set("OCI-22164", ERR_DELETE_ELEMENTS_OF_VARRAY);
 adjustErrorXref.set("OCI-22165", [ERR_INVALID_COLL_INDEX_SET, /index \[([0-9]+)\] must be in the range of \[([0-9]+)\] to \[([0-9]+)\]/]);
+adjustErrorXref.set("ORA-00022", ERR_CONNECTION_CLOSED);
 adjustErrorXref.set("ORA-00028", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-00031", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-00045", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-00378", ERR_CONNECTION_CLOSED);
 adjustErrorXref.set("ORA-00600", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-00602", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-00603", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-00609", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-01012", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-01041", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-01043", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-01089", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-01092", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-02396", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-03113", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-03114", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-03122", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-03135", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-12153", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-12537", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-12547", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-12570", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-12583", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-27146", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-28511", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-56600", ERR_CONNECTION_CLOSED);
 adjustErrorXref.set("ORA-24338", ERR_INVALID_REF_CURSOR);
 adjustErrorXref.set("ORA-25708", ERR_TOKEN_HAS_EXPIRED);
 adjustErrorXref.set("ORA-24344", WRN_COMPILATION_CREATE);
+adjustErrorXref.set("ORA-26202", ERR_SESSIONLESS_INACTIVE);
+adjustErrorXref.set("ORA-26211", ERR_SESSIONLESS_DIFFERING_METHODS);
+adjustErrorXref.set("ORA-26216", ERR_SESSIONLESS_ALREADY_ACTIVE);
 
 // define mapping for error messages
 const messages = new Map();
@@ -232,7 +274,7 @@ messages.set(ERR_INVALID_PARAMETER_VALUE,               // NJS-005
 messages.set(ERR_INVALID_PROPERTY_VALUE_IN_PARAM,       // NJS-007
   'invalid value for "%s" in parameter %d');
 messages.set(ERR_INVALID_NUMBER_OF_PARAMETERS,          // NJS-009
-  'invalid number of parameters');
+  'invalid number of function parameters: %d provided but expected between %d and %d');
 // used in C -- keep synchronized!
 messages.set(ERR_UNSUPPORTED_DATA_TYPE,                 // NJS-010
   'unsupported data type %d in column %d');
@@ -416,7 +458,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
@@ -458,7 +500,7 @@ messages.set(ERR_INVALID_TPC_END_FLAGS,                 // NJS-151
 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');
+  'size of the transaction ID must be non-zero and must not exceed 64. Its current size is %d.');
 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
@@ -467,11 +509,41 @@ 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.');
+messages.set(ERR_SESSIONLESS_DIFFERING_METHODS,         //NJS-170
+  'Different ways to start or suspend sessionless transactions are being used(server procedures and client APIs)');
+messages.set(ERR_SESSIONLESS_ALREADY_ACTIVE,            //NJS-171
+  'Suspend, commit or rollback the currently active sessionless transaction before beginning or resuming another one.');
+messages.set(ERR_SESSIONLESS_INACTIVE,                  //NJS-172
+  'No sessionless transaction is active');
 
 // Oracle Net layer errors
 
 messages.set(ERR_CONNECTION_CLOSED,                     // NJS-500
-  'connection to the Oracle Database was broken');
+  'connection to Oracle Database was closed or broken');
 messages.set(ERR_CONNECTION_LOSTCONTACT,                // NJS-501
   'connection to host %s port %d terminated unexpectedly. (CONNECTION_ID=%s)\n%s');
 messages.set(ERR_CONNECTION_INCOMPLETE,                 // NJS-503
@@ -512,27 +584,25 @@ 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
-  '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
-  '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
-  '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
-  '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_REGISTER_HOOKFN_CONFIGPROVIDER,         // NJS-524
+  '%s Configuration provider plugin not registered. Please register the hook function for the same');
+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(ERR_CONFIG_PROVIDER_PARAM_TYPE,               // NJS-535
+  'Parameter does not have a valid type: %s\n');
+messages.set(WRN_COMPILATION_CREATE,                    // NJS-700
   'creation succeeded with compilation errors');
 
 //-----------------------------------------------------------------------------
@@ -556,7 +626,7 @@ function assert(condition) {
 //-----------------------------------------------------------------------------
 function assertArgCount(args, minArgCount, maxArgCount) {
   assert(args.length >= minArgCount && args.length <= maxArgCount,
-    ERR_INVALID_NUMBER_OF_PARAMETERS);
+    ERR_INVALID_NUMBER_OF_PARAMETERS, args.length, minArgCount, maxArgCount);
 }
 
 //-----------------------------------------------------------------------------
@@ -683,6 +753,7 @@ function getErr(errorNum) {
   args[0] = `${code}: ${baseText}`;
   const err = new Error(util.format(...args));
   err.code = code;
+  err.isRecoverable = (errorNum === ERR_CONNECTION_CLOSED);
   Error.captureStackTrace(err, getErr);
   return err;
 }
@@ -697,6 +768,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 +785,7 @@ function throwNotImplemented(feature) {
   throwErr(ERR_NOT_IMPLEMENTED, feature);
 }
 
+
 //-----------------------------------------------------------------------------
 // transformErr()
 //
@@ -754,6 +834,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,
@@ -839,15 +930,15 @@ module.exports = {
   ERR_NO_CONFIG_DIR,
   ERR_TNS_ENTRY_NOT_FOUND,
   ERR_CONNECTION_EOF,
-  ERR_AZURE_CONFIG_PROVIDER_AUTH_FAILED,
-  ERR_OCIOBJECT_CONFIG_PROVIDER_AUTH_FAILED,
-  ERR_AZURE_VAULT_AUTH_FAILED,
-  ERR_AZURE_SERVICE_PRINCIPAL_AUTH_FAILED,
   ERR_CONFIG_PROVIDER_FAILED_TO_RETRIEVE_CONFIG,
-  ERR_CONFIG_PROVIDER_NOT_SUPPORTED,
-  ERR_CONFIG_PROVIDER_LOAD_FAILED,
+  ERR_CONFIG_PROVIDER_PARAM_TYPE,
+  ERR_REGISTER_HOOKFN_CONFIGPROVIDER,
+  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,
@@ -905,10 +996,25 @@ module.exports = {
   ERR_UNKNOWN_TRANSACTION_STATE,
   ERR_INVALID_TRANSACTION_SIZE,
   ERR_INVALID_BRANCH_SIZE,
+  ERR_SESSIONLESS_DIFFERING_METHODS,
+  ERR_SESSIONLESS_ALREADY_ACTIVE,
+  ERR_SESSIONLESS_INACTIVE,
   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,
+  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 +1029,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,25 @@ class ConnectionImpl {
     errors.throwNotImplemented("getting the internal name");
   }
 
+  //---------------------------------------------------------------------------
+  // getLTXID()
+  //
+  // Returns the the logical transaction ID for database transactions.
+  //---------------------------------------------------------------------------
+  getLTXID() {
+    errors.throwNotImplemented("getting the logical transaction id");
+  }
+
+  //---------------------------------------------------------------------------
+  // 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 +418,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) {