oracledb 6.8.0 → 6.10.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,
@@ -556,6 +559,9 @@ module.exports = {
   TNS_FUNC_CANCEL_ALL: 120, // piggyback fn
   TNS_FUNC_TPC_TXN_SWITCH: 103,
   TNS_FUNC_TPC_TXN_CHANGE_STATE: 104,
+  TNS_FUNC_AQ_ENQ: 121,
+  TNS_FUNC_AQ_DEQ: 122,
+  TNS_FUNC_ARRAY_AQ: 145,
 
   // character sets and encodings
   TNS_CHARSET_UTF8: 873,
@@ -571,6 +577,7 @@ module.exports = {
   TNS_CCAP_CTB_FEATURE_BACKPORT: 5,
   TNS_CCAP_FIELD_VERSION: 7,
   TNS_CCAP_SERVER_DEFINE_CONV: 8,
+  TNS_CCAP_DEQUEUE_WITH_SELECTOR: 9,
   TNS_CCAP_TTC1: 15,
   TNS_CCAP_OCI1: 16,
   TNS_CCAP_TDS_VERSION: 17,
@@ -582,7 +589,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 +634,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,
@@ -642,9 +652,12 @@ module.exports = {
   TNS_CCAP_LOB2_QUASI: 0x01,
   TNS_CCAP_LOB2_2GB_PREFETCH: 0x04,
   TNS_CCAP_CTB_IMPLICIT_POOL: 0x08,
+  TNS_CCAP_CTB_OAUTH_MSG_ON_ERR: 0x10,
   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,
@@ -674,6 +687,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,
@@ -689,6 +703,80 @@ 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,
+
+  // AQ Delivery modes
+  TNS_AQ_MSG_PERSISTENT: constants.AQ_MSG_DELIV_MODE_PERSISTENT,
+  TNS_AQ_MSG_BUFFERED: constants.AQ_MSG_DELIV_MODE_BUFFERED,
+  TNS_AQ_MSG_PERSISTENT_OR_BUFFERED: constants.AQ_MSG_DELIV_MODE_PERSISTENT_OR_BUFFERED,
+
+  // AQ dequeue modes
+  TNS_AQ_DEQ_BROWSE: 1,
+  TNS_AQ_DEQ_LOCKED: 2,
+  TNS_AQ_DEQ_REMOVE: 3,
+  TNS_AQ_DEQ_REMOVE_NODATA: 4,
+
+  // AQ dequeue navigation modes
+  TNS_AQ_DEQ_FIRST_MSG: 1,
+  TNS_AQ_DEQ_NEXT_MSG: 3,
+  TNS_AQ_DEQ_NEXT_TRANSACTION: 2,
+
+  // AQ dequeue visibility modes
+  TNS_AQ_DEQ_IMMEDIATE: 1,
+  TNS_AQ_DEQ_ON_COMMIT: 2,
+
+  // AQ dequeue wait modes
+  TNS_AQ_DEQ_NO_WAIT: 0,
+  TNS_AQ_DEQ_WAIT_FOREVER: 0xFFFFFFFF,
+
+  // AQ enqueue visibility modes
+  TNS_AQ_ENQ_IMMEDIATE: 1,
+  TNS_AQ_ENQ_ON_COMMIT: 2,
+
+  // AQ message states
+  TNS_AQ_MSG_EXPIRED: 3,
+  TNS_AQ_MSG_PROCESSED: 2,
+  TNS_AQ_MSG_READY: 0,
+  TNS_AQ_MSG_WAITING: 1,
+
+  // AQ other constants
+  TNS_AQ_MSG_NO_DELAY: 0,
+  TNS_AQ_MSG_NO_EXPIRATION: -1,
+  TNS_AQ_ARRAY_ENQ: 0x01,
+  TNS_AQ_ARRAY_DEQ: 0x02,
+  TNS_AQ_ARRAY_FLAGS_RETURN_MESSAGE_ID: 0x01,
+  TNS_TTC_ENQ_STREAMING_ENABLED: 0x00000001,
+  TNS_TTC_ENQ_STREAMING_DISABLED: 0x00000000,
+
+  // AQ flags
+  TNS_KPD_AQ_BUFMSG: 0x02,
+  TNS_KPD_AQ_EITHER: 0x10,
+
+  TNS_AQ_MESSAGE_ID_LENGTH: 16,
+  TNS_AQ_MESSAGE_VERSION: 1,
+
+  TNS_AQ_EXT_KEYWORD_AGENT_NAME: 64,
+  TNS_AQ_EXT_KEYWORD_AGENT_ADDRESS: 65,
+  TNS_AQ_EXT_KEYWORD_AGENT_PROTOCOL: 66,
+  TNS_AQ_EXT_KEYWORD_ORIGINAL_MSGID: 69,
+
+
   // other constants
   TNS_ESCAPE_CHAR: 253,
   TNS_LONG_LENGTH_INDICATOR: dataHandlerConstants.TNS_LONG_LENGTH_INDICATOR,
@@ -760,6 +848,7 @@ module.exports = {
   TNS_ERR_INVALID_SID: 12505,
   TNS_ERR_NO_DATA_FOUND: 1403,
   TNS_ERR_SESSION_SHUTDOWN: 12572,
+  TNS_ERR_NO_MESSAGES_FOUND: 25228,
 
   // warnings
   TNS_WARN_COMPILATION_CREATE: 0x20,

package/lib/thin/protocol/encryptDecrypt.js

@@ -40,7 +40,7 @@ class EncryptDecrypt {
 
   // Key length is dependent on the algorithm. In this case for aes192, it is
   // 24 bytes (192 bits).
-  _decrypt(key, val) {
+  decrypt(key, val) {
     const iv = Buffer.alloc(16, 0); // Initialization vector, same is used in server
     const decipher = crypto.createDecipheriv(algorithm, key, iv);
     decipher.setAutoPadding(false);
@@ -138,7 +138,7 @@ class EncryptDecrypt {
     if (newPassword) {
       newPasswordBytes = Buffer.from(newPassword, 'utf8');
     }
-    const sessionKeyParta = this._decrypt(passwordHash, encodedServerKey);
+    const sessionKeyParta = this.decrypt(passwordHash, encodedServerKey);
     const sessionKeyPartb = Buffer.alloc(sessionKeyParta.length);
     crypto.randomFillSync(sessionKeyPartb);
     const encodedClientKey = this._encrypt(passwordHash, sessionKeyPartb);

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

@@ -0,0 +1,238 @@
+// Copyright (c) 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
+// 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose
+// either license.
+//
+// If you elect to accept the software under the Apache License, Version 2.0,
+// the following applies:
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//    https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+//-----------------------------------------------------------------------------
+
+//-----------------------------------------------------------------------------
+// aqArray.js
+//
+// This file defines the messages that are sent to the database and the
+// responses that are received by the client for enqueuing and dequeuing
+// an array of AQ messages.
+//-----------------------------------------------------------------------------
+
+'use strict';
+
+const AqBaseMessage = require("./aqBase.js");
+const constants = require("../constants.js");
+const errors = require("../../../errors.js");
+
+class AqArrayMessage extends AqBaseMessage {
+
+  constructor(connImpl) {
+    super(connImpl);
+    this.functionCode = constants.TNS_FUNC_ARRAY_AQ;
+    this.numIters = 0;
+    this.propsImpls = [];
+    this.noMsgFound = false;
+  }
+
+  //--------------------------------------------------------------------------
+  // processReturnParameter()
+  //
+  // Process the return parameters of the AQ array enqueue/dequeue request.
+  // We recieve all the msg details in deq and in case of enq the msgIds.
+  //--------------------------------------------------------------------------
+  processReturnParameter(buf) {
+    const numIters = buf.readUB4();
+    for (let i = 0; i < numIters; i++) {
+      const propsImpl = this.propsImpls[i];
+      let temp16 = buf.readUB2();
+      if (temp16 > 0) {
+        buf.skipUB1();
+        this._processMsgProps(buf, propsImpl);
+      }
+      propsImpl.recipients = this._processRecipients(buf);
+      temp16 = buf.readUB2();
+      if (temp16 > 0) {
+        propsImpl.payload = this._processPayload(buf);
+      }
+      const msgId = buf.readBytesAndLength();// msgIds array
+      if (this.operation === constants.TNS_AQ_ARRAY_ENQ) {
+        for (let j = 0; j < this.propsImpls.length; j++) {
+          this.propsImpls[j].msgId = Buffer.from(msgId.slice(j * 16, (j + 1) * 16));
+        }
+      } else {
+        propsImpl.msgId = Buffer.from(msgId);
+      }
+      temp16 = buf.readUB2();               // extensions len
+      if (temp16 > 0) {
+        errors.throwErr(errors.ERR_NOT_IMPLEMENTED);
+      }
+      buf.skipUB2();                        // output ack
+    }
+    if (this.operation === constants.TNS_AQ_ARRAY_ENQ) {
+      this.numIters = buf.readUB4();
+    } else {
+      this.numIters = numIters;
+    }
+  }
+
+  //--------------------------------------------------------------------------
+  // _writeArrayDeq()
+  //
+  // Writes to the buffer the fields specific to the array dequeue of AQ
+  // messages.
+  //--------------------------------------------------------------------------
+  _writeArrayDeq(buf) {
+    let consumerNameBytes = null;
+    let correlationBytes = null;
+    let conditionBytes = null;
+    const queueNameBytes = Buffer.from(this.queueImpl.name);
+    const deliveryMode = this.deqOptionsImpl.deliveryMode;
+    let flags = 0;
+
+    if (deliveryMode === constants.TNS_AQ_MSG_BUFFERED) {
+      flags |= constants.TNS_KPD_AQ_BUFMSG;
+    } else if (deliveryMode === constants.TNS_AQ_MSG_PERSISTENT_OR_BUFFERED) {
+      flags |= constants.TNS_KPD_AQ_EITHER;
+    }
+
+    if (this.deqOptionsImpl.consumerName) {
+      consumerNameBytes = Buffer.from(this.deqOptionsImpl.consumerName, 'utf-8');
+    }
+    if (this.deqOptionsImpl.condition) {
+      conditionBytes = Buffer.from(this.deqOptionsImpl.condition, 'utf-8');
+    }
+    if (this.deqOptionsImpl.correlation) {
+      correlationBytes = Buffer.from(this.deqOptionsImpl.correlation, 'utf-8');
+    }
+
+    for (const propsImpl of this.propsImpls) {
+      buf.writeUB4(queueNameBytes.length);
+      buf.writeBytesWithLength(queueNameBytes);
+      this._writeMsgProps(buf, propsImpl);
+      buf.writeUB4(0);                      // num recipients
+      this._writeValueWithLength(buf, consumerNameBytes);
+      buf.writeSB4(this.deqOptionsImpl.mode);
+      buf.writeSB4(this.deqOptionsImpl.navigation);
+      buf.writeSB4(this.deqOptionsImpl.visibility);
+      buf.writeSB4(this.deqOptionsImpl.wait);
+      this._writeValueWithLength(buf, this.deqOptionsImpl.msgid);
+      this._writeValueWithLength(buf, correlationBytes);
+      this._writeValueWithLength(buf, conditionBytes);
+      buf.writeUB4(0);                      // extensions
+      buf.writeUB4(0);                      // rel msg id
+      buf.writeSB4(0);                      // seq deviation
+      buf.writeUB4(16);                     // toid length
+      buf.writeBytesWithLength(this.queueImpl.payloadToid);
+      buf.writeUB2(constants.TNS_AQ_MESSAGE_VERSION);
+      buf.writeUB4(0);                      // payload length
+      buf.writeUB4(0);                      // raw pay length
+      buf.writeUB4(0);
+      buf.writeUB4(flags);                  // deliveryMode flag
+      buf.writeUB4(0);                      // extensions len
+      buf.writeUB4(0);                      // source seq len
+    }
+  }
+
+  //--------------------------------------------------------------------------
+  // _writeArrayEnq()
+  //
+  // Writes input parameters in case of array enqueue.
+  //--------------------------------------------------------------------------
+  _writeArrayEnq(buf) {
+    const queueNameBytes = Buffer.from(this.queueImpl.name);
+    const deliveryMode = this.enqOptionsImpl.deliveryMode;
+    let flags = 0;
+
+    if (deliveryMode === constants.TNS_AQ_MSG_BUFFERED) {
+      flags |= constants.TNS_KPD_AQ_BUFMSG;
+    } else if (deliveryMode === constants.TNS_AQ_MSG_PERSISTENT_OR_BUFFERED) {
+      flags |= constants.TNS_KPD_AQ_EITHER;
+    }
+
+    buf.writeUB4(0);                        // rel msgid len
+    buf.writeUInt8(constants.TNS_MSG_TYPE_ROW_HEADER);
+    buf.writeUB4(queueNameBytes.length);
+    buf.writeBytesWithLength(queueNameBytes);
+    buf.writeBytes(this.queueImpl.payloadToid);
+    buf.writeUB2(constants.TNS_AQ_MESSAGE_VERSION);
+    buf.writeUB4(flags);
+
+    for (const propsImpl of this.propsImpls) {
+      buf.writeUInt8(constants.TNS_MSG_TYPE_ROW_DATA);
+      buf.writeUB4(flags);                  // aqi flags
+      this._writeMsgProps(buf, propsImpl);
+      if (propsImpl.recipients === null || propsImpl.recipients.length === 0) {
+        buf.writeUB4(0);                    // num recipients
+      } else {
+        buf.writeUB4(3 * propsImpl.recipients.length);
+        this._writeRecipients(buf, propsImpl);
+      }
+      buf.writeSB4(this.enqOptionsImpl.visibility);
+      buf.writeUB4(0);                      // relative msg id
+      buf.writeSB4(0);                      // seq deviation
+      if (!this.queueImpl.payloadTypeClass && !this.queueImpl.isJson) {
+        buf.writeUB4(propsImpl.payload.length);
+      }
+      this._writePayload(buf, propsImpl);
+    }
+    buf.writeUInt8(constants.TNS_MSG_TYPE_STATUS);
+  }
+
+  //--------------------------------------------------------------------------
+  // _writeMessageBody()
+  //
+  // Writes the body of the message to the buffer.
+  //--------------------------------------------------------------------------
+  encode(buf) {
+    this.writeFunctionHeader(buf);
+    if (this.operation === constants.TNS_AQ_ARRAY_ENQ) {
+      buf.writeUInt8(0);                    // input params
+      buf.writeUB4(0);                      // length
+    } else {
+      buf.writeUInt8(1);
+      buf.writeUB4(this.numIters);
+    }
+    buf.writeUB4(constants.TNS_AQ_ARRAY_FLAGS_RETURN_MESSAGE_ID);
+    if (this.operation === constants.TNS_AQ_ARRAY_ENQ) {
+      buf.writeUInt8(1);                    // output params
+      buf.writeUInt8(0);                    // length
+    } else {
+      buf.writeUInt8(1);
+      buf.writeUInt8(1);
+    }
+    buf.writeSB4(this.operation);
+    if (this.operation === constants.TNS_AQ_ARRAY_ENQ) {
+      buf.writeUInt8(1);                    // num iters (pointer)
+    } else {
+      buf.writeUInt8(0);
+    }
+    if (buf.caps.ttcFieldVersion >= constants.TNS_CCAP_FIELD_VERSION_21_1) {
+      buf.writeUB4(0xffff);                 // shard id
+    }
+    if (this.operation === constants.TNS_AQ_ARRAY_ENQ) {
+      buf.writeUB4(this.numIters);
+    }
+    if (this.operation === constants.TNS_AQ_ARRAY_ENQ) {
+      this._writeArrayEnq(buf);
+    } else {
+      this._writeArrayDeq(buf);
+    }
+  }
+
+}
+
+module.exports = AqArrayMessage;