oracledb 6.8.0 → 6.10.0

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

@@ -0,0 +1,305 @@
+// 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.
+//
+//-----------------------------------------------------------------------------
+
+//-----------------------------------------------------------------------------
+// aqBase.js
+//
+// This file defines the base class for messages that are sent to the
+// database and the responses that are received by the client for enqueuing and
+// dequeuing AQ messages.
+//-----------------------------------------------------------------------------
+
+'use strict';
+
+const constants = require("../constants.js");
+const errors = require("../../../errors.js");
+const BaseMessage = require("./base.js");
+const { ThinDbObjectImpl } = require("../../dbObject.js");
+const oson = require('../../../impl/datahandlers/oson.js');
+
+class AqBaseMessage extends BaseMessage {
+
+  constructor(connImpl) {
+    super(connImpl);
+    this.queueImpl = null;
+    this.deqOptionsImpl = null;
+    this.enqOptionsImpl = null;
+    this.noMsgFound = false;
+  }
+
+  //--------------------------------------------------------------------------
+  // _processDate()
+  //
+  // Processes a date found in the buffer.
+  //--------------------------------------------------------------------------
+  _processDate(buf) {
+    const numBytes = buf.readUB4();
+    if (numBytes > 0)
+      return buf.readOracleDate(true);
+  }
+
+  //--------------------------------------------------------------------------
+  // _processErrorInfo()
+  //
+  // Process error information from the buffer. If the error that indicates
+  // that no messages were received is detected, the error is cleared and
+  // the flag set so that the dequeue can handle that case.
+  //--------------------------------------------------------------------------
+  processErrorInfo(buf) {
+    super.processErrorInfo(buf);
+    if (this.errorInfo.num === constants.TNS_ERR_NO_MESSAGES_FOUND) {
+      this.errorInfo.num = 0;
+      this.errorOccurred = false;
+      this.noMsgFound = true;
+    }
+  }
+
+  //--------------------------------------------------------------------------
+  // _processExtensions()
+  //
+  // Processes extensions to the message property object returned by the
+  // database.
+  //--------------------------------------------------------------------------
+  _processExtensions(buf, propsImpl) {
+    const numExtensions = buf.readUB4();
+    if (numExtensions > 0) {
+      buf.skipUB1();
+      for (let i = 0; i < numExtensions; i++) {
+        const textValue = buf.readBytesAndLength();
+        const binaryValue = buf.readBytesAndLength();
+        const value = textValue || binaryValue;
+        const keyword = buf.readUB2();
+        if (value) {
+          if (keyword === constants.TNS_AQ_EXT_KEYWORD_AGENT_NAME) {
+            propsImpl.senderAgentName = value;
+          } else if (keyword === constants.TNS_AQ_EXT_KEYWORD_AGENT_ADDRESS) {
+            propsImpl.senderAgentAddress = value;
+          } else if (keyword === constants.TNS_AQ_EXT_KEYWORD_AGENT_PROTOCOL) {
+            propsImpl.senderAgentProtocol = value[0];
+          } else if (keyword === constants.TNS_AQ_EXT_KEYWORD_ORIGINAL_MSGID) {
+            propsImpl.originalMsgId = value;
+          }
+        }
+      }
+    }
+  }
+
+  //--------------------------------------------------------------------------
+  // _processMsgId()
+  //
+  // Reads a message id from the buffer and returns it.
+  //--------------------------------------------------------------------------
+  _processMsgId(buf) {
+    return Buffer.from(buf.readBytes(constants.TNS_AQ_MESSAGE_ID_LENGTH));
+  }
+
+  //--------------------------------------------------------------------------
+  // _processMsgProps()
+  //
+  // Processes a message property object returned by the database.
+  //--------------------------------------------------------------------------
+  _processMsgProps(buf, propsImpl) {
+    propsImpl.priority = buf.readSB4();
+    propsImpl.delay = buf.readSB4();
+    propsImpl.expiration = buf.readSB4();
+    propsImpl.correlation = buf.readStrAndLength();
+    propsImpl.numAttempts = buf.readSB4();
+    propsImpl.exceptionQueue = buf.readStrAndLength();
+    propsImpl.state = buf.readSB4();
+    propsImpl.enqTime = this._processDate(buf);
+    propsImpl.enqTxnId = buf.readBytesAndLength();
+    this._processExtensions(buf, propsImpl);
+    const temp32 = buf.readUB4();           // user properties
+    if (temp32 > 0) {
+      errors.throwErr(errors.ERR_NOT_IMPLEMENTED);
+    }
+    buf.skipUB4();                          // csn
+    buf.skipUB4();                          // dsn
+    const flags = buf.readUB4();
+    if (flags === constants.TNS_KPD_AQ_BUFMSG) {
+      propsImpl.deliveryMode = constants.TNS_AQ_MSG_BUFFERED;
+    } else {
+      propsImpl.deliveryMode = constants.TNS_AQ_MSG_PERSISTENT;
+    }
+    if (buf.caps.ttcFieldVersion >= constants.TNS_CCAP_FIELD_VERSION_21_1) {
+      buf.skipUB4();                        // shard number
+    }
+  }
+
+  //--------------------------------------------------------------------------
+  // _processPayload()
+  //
+  // Processes the payload for an enqueued message returned by the database.
+  //--------------------------------------------------------------------------
+  _processPayload(buf) {
+    const payloadData = buf.readDbObject();
+    if (this.queueImpl.payloadTypeClass) {
+      const obj = new this.queueImpl.payloadTypeClass();
+      const objImpl = new ThinDbObjectImpl(this.queueImpl.payloadTypeClass,
+        payloadData.packedData);
+      if (payloadData) {
+        objImpl.toid = payloadData.toid;
+        objImpl.oid = payloadData.oid;
+      }
+      obj._impl = objImpl;
+      return obj;
+    } else {
+      if (payloadData.packedData) {
+        const payload = Buffer.from(payloadData.packedData.slice(4));
+        if (this.queueImpl.isJson) {
+          const decoder =  new oson.OsonDecoder(payload);
+          return decoder.decode();
+        }
+        return payload;
+      } else if (!this.queueImpl.isJson) {
+        return Buffer.alloc(0);
+      }
+    }
+  }
+
+  //--------------------------------------------------------------------------
+  // _processRecipients()
+  //
+  // Process recipients for a message.
+  //--------------------------------------------------------------------------
+  _processRecipients(buf) {
+    const numRecipients = buf.readUB4();
+    if (numRecipients > 0)
+      errors.throwNotImplemented('aq recipients');
+    return [];
+  }
+
+  //--------------------------------------------------------------------------
+  // _writeMsgProps()
+  //
+  // Write a message property object to the buffer.
+  //--------------------------------------------------------------------------
+  _writeMsgProps(buf, propsImpl) {
+    buf.writeSB4(propsImpl.priority);
+    buf.writeSB4(propsImpl.delay);
+    buf.writeSB4(propsImpl.expiration);
+    this._writeValueWithLength(buf, propsImpl.correlation);
+    buf.writeUB4(0);                        // number of attempts
+    this._writeValueWithLength(buf, propsImpl.exceptionQueue);
+    buf.writeUB4(propsImpl.state);
+    buf.writeUB4(0);                        // enqueue time length
+    this._writeValueWithLength(buf, propsImpl.enqTxnId);
+    buf.writeUB4(4);                        // number of extensions
+    buf.writeUInt8(0x0e);                   // unknown extra byte
+
+    this._writeKeywordValuePair(buf, null, null,
+      constants.TNS_AQ_EXT_KEYWORD_AGENT_NAME);
+    this._writeKeywordValuePair(buf, null, null,
+      constants.TNS_AQ_EXT_KEYWORD_AGENT_ADDRESS);
+    this._writeKeywordValuePair(buf, null, Buffer.from([0x00]),
+      constants.TNS_AQ_EXT_KEYWORD_AGENT_PROTOCOL);
+    this._writeKeywordValuePair(buf, null, null,
+      constants.TNS_AQ_EXT_KEYWORD_ORIGINAL_MSGID);
+
+    buf.writeUB4(0);                        // user property
+    buf.writeUB4(0);                        // cscn
+    buf.writeUB4(0);                        // dscn
+    buf.writeUB4(0);                        // flags
+    if (buf.caps.ttcFieldVersion >= constants.TNS_CCAP_FIELD_VERSION_21_1) {
+      buf.writeUB4(0xffffffff);             // shard id
+    }
+  }
+
+  //--------------------------------------------------------------------------
+  // _writePayload()
+  //
+  // Writes the payload of the message property object to the buffer.
+  //--------------------------------------------------------------------------
+  _writePayload(buf, propsImpl) {
+    if (this.queueImpl.isJson) {
+      buf.writeOson(propsImpl.payload, this.connection._osonMaxFieldNameSize,
+        false);
+    } else if (this.queueImpl.payloadTypeClass) {
+      buf.writeDbObject(propsImpl.payload);
+    } else {
+      buf.writeBytes(propsImpl.payload);
+    }
+  }
+
+  //--------------------------------------------------------------------------
+  // _writeRecipients()
+  //
+  // Write the recipient list of the message property object to the buffer.
+  //--------------------------------------------------------------------------
+  _writeRecipients(buf, propsImpl) {
+    let index = 0;
+    for (const recipient of propsImpl.recipients) {
+      this._writeKeywordValuePair(buf, recipient, null, index);
+      this._writeKeywordValuePair(buf, null, null, index + 1);
+      this._writeKeywordValuePair(buf, null, Buffer.from([0x00]), index + 2);
+      index += 3;
+    }
+  }
+
+  //--------------------------------------------------------------------------
+  // _writeValueWithLength()
+  //
+  // Write a string to the buffer, prefixed by a length.
+  //--------------------------------------------------------------------------
+  _writeValueWithLength(buf, value) {
+    if (!value) {
+      buf.writeUB4(0);
+    } else {
+      const valueBytes = Buffer.isBuffer(value) ?
+        value : Buffer.from(value, 'utf-8');
+      buf.writeUB4(valueBytes.length);
+      buf.writeBytesWithLength(valueBytes);
+    }
+  }
+
+  //--------------------------------------------------------------------------
+  // _writeKeywordValuePair()
+  //
+  // Writes a keyword value pair to the buffer.
+  //--------------------------------------------------------------------------
+  _writeKeywordValuePair(buf, textValue, binaryValue, keyword) {
+    let textValueBytes;
+    if (!textValue) {
+      buf.writeUB4(0);
+    } else {
+      textValueBytes = Buffer.from(textValue);
+      buf.writeUB4(textValueBytes.length);
+      buf.writeBytesWithLength(textValueBytes);
+    }
+    if (!binaryValue) {
+      buf.writeUB4(0);
+    } else {
+      buf.writeUB4(binaryValue.length);
+      buf.writeBytesWithLength(binaryValue);
+    }
+
+    buf.writeUB2(keyword);
+  }
+
+}
+
+
+module.exports = AqBaseMessage;

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

@@ -0,0 +1,164 @@
+// 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.
+//
+//-----------------------------------------------------------------------------
+
+//-----------------------------------------------------------------------------
+// aqDeq.js
+//
+// This file defines the messages that are sent to the database and the
+// responses that are received by the client for dequeuing an AQ message.
+//-----------------------------------------------------------------------------
+
+'use strict';
+
+const AqBaseMessage = require("./aqBase.js");
+const constants = require("../constants.js");
+
+class AqDeqMessage extends AqBaseMessage {
+
+  constructor(connImpl) {
+    super(connImpl);
+    this.functionCode = constants.TNS_FUNC_AQ_DEQ;
+    this.propsImpl = null;
+  }
+
+  //--------------------------------------------------------------------------
+  // processReturnParameter()
+  //
+  // Process the return parameters of the AQ Dequeue request.
+  //--------------------------------------------------------------------------
+  processReturnParameter(buf) {
+    const numBytes = buf.readUB4();
+    if (numBytes > 0) {
+      this._processMsgProps(buf, this.propsImpl);
+      this.propsImpl.recipients = this._processRecipients(buf);
+      this.propsImpl.payload = this._processPayload(buf);
+      this.propsImpl.msgId = this._processMsgId(buf);
+    }
+  }
+
+  //--------------------------------------------------------------------------
+  // _writeMessageBody()
+  //
+  // Writes the body of the message to the buffer.
+  //--------------------------------------------------------------------------
+  encode(buf) {
+    const queueNameBytes = Buffer.from(this.queueImpl.name, 'utf-8');
+    const consumerNameBytes = this.deqOptionsImpl.consumerName ?
+      Buffer.from(this.deqOptionsImpl.consumerName, 'utf-8') : null;
+    const correlationBytes = this.deqOptionsImpl.correlation ?
+      Buffer.from(this.deqOptionsImpl.correlation, 'utf-8') : null;
+    const conditionBytes = this.deqOptionsImpl.condition ?
+      Buffer.from(this.deqOptionsImpl.condition, 'utf-8') : null;
+    let msgIdBytes = this.deqOptionsImpl.msgId ?
+      this.deqOptionsImpl.msgId.slice(0, 16) : null;
+    const deliveryMode = this.deqOptionsImpl.deliveryMode;
+    let deqFlags = 0;
+
+    if (msgIdBytes && msgIdBytes.length < 16) {
+      msgIdBytes = Buffer.concat([msgIdBytes,
+        Buffer.alloc(16 - msgIdBytes.length)]);
+    }
+
+    if (deliveryMode === constants.TNS_AQ_MSG_BUFFERED) {
+      deqFlags |= constants.TNS_KPD_AQ_BUFMSG;
+    } else if (deliveryMode === constants.TNS_AQ_MSG_PERSISTENT_OR_BUFFERED) {
+      deqFlags |= constants.TNS_KPD_AQ_EITHER;
+    }
+
+    this.writeFunctionHeader(buf);
+    buf.writeUInt8(1);                                  // queue name (ptr)
+    buf.writeUB4(queueNameBytes.length);                // queue name len
+    buf.writeUInt8(1);                                  // message properties
+    buf.writeUInt8(1);                                  // msg props len
+    buf.writeUInt8(1);                                  // recipient list
+    buf.writeUInt8(1);                                  // recipient list len
+    if (consumerNameBytes) {
+      buf.writeUInt8(1);                                // consumer name
+      buf.writeUB4(consumerNameBytes.length);
+    } else {
+      buf.writeUInt8(0);                                // consumer name
+      buf.writeUB4(0);                                  // consumer name len
+    }
+    buf.writeSB4(this.deqOptionsImpl.mode);             // dequeue mode
+    buf.writeSB4(this.deqOptionsImpl.navigation);       // navigation
+    buf.writeSB4(this.deqOptionsImpl.visibility);       // visibility
+    buf.writeSB4(this.deqOptionsImpl.wait);             // wait
+    if (msgIdBytes) {
+      buf.writeUInt8(1);                                // select mesg id
+      buf.writeUB4(constants.TNS_AQ_MESSAGE_ID_LENGTH); // mesg id len
+    } else {
+      buf.writeUInt8(0);                                // select mesg id
+      buf.writeUB4(0);                                  // select mesg id len
+    }
+    if (correlationBytes) {
+      buf.writeUInt8(1);                                // correlation id
+      buf.writeUB4(correlationBytes.length);            // correlation id len
+    } else {
+      buf.writeUInt8(0);                                // correlation id
+      buf.writeUB4(0);                                  // correlation id len
+    }
+    buf.writeUInt8(1);                                  // toid of payload
+    buf.writeUB4(16);                                   // toid len
+    buf.writeUB2(constants.TNS_AQ_MESSAGE_VERSION);
+    buf.writeUInt8(1);                                  // payload
+    buf.writeUInt8(1);                                  // return msg id
+    buf.writeUB4(constants.TNS_AQ_MESSAGE_ID_LENGTH);
+    buf.writeUB4(deqFlags);                             // dequeue flags
+    if (conditionBytes) {
+      buf.writeUInt8(1);                                // condition (pointer)
+      buf.writeUB4(conditionBytes.length);              // condition len
+    } else {
+      buf.writeUInt8(0);                                // condition
+      buf.writeUB4(0);                                  // condition len
+    }
+    buf.writeUInt8(0);                                  // extensions
+    buf.writeUB4(0);                                    // number of extensions
+    if (buf.caps.ttcFieldVersion >= constants.TNS_CCAP_FIELD_VERSION_20_1) {
+      buf.writeUInt8(0);                                // JSON payload
+    }
+    if (buf.caps.ttcFieldVersion >= constants.TNS_CCAP_FIELD_VERSION_21_1) {
+      buf.writeUB4(0xffffffff);                         // shard id
+    }
+
+    buf.writeBytesWithLength(queueNameBytes);
+    if (consumerNameBytes) {
+      buf.writeBytesWithLength(consumerNameBytes);
+    }
+    if (msgIdBytes) {
+      buf.writeBytes(msgIdBytes);
+    }
+    if (correlationBytes) {
+      buf.writeBytesWithLength(correlationBytes);
+    }
+    buf.writeBytes(this.queueImpl.payloadToid);
+    if (conditionBytes) {
+      buf.writeBytesWithLength(conditionBytes);
+    }
+  }
+
+}
+
+module.exports = AqDeqMessage;

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

@@ -0,0 +1,135 @@
+// 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.
+//
+//-----------------------------------------------------------------------------
+
+//-----------------------------------------------------------------------------
+// aqEnq.js
+//
+// This file defines the messages that are sent to the database and the
+// responses that are received by the client for enqueuing an AQ message.
+//-----------------------------------------------------------------------------
+
+'use strict';
+
+const AqBaseMessage = require("./aqBase.js");
+const constants = require("../constants.js");
+
+class AqEnqMessage extends AqBaseMessage {
+
+  constructor(connImpl) {
+    super(connImpl);
+    this.functionCode = constants.TNS_FUNC_AQ_ENQ;
+    this.propsImpl = null;
+  }
+
+  //--------------------------------------------------------------------------
+  // processReturnParameter()
+  //
+  // Process the return parameters for the AQ enqueue request.
+  //--------------------------------------------------------------------------
+  processReturnParameter(buf) {
+    this.propsImpl.msgId = this._processMsgId(buf);
+    buf.skipUB2();                                    // extensions length
+  }
+
+  //--------------------------------------------------------------------------
+  // encode()
+  //
+  // Writes the body of the message to the buffer.
+  //--------------------------------------------------------------------------
+  encode(buf) {
+    const queueNameBytes = Buffer.from(this.queueImpl.name, 'utf-8');
+    let enqFlags = 0;
+
+    if (this.enqOptionsImpl.deliveryMode === constants.TNS_AQ_MSG_BUFFERED) {
+      enqFlags |= constants.TNS_KPD_AQ_BUFMSG;
+    }
+
+    this.writeFunctionHeader(buf);
+    buf.writeUInt8(1);                                // queue name (ptr)
+    buf.writeUB4(queueNameBytes.length);              // queue name len
+    this._writeMsgProps(buf, this.propsImpl);
+    if (!this.propsImpl.recipients) {
+      buf.writeUInt8(0);                              // recipients (ptr)
+      buf.writeUB4(0);                                // no. of key/value pairs
+    } else {
+      buf.writeUInt8(1);                              // recipients (ptr)
+      buf.writeUB4(3 * this.propsImpl.recipients.length);
+    }
+    buf.writeUB4(this.enqOptionsImpl.visibility);
+    buf.writeUInt8(0);                                // relative msg id
+    buf.writeUB4(0);                                  // relative msg len
+    buf.writeUB4(0);                                  // sequence deviation
+    buf.writeUInt8(1);                                // TOID of payload (ptr)
+    buf.writeUB4(16);                                 // TOID of payload len
+    buf.writeUB2(constants.TNS_AQ_MESSAGE_VERSION);
+    if (this.queueImpl.isJson) {
+      buf.writeUInt8(0);                              // payload (ptr)
+      buf.writeUInt8(0);                              // RAW payload (ptr)
+      buf.writeUB4(0);                                // RAW payload len
+    } else if (this.queueImpl.payloadTypeClass) {
+      buf.writeUInt8(1);                              // payload (ptr)
+      buf.writeUInt8(0);                              // RAW payload (ptr)
+      buf.writeUB4(0);                                // RAW payload len
+    } else {
+      buf.writeUInt8(0);                              // payload (ptr)
+      buf.writeUInt8(1);                              // RAW payload (ptr)
+      buf.writeUB4(this.propsImpl.payload.length);
+    }
+    buf.writeUInt8(1);                                // return msg id (ptr)
+    buf.writeUB4(constants.TNS_AQ_MESSAGE_ID_LENGTH); // return msg id len
+    buf.writeUB4(enqFlags);                           // enqueue flags
+    buf.writeUInt8(0);                                // extensions 1 (ptr)
+    buf.writeUB4(0);                                  // number of extensions 1
+    buf.writeUInt8(0);                                // extensions 2 (ptr)
+    buf.writeUB4(0);                                  // number of extensions 2
+    buf.writeUInt8(0);                                // source sequence number
+    buf.writeUB4(0);                                  // source sequence len
+    buf.writeUInt8(0);                                // max sequence number
+    buf.writeUB4(0);                                  // max sequence len
+    buf.writeUInt8(0);                                // output ack len
+    buf.writeUInt8(0);                                // correlation (ptr)
+    buf.writeUB4(0);                                  // correlation len
+    buf.writeUInt8(0);                                // sender name (ptr)
+    buf.writeUB4(0);                                  // sender name len
+    buf.writeUInt8(0);                                // sender address (ptr)
+    buf.writeUB4(0);                                  // sender address len
+    buf.writeUInt8(0);                                // sender charset id
+    buf.writeUInt8(0);                                // sender ncharset id
+    if (buf.caps.ttcFieldVersion >= constants.TNS_CCAP_FIELD_VERSION_20_1) {
+      buf.writeUInt8(this.queueImpl.isJson ? 1 : 0);  // JSON payload (ptr)
+    }
+
+    buf.writeBytesWithLength(queueNameBytes);
+    if (this.propsImpl.recipients) {
+      this._writeRecipients(buf, this.propsImpl);
+    }
+    buf.writeBytes(this.queueImpl.payloadToid);
+    this._writePayload(buf, this.propsImpl);
+  }
+
+}
+
+module.exports = AqEnqMessage;

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

@@ -114,6 +114,7 @@ class AuthMessage extends Message {
     } else if (process.env.ORA_EDITION) {
       this.edition = process.env.ORA_EDITION;
     }
+    this.appContext = config.appContext;
     this.setAuthMode(config);
   }
 
@@ -247,6 +248,9 @@ class AuthMessage extends Message {
         if (this.edition) {
           numPairs += 1;
         }
+        if (this.appContext) {
+          numPairs += this.appContext.length * 3;
+        }
         if (this.schemaUser.length !== 0) {
           numPairs += 1;
         }
@@ -319,6 +323,15 @@ class AuthMessage extends Message {
       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]);
+        }
+      }
 
     }
   }
@@ -342,34 +355,19 @@ class AuthMessage extends Message {
     }
     if (this.functionCode === constants.TNS_FUNC_AUTH_PHASE_ONE) {
       this.functionCode = constants.TNS_FUNC_AUTH_PHASE_TWO;
-    } else {
-      let releaseNum;
-      let updateNum;
-      let portReleaseNum;
-      let portUpdateNum;
-
-      this.conn.dbDomain = this.sessionData['AUTH_SC_DB_DOMAIN'];
-      this.conn.dbName = this.sessionData['AUTH_DBNAME'];
-      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;
-      if (buf.caps.ttcFieldVersion >= constants.TNS_CCAP_FIELD_VERSION_18_1_EXT_1) {
-        releaseNum = (fullVersionNum >> 16) & 0xFF;
-        updateNum = (fullVersionNum >> 12) & 0x0F;
-        portReleaseNum = (fullVersionNum >> 4) & 0xFF;
-        portUpdateNum = fullVersionNum & 0x0F;
-      } else {
-        releaseNum = (fullVersionNum >> 20) & 0x0F;
-        updateNum = (fullVersionNum >> 12) & 0xFF;
-        portReleaseNum = (fullVersionNum >> 8) & 0x0F;
-        portUpdateNum = fullVersionNum & 0xFF;
+    } else if (!this.changePassword && this.comboKey) {
+      const value = this.sessionData.AUTH_SVR_RESPONSE;
+      let response;
+      if (value) {
+        const encodedResponse = Buffer.from(value, "hex");
+        response = ED.decrypt(this.comboKey, encodedResponse);
+      }
+      if (
+        !response ||
+        !response.subarray(16, 32).equals(Buffer.from("SERVER_TO_CLIENT"))
+      ) {
+        errors.throwErr(errors.ERR_INVALID_SERVER_RESPONSE);
       }
-      this.conn.serverVersionString = versionNum + '.' + releaseNum + '.' + updateNum + '.' + portReleaseNum + '.' + portUpdateNum;
-      this.conn.serverVersion = versionNum * 100000000 + releaseNum * 1000000 + updateNum * 10000 + portReleaseNum * 100 + portUpdateNum * 1;
     }
   }