oracledb 6.7.2 → 6.9.0

package/lib/thin/protocol/constants.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2022, 2024, Oracle and/or its affiliates.
+// Copyright (c) 2022, 2025, Oracle and/or its affiliates.
 
 //-----------------------------------------------------------------------------
 //
@@ -405,6 +405,7 @@ module.exports = {
   TNS_DATA_TYPE_UD21: 639,
   TNS_DATA_TYPE_TNP: 640,
   TNS_DATA_TYPE_OAC: 646,
+  TNS_DATA_TYPE_SESSSIGN: 647,
   TNS_DATA_TYPE_OER: 652,
   TNS_DATA_TYPE_UDS: 663,
 
@@ -439,6 +440,7 @@ module.exports = {
   // parameter keyword numbers,
   TNS_KEYWORD_NUM_CURRENT_SCHEMA: 168,
   TNS_KEYWORD_NUM_EDITION: 172,
+  TNS_KEYWORD_NUM_TRANSACTION_ID: 201,
 
   // bind flags
   TNS_BIND_USE_INDICATORS: 0x0001,
@@ -476,6 +478,7 @@ module.exports = {
   TNS_SERVER_PIGGYBACK_LTXID: 7,
   TNS_SERVER_PIGGYBACK_AC_REPLAY_CONTEXT: 8,
   TNS_SERVER_PIGGYBACK_EXT_SYNC: 9,
+  TNS_SERVER_PIGGYBACK_SESS_SIGNATURE: 10,
 
   // session return constants
   TNS_SESSGET_SESSION_CHANGED: 4,
@@ -582,7 +585,9 @@ module.exports = {
   TNS_CCAP_UB2_DTY: 27,
   TNS_CCAP_OCI2: 31,
   TNS_CCAP_CLIENT_FN: 34,
+  TNS_CCAP_OCI3: 35,
   TNS_CCAP_TTC3: 37,
+  TNS_CCAP_SESS_SIGNATURE_VERSION: 39,
   TNS_CCAP_TTC4: 40,
   TNS_CCAP_LOB2: 42,
   TNS_CCAP_TTC5: 44,
@@ -625,6 +630,7 @@ module.exports = {
   TNS_CCAP_RPC_VERSION_MAX: 7,
   TNS_CCAP_RPC_SIG_VALUE: 3,
   TNS_CCAP_DBF_VERSION_MAX: 1,
+  TNS_CCAP_LTXID: 0x08,
   TNS_CCAP_IMPLICIT_RESULTS: 0x10,
   TNS_CCAP_BIG_CHUNK_CLR: 0x20,
   TNS_CCAP_KEEP_OUT_ORDER: 0x80,
@@ -644,6 +650,9 @@ module.exports = {
   TNS_CCAP_CTB_IMPLICIT_POOL: 0x08,
   TNS_CCAP_VECTOR_SUPPORT: 0x08,
   TNS_CCAP_VECTOR_FEATURE_BINARY: 0x01,
+  TNS_CCAP_VECTOR_FEATURE_SPARSE: 0x02,
+  TNS_CCAP_TTC5_SESSIONLESS_TXNS: 0x20,
+  TNS_CCAP_OCI3_OCSSYNC: 0x20,
 
   // runtime capability indices
   TNS_RCAP_COMPAT: 0,
@@ -673,6 +682,7 @@ module.exports = {
   // transaction switching op codes
   TNS_TPC_TXN_START: 0x01,
   TNS_TPC_TXN_DETACH: 0x02,
+  TNS_TPC_TXN_POST_DETACH: 0x04,
 
   // transaction change state op codes
   TNS_TPC_TXN_COMMIT: 0x01,
@@ -688,6 +698,25 @@ module.exports = {
   TNS_TPC_TXN_STATE_READ_ONLY: 4,
   TNS_TPC_TXN_STATE_FORGOTTEN: 5,
 
+  // sessionless transaction flag
+  TNS_TPC_TRANS_SESSIONLESS: 0x00000010,
+
+  // sessionless transaction format
+  TNS_TPC_TRANS_SESSIONLESS_FORMAT: 0x4e5c3e,
+
+  // sessionless sync version
+  TNS_TPC_TRANS_TRANSACTION_ID_SYNC_VERSION_1: 0x01,
+
+  // sessionless server states
+  TNS_TPC_TRANS_TRANSACTION_ID_SYNC_SET: 0x40,
+  TNS_TPC_TRANS_TRANSACTION_ID_SYNC_UNSET: 0x80,
+
+  // sessionless state reason
+  TNS_TPC_TRANS_TRANSACTION_ID_SYNC_SERVER: 0x01,
+  TNS_TPC_TRANS_TRANSACTION_ID_SYNC_CLIENT: 0x02,
+  TNS_TPC_TRANS_TRANSACTION_ID_SYNC_TXEND_XA: 0x03,
+
+
   // other constants
   TNS_ESCAPE_CHAR: 253,
   TNS_LONG_LENGTH_INDICATOR: dataHandlerConstants.TNS_LONG_LENGTH_INDICATOR,
@@ -767,6 +796,7 @@ module.exports = {
   TNS_VECTOR_MAX_LENGTH: 1048576,
   VECTOR_FORMAT_FLEX: 0,
   VECTOR_META_FLAG_FLEXIBLE_DIM: 1,
+  VECTOR_META_FLAG_SPARSE: 2,
 
   // other constants
   PACKET_HEADER_SIZE: 8,

package/lib/thin/protocol/messages/auth.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2022, 2023, Oracle and/or its affiliates.
+// Copyright (c) 2022, 2025, Oracle and/or its affiliates.
 
 //-----------------------------------------------------------------------------
 //
@@ -94,8 +94,10 @@ class AuthMessage extends Message {
       this.userByteLen = 0;
     }
     this.token = config.token;
-    if (this.token)
+    if (config.externalAuth) {
       this.functionCode = constants.TNS_FUNC_AUTH_PHASE_TWO;
+      this.externalAuth = true;
+    }
     this.privateKey = config.privateKey;
     if (this.privateKey) {
       this.privateKey = util.normalizePrivateKey(this.privateKey);
@@ -107,6 +109,12 @@ class AuthMessage extends Message {
     this.osUser = config.osUser;
     this.program = config.program;
     this.terminal = config.terminal;
+    if (config.edition) {
+      this.edition = config.edition;
+    } else if (process.env.ORA_EDITION) {
+      this.edition = process.env.ORA_EDITION;
+    }
+    this.appContext = config.appContext;
     this.setAuthMode(config);
   }
 
@@ -141,7 +149,7 @@ class AuthMessage extends Message {
     if (this.newPassword) {
       this.authMode |= constants.TNS_AUTH_MODE_CHANGE_PASSWORD;
     }
-    if (!this.token) {
+    if (!config.externalAuth) {
       this.authMode |= constants.TNS_AUTH_MODE_WITH_PASSWORD;
     }
   }
@@ -199,8 +207,10 @@ class AuthMessage extends Message {
         numPairs = 2;
       } else {
         numPairs = 4;
-        if (this.token) {
-          numPairs += 1;
+        if (this.externalAuth) {
+          numPairs += 5;
+          if (this.token)
+            numPairs += 1;
         } else {
           numPairs += 2;
           if (this.verifierType === constants.TNS_VERIFIER_TYPE_11G_1 ||
@@ -235,6 +245,12 @@ class AuthMessage extends Message {
           this.encryptedJDWPData = ED.getEncryptedJSWPData(this.sessionKey, this.conn.jdwpData);
           numPairs += 1;
         }
+        if (this.edition) {
+          numPairs += 1;
+        }
+        if (this.appContext) {
+          numPairs += this.appContext.length * 3;
+        }
         if (this.schemaUser.length !== 0) {
           numPairs += 1;
         }
@@ -246,10 +262,17 @@ class AuthMessage extends Message {
       buf.writeUInt8(1);
       if (this.userByteLen > 0)
         buf.writeBytesWithLength(Buffer.from(this.username));
+      if (this.externalAuth) {
+        buf.writeKeyValue("AUTH_TERMINAL", this.terminal ?? cInfo.terminal);
+        buf.writeKeyValue("AUTH_PROGRAM_NM", this.program ?? cInfo.program);
+        buf.writeKeyValue("AUTH_MACHINE", this.machine ?? cInfo.hostName);
+        buf.writeKeyValue("AUTH_PID", cInfo.pid);
+        buf.writeKeyValue("AUTH_SID", this.osUser ?? cInfo.userName);
+      }
       if (this.token) {
         buf.writeKeyValue("AUTH_TOKEN", this.token);
       } else {
-        if (!this.changePassword) {
+        if (!this.changePassword && !this.externalAuth) {
           buf.writeKeyValue("AUTH_SESSKEY", this.sessionKey, 1);
           if (!verifier11G) {
             buf.writeKeyValue("AUTH_PBKDF2_SPEEDY_KEY", this.speedyKey);
@@ -297,6 +320,18 @@ class AuthMessage extends Message {
       if (this.conn.jdwpData) {
         buf.writeKeyValue("AUTH_ORA_DEBUG_JDWP", this.encryptedJDWPData);
       }
+      if (this.edition) {
+        buf.writeKeyValue("AUTH_ORA_EDITION", this.edition);
+      }
+      if (this.appContext) {
+        // NOTE: these keys require a trailing null character as the server
+        // expects it!
+        for (const entry of this.appContext) {
+          buf.writeKeyValue("AUTH_APPCTX_NSPACE\0", entry[0]);
+          buf.writeKeyValue("AUTH_APPCTX_ATTR\0", entry[1]);
+          buf.writeKeyValue("AUTH_APPCTX_VALUE\0", entry[2]);
+        }
+      }
 
     }
   }
@@ -331,6 +366,7 @@ class AuthMessage extends Message {
       this.conn.maxOpenCursors = Number(this.sessionData['AUTH_MAX_OPEN_CURSORS'] || 0);
       this.conn.serviceName = this.sessionData['AUTH_SC_SERVICE_NAME'];
       this.conn.instanceName = this.sessionData['AUTH_INSTANCENAME'];
+      this.conn.maxIdentifierLength = Number(this.sessionData['AUTH_MAX_IDEN_LENGTH'] || 30);
       const fullVersionNum = Number(this.sessionData['AUTH_VERSION_NO']);
       const versionNum = (fullVersionNum >> 24) & 0xFF;
       this.conn.warning = this.warning;

package/lib/thin/protocol/messages/base.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2022, 2024, Oracle and/or its affiliates.
+// Copyright (c) 2022, 2025, Oracle and/or its affiliates.
 
 //-----------------------------------------------------------------------------
 //
@@ -30,6 +30,34 @@ const { Buffer } = require('buffer');
 const constants = require("../constants.js");
 const errors = require("../../../errors.js");
 
+// List of recoverable errors
+const RECOVERABLE_ERRORS = new Set([
+  28,     // session has been terminated
+  31,     // session marked for kill
+  376,    // file %s cannot be read at this time
+  603,    // ORACLE server session terminated
+  1012,   // not logged on
+  1033,   // ORACLE initialization or shutdown in progress
+  1034,   // the Oracle instance is not available for use
+  1089,   // immediate shutdown or close in progress
+  1090,   // shutdown in progress
+  1092,   // ORACLE instance terminated
+  1115,   // IO error reading block from file %s (block # %s)
+  2396,   // exceeded maximum idle time
+  3113,   // end-of-file on communication channel
+  3114,   // not connected to ORACLE
+  3135,   // connection lost contact
+  12153,  // TNS:not connected
+  12514,  // Service %s is not registered with the listener
+  12537,  // TNS:connection closed
+  12547,  // TNS:lost contact
+  12570,  // TNS:packet reader failure
+  12571,  // TNS:packet writer failure
+  12583,  // TNS:no reader
+  12757,  // instance does not currently know of requested service
+  16456   // missing or invalid value
+]);
+
 /**
  *
  * Base class for all the RPC messages to support encode/decode functions
@@ -52,6 +80,7 @@ class Message {
   async postProcess() { }
 
   writeFunctionHeader(buf) {
+    this.writePiggybacks(buf);
     buf.writeUInt8(this.messageType);
     buf.writeUInt8(this.functionCode);
     buf.writeSeqNum();
@@ -160,6 +189,8 @@ class Message {
        */
       this.errorInfo.message = this.errorInfo.message.trim();
     }
+    this.errorInfo.isRecoverable = RECOVERABLE_ERRORS.has(this.errorInfo.num);
+
     this.endOfResponse = !this.connection.nscon.endOfRequestSupport;
   }
 
@@ -220,7 +251,7 @@ class Message {
     if (opcode === constants.TNS_SERVER_PIGGYBACK_LTXID) {
       const num_bytes = buf.readUB4();
       if (num_bytes > 0) {
-        buf.skipBytesChunked();
+        this.connection._ltxid = Buffer.from(buf.readBytesWithLength());
       }
     } else if ((opcode === constants.TNS_SERVER_PIGGYBACK_QUERY_CACHE_INVALIDATION)
      || (opcode === constants.TNS_SERVER_PIGGYBACK_TRACE_EVENT)) {
@@ -235,15 +266,22 @@ class Message {
       const num_elements = buf.readUB4();
       buf.skipBytes(1);                         // skip length
       for (let i = 0; i < num_elements; i++) {
-        let temp16 = buf.readUB2();
-        if (temp16 > 0) {                       // skip key
-          buf.skipBytesChunked();
+        let numBytes = buf.readUB2();
+        let keyTextValue, value;
+        if (numBytes > 0) {                       // read key
+          keyTextValue = buf.readStr(constants.CSFRM_IMPLICIT);
         }
-        temp16 = buf.readUB2();
-        if (temp16 > 0) {                       // skip value
-          buf.skipBytesChunked();
+        numBytes = buf.readUB2();
+        if (numBytes > 0)                         // read value
+          value = buf.readBytesWithLength();
+        const keywordNum = buf.readUB2();         // read keyword number
+        if (keywordNum == constants.TNS_KEYWORD_NUM_TRANSACTION_ID) {
+          this._updateSessionlessTxnState(value);
+        } else if (keywordNum === constants.TNS_KEYWORD_NUM_CURRENT_SCHEMA) {
+          this.connection.currentSchema = keyTextValue;
+        } else if (keywordNum === constants.TNS_KEYWORD_NUM_EDITION) {
+          this.connection._edition = keyTextValue;
         }
-        buf.skipUB2();                          // skip flags
       }
       buf.skipUB4();                            // skip overall flags
     } else if (opcode === constants.TNS_SERVER_PIGGYBACK_EXT_SYNC) {
@@ -286,12 +324,22 @@ class Message {
       this.connection._drcpEstablishSession = false;
       buf.skipUB4();                            // session id
       buf.skipUB2();                            // serial number
+    } else if (opcode === constants.TNS_SERVER_PIGGYBACK_SESS_SIGNATURE) {
+      buf.skipUB2();                              // number of dtys
+      buf.skipUB1();                              // length of dty
+      buf.skipUB8();                              // signature flags
+      buf.skipUB8();                              // client signature
+      buf.skipUB8();                              // server signature
     } else {
       errors.throwErr(errors.ERR_UNKOWN_SERVER_SIDE_PIGGYBACK, opcode);
     }
   }
 
   writePiggybacks(buf) {
+    // Don't write piggybacks if not authenticated yet
+    if (this.connection._protocol.connInProgress)
+      return;
+
     if (this.connection._currentSchemaModified) {
       this._writeCurrentSchemaPiggyback(buf);
     }
@@ -313,6 +361,11 @@ class Message {
     if (this.connection._tempLobsTotalSize > 0) {
       this.writeCloseTempLobsPiggyback(buf);
     }
+    if (this.connection._sessionlessData?.pending) {
+      this.connection._sessionlessData.pending = false;
+      this.connection._sessionlessData.piggyback.encode(buf);
+      this.connection._sessionlessData.piggyback = null;
+    }
   }
 
   writePiggybackHeader(buf, functionCode) {
@@ -474,6 +527,42 @@ class Message {
       this.deferredErr = errors.getErr(...arguments);
     }
   }
+
+  _updateSessionlessTxnState(buf) {
+    const length = buf.length;
+    const sessionlessState = buf.readUInt8(length - 2);
+    const syncVersion = buf.readUInt8(length - 1);
+    let startedOnServer;
+
+    if (syncVersion == constants.TNS_TPC_TRANS_TRANSACTION_ID_SYNC_VERSION_1) {
+      // transactionId got unset for this session (txn ended or suspended)
+      if (sessionlessState &
+        constants.TNS_TPC_TRANS_TRANSACTION_ID_SYNC_UNSET) {
+        this.connection._sessionlessData = null;
+        this.connection._protocol.txnInProgress = false;
+      // transactionId got set for this session
+      } else if (sessionlessState &
+        constants.TNS_TPC_TRANS_TRANSACTION_ID_SYNC_SET) {
+
+        // transaction initialized by PL/SQL procedure
+        if (sessionlessState &
+            constants.TNS_TPC_TRANS_TRANSACTION_ID_SYNC_SERVER)
+          startedOnServer = true;
+        // transaction initialized by calling client API(RPC call)
+        else if (sessionlessState &
+          constants.TNS_TPC_TRANS_TRANSACTION_ID_SYNC_CLIENT)
+          startedOnServer = false;
+
+        this.connection._sessionlessData = {
+          startedOnServer: startedOnServer,
+        };
+        this.connection._protocol.txnInProgress = true;
+      }
+    } else
+      errors.throwErr(errors.ERR_INTERNAL, 'Unexpected TransactionId sync ' +
+        'version in session sync piggyback.');
+  }
+
 }
 
 module.exports = Message;

package/lib/thin/protocol/messages/dataType.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2022, 2024, Oracle and/or its affiliates.
+// Copyright (c) 2022, 2025, Oracle and/or its affiliates.
 
 //-----------------------------------------------------------------------------
 //
@@ -394,6 +394,7 @@ const dataTypes = [
   [constants.TNS_DATA_TYPE_TNP, constants.TNS_DATA_TYPE_TNP, constants.TNS_TYPE_REP_UNIVERSAL],
   [constants.TNS_DATA_TYPE_OER, constants.TNS_DATA_TYPE_OER, constants.TNS_TYPE_REP_UNIVERSAL],
   [constants.TNS_DATA_TYPE_OAC, constants.TNS_DATA_TYPE_OAC, constants.TNS_TYPE_REP_UNIVERSAL],
+  [constants.TNS_DATA_TYPE_SESSSIGN, constants.TNS_DATA_TYPE_SESSSIGN, constants.TNS_TYPE_REP_UNIVERSAL],
   [constants.TNS_DATA_TYPE_VECTOR, constants.TNS_DATA_TYPE_VECTOR, constants.TNS_TYPE_REP_UNIVERSAL]
 ];
 

package/lib/thin/protocol/messages/execute.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2022, 2023, Oracle and/or its affiliates.
+// Copyright (c) 2022, 2025, Oracle and/or its affiliates.
 
 //-----------------------------------------------------------------------------
 //
@@ -29,6 +29,7 @@
 const MessageWithData = require("./withData.js");
 const constants = require("../constants.js");
 const errors = require("../../../errors.js");
+const TransactionSwitchMessage = require("./transactionSwitch.js");
 
 /**
  *
@@ -110,12 +111,18 @@ class ExecuteMessage extends MessageWithData {
       options |= constants.TNS_EXEC_OPTION_BATCH_ERRORS;
     }
     if (this.arrayDmlRowCounts) {
-      dmlOptions = constants.TNS_EXEC_OPTION_DML_ROWCOUNTS;
+      dmlOptions |= constants.TNS_EXEC_OPTION_DML_ROWCOUNTS;
     }
     if (this.options.autoCommit) {
       options |= constants.TNS_EXEC_OPTION_COMMIT;
     }
-    this.writePiggybacks(buf);
+
+    // In case SuspendOnSuccess is set for execute and a sessionless transaction
+    // is active we add a piggyback for post-call suspend
+    if (this.options.suspendOnSuccess) {
+      this._handleSuspendSessionless();
+    }
+
     this.writeFunctionHeader(buf);
     buf.writeUB4(options);                           // execute options
     buf.writeUB4(stmt.cursorId);                     // cursor id
@@ -258,7 +265,13 @@ class ExecuteMessage extends MessageWithData {
       }
       numIters = this.numExecs;
     }
-    this.writePiggybacks(buf);
+
+    // In case SuspendOnSuccess is set for execute and a sessionless transaction
+    // is active we add a piggyback for post-call suspend
+    if (this.options.suspendOnSuccess) {
+      this._handleSuspendSessionless();
+    }
+
     this.writeFunctionHeader(buf);
     buf.writeUB4(stmt.cursorId);
     buf.writeUB4(numIters);
@@ -267,6 +280,35 @@ class ExecuteMessage extends MessageWithData {
     return params;
   }
 
+  //-------------------------------------------------------------------------
+  // _handleSuspendSessionless()
+  //
+  // Suspend the active sessionless transaction after DML execution if
+  // suspendOnSuccess option was given to execute()
+  //-------------------------------------------------------------------------
+  _handleSuspendSessionless() {
+    const sessionlessData = this.connection._sessionlessData;
+    // If sessionless transaction was started by server-call we cannot suspend
+    // using client API(RPC) calls
+    this.connection._validateSessionlessState();
+
+    if (!sessionlessData)
+      errors.throwErr(errors.ERR_SESSIONLESS_INACTIVE);
+    // If a piggybacks already exists it is most likely a start/resume for a
+    // sessionless transaction, add a post-call detach opcode to it
+    if (sessionlessData.piggyback) {
+      sessionlessData.piggyback.operation |=
+        constants.TNS_TPC_TXN_POST_DETACH;
+    } else {
+      const message = new TransactionSwitchMessage(this.connection);
+      message.operation = constants.TNS_TPC_TXN_POST_DETACH;
+      message.flags = constants.TNS_TPC_TRANS_SESSIONLESS;
+      message.messageType = constants.TNS_MSG_TYPE_PIGGYBACK;
+      sessionlessData.piggyback = message;
+      sessionlessData.pending = true;
+    }
+  }
+
   //-------------------------------------------------------------------------
   // encode()
   //

package/lib/thin/protocol/messages/fastAuth.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2023, 2024, Oracle and/or its affiliates.
+// Copyright (c) 2023, 2025, Oracle and/or its affiliates.
 
 //-----------------------------------------------------------------------------
 //
@@ -70,6 +70,11 @@ class FastAuthMessage extends Message {
     } else {
       this.authMessage.processMessage(buf, messageType);
       this.endOfResponse = this.authMessage.endOfResponse;
+      if (this.authMessage.errorOccurred) {
+        // Capture the Error returned in TNS_MSG_TYPE_ERROR processing.
+        this.errorOccurred = this.authMessage.errorOccurred;
+        this.errorInfo = this.authMessage.errorInfo;
+      }
     }
   }
 

package/lib/thin/protocol/messages/lobOp.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2022, 2023, Oracle and/or its affiliates.
+// Copyright (c) 2022, 2025, Oracle and/or its affiliates.
 
 //-----------------------------------------------------------------------------
 //
@@ -45,10 +45,6 @@ class LobOpMessage extends Message {
      */
     this.sourceLobImpl = options.sourceLobImpl || null;
     this.operation = options.operation;
-    /*
-     * Destination LOB locator. For copy, append operations,...
-     */
-    this.destLobImpl = options.destLobImpl || null;
     /*
      * Offset from where sourceLob operation to start
      */
@@ -64,6 +60,7 @@ class LobOpMessage extends Message {
     this.functionCode = constants.TNS_FUNC_LOB_OP;
     this.sendAmount = options.sendAmount;
     this.amount = options.amount || 0; // LOB length
+    this.destLength = options.destLength || 0;
   }
 
   encode(buf) {
@@ -75,13 +72,8 @@ class LobOpMessage extends Message {
       buf.writeUInt8(1);
       buf.writeUB4(this.sourceLobImpl._locator.length);
     }
-    if (this.destLobImpl === null) {
-      buf.writeUInt8(0);
-      buf.writeUB4(0);
-    } else {
-      buf.writeUInt8(1);
-      buf.writeUB4(this.destLobImpl._locator.length);
-    }
+    buf.writeUInt8(0);
+    buf.writeUB4(this.destLength);
     buf.writeUB4(0);
     buf.writeUB4(0);
     if (this.operation === constants.TNS_LOB_OP_CREATE_TEMP) {
@@ -117,9 +109,6 @@ class LobOpMessage extends Message {
     if (this.sourceLobImpl) {
       buf.writeBytes(this.sourceLobImpl._locator);
     }
-    if (this.destLobImpl) {
-      buf.writeBytes(this.destLobImpl._locator);
-    }
     if (this.operation === constants.TNS_LOB_OP_CREATE_TEMP) {
       if (this.sourceLobImpl.dbType._csfrm === constants.CSFRM_NCHAR) {
         buf.caps.checkNCharsetId();
@@ -185,15 +174,9 @@ class LobOpMessage extends Message {
       locator = lobArray.slice(0, numBytes);
       locator.copy(this.sourceLobImpl._locator);
     }
-    if (this.destLobImpl !== null) {
-      numBytes = this.destLobImpl._locator.length;
-      lobArray = buf.readBytes(numBytes);
-      locator = lobArray.slice(0, numBytes);
-      locator.copy(this.destLobImpl._locator);
-    }
     if (this.operation === constants.TNS_LOB_OP_CREATE_TEMP) {
       buf.skipUB2();        // skip character set
-      buf.skipBytes(3);     // skip trailing flags, amount
+      buf.skipUB1();        // skip trailing flags
     } else if (this.sendAmount) {
       this.amount = buf.readSB8();
     }

package/lib/thin/protocol/messages/logOff.js

@@ -44,7 +44,6 @@ class LogOffMessage extends Message {
   }
 
   encode(buf) {
-    this.writePiggybacks(buf);
     this.writeFunctionHeader(buf);
   }
 

package/lib/thin/protocol/messages/sessionRelease.js

@@ -45,7 +45,6 @@ class SessionReleaseMessage extends Message {
   }
 
   encode(buf) {
-    this.writePiggybacks(buf);
     this.writeFunctionHeader(buf);
     buf.writeUInt8(0); // pointer (tag name)
     buf.writeUInt8(0); // tag name length

package/lib/thin/protocol/messages/transactionSwitch.js

@@ -28,6 +28,7 @@
 
 const Message = require("./base.js");
 const constants = require("../constants.js");
+const errors = require("../../../errors.js");
 
 /**
  * Used for two-phase commit (TPC) transaction start, attach and detach.
@@ -61,18 +62,25 @@ class TransactionSwitchMessage extends Message {
   }
 
   encode(buf) {
+    // We unset the pending flag in writePiggybacks just before encode is
+    // called to ensure message is written
+    if (this.connection._sessionlessData?.pending)
+      errors.throwErr(errors.ERR_SESSIONLESS_ALREADY_ACTIVE);
+
     // writes the message to the database
     // acquire data to send to the server
     let xidBytes;
     if (this.xid) {
       xidBytes = Buffer.alloc(128);
       this.xid.globalTransactionId.copy(xidBytes);
-      this.xid.branchQualifier.copy(xidBytes,
-        this.xid.globalTransactionId.length);
+      if (this.xid.branchQualifier)
+        this.xid.branchQualifier.copy(xidBytes,
+          this.xid.globalTransactionId.length);
     }
 
-    // write message
     this.writeFunctionHeader(buf);
+
+
     buf.writeUB4(this.operation);
     if (this.context) {
       buf.writeUInt8(1);  // pointer (transaction context)
@@ -97,7 +105,7 @@ class TransactionSwitchMessage extends Message {
     }
 
     buf.writeUB4(this.flags);
-    buf.writeUB4(this.timeout);
+    buf.writeUB4(this.timeout ? this.timeout : 0);
     buf.writeUInt8(1);   // pointer (application value)
     buf.writeUInt8(1);   // pointer (return context)
     buf.writeUInt8(1);   // pointer (return context length)

package/lib/thin/protocol/messages/withData.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2022, 2024, Oracle and/or its affiliates.
+// Copyright (c) 2022, 2025, Oracle and/or its affiliates.
 
 //-----------------------------------------------------------------------------
 //
@@ -280,6 +280,7 @@ class MessageWithData extends Message {
         if (!(vectorFlags & constants.VECTOR_META_FLAG_FLEXIBLE_DIM)) {
           fetchInfo.vectorDimensions = dimensions;
         }
+        fetchInfo.isSparseVector = Boolean(vectorFlags & constants.VECTOR_META_FLAG_SPARSE);
         if (vectorFormat !== constants.VECTOR_FORMAT_FLEX) {
           fetchInfo.vectorFormat = vectorFormat;
         }
@@ -501,6 +502,10 @@ class MessageWithData extends Message {
       }
     } else if (oraTypeNum === constants.TNS_DATA_TYPE_BOOLEAN) {
       colValue = buf.readBool();
+    } else if (oraTypeNum === constants.TNS_DATA_TYPE_INTERVAL_YM) {
+      colValue = buf.readOracleIntervalYM();
+    } else if (oraTypeNum === constants.TNS_DATA_TYPE_INTERVAL_DS) {
+      colValue = buf.readOracleIntervalDS();
     } else if (
       oraTypeNum === constants.TNS_DATA_TYPE_CLOB ||
       oraTypeNum === constants.TNS_DATA_TYPE_BLOB ||
@@ -861,6 +866,10 @@ class MessageWithData extends Message {
       } else {
         buf.writeUInt16BE(0x0100);
       }
+    } else if (oraTypeNum === constants.TNS_DATA_TYPE_INTERVAL_YM) {
+      buf.writeOracleIntervalYM(value);
+    } else if (oraTypeNum === constants.TNS_DATA_TYPE_INTERVAL_DS) {
+      buf.writeOracleIntervalDS(value);
     } else if (
       oraTypeNum === constants.TNS_DATA_TYPE_CLOB ||
       oraTypeNum === constants.TNS_DATA_TYPE_BLOB ||

package/lib/thin/protocol/packet.js

@@ -530,7 +530,7 @@ class WritePacket extends BaseBuffer {
     if (!this.nsi.ntAdapter) {
       errors.throwErr(errors.ERR_INVALID_CONNECTION);
     }
-    this.nsi.ntAdapter.send(buf);
+    this.nsi.sendPacket(buf);
   }
 
   /**