oracledb 6.3.0 → 6.4.0

package/LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2015, 2023 Oracle and/or its affiliates.
+Copyright (c) 2015, 2024 Oracle and/or its affiliates.
 
 This software is dual-licensed to you under the Universal Permissive License
 (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl and Apache License

package/NOTICE.txt

@@ -1 +1 @@
-Copyright (c) 2015, 2023, Oracle and/or its affiliates.
+Copyright (c) 2015, 2024, Oracle and/or its affiliates.

package/README.md

@@ -1,10 +1,10 @@
-# node-oracledb version 6.3.0
+# node-oracledb version 6.4.0
 
 The node-oracledb add-on for Node.js powers high performance Oracle Database
 applications.  Applications can be written in TypeScript, or directly in
 JavaScript.
 
-Use node-oracledb 6.3.0 to connect Node.js 14.6, or later, to Oracle
+Use node-oracledb 6.4.0 to connect Node.js 14.6, or later, to Oracle
 Database.  Older versions of node-oracledb may work with older versions of
 Node.js.
 
@@ -48,7 +48,7 @@ vulnerability disclosure process.
 
 ## License
 
-Copyright (c) 2015, 2023, Oracle and/or its affiliates.
+Copyright (c) 2015, 2024, Oracle and/or its affiliates.
 
 This software is dual-licensed to you under the Universal Permissive License
 (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl and Apache License

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

@@ -0,0 +1 @@
+oracledb-6.4.0-darwin-x64.node v18.17.0 df971fa2503fcf9ab4a63f2f2508f5fb5780c0e1 31cd3b6682f32ad860df63d1dd06e3bf1c5e62aa Thu, 29 Feb 2024 13:53:47 GMT

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

@@ -0,0 +1 @@
+df971fa2503fcf9ab4a63f2f2508f5fb5780c0e1

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

@@ -0,0 +1 @@
+oracledb-6.4.0-linux-arm64.node v18.19.0 df971fa2503fcf9ab4a63f2f2508f5fb5780c0e1 31cd3b6682f32ad860df63d1dd06e3bf1c5e62aa Thu, 29 Feb 2024 15:01:23 GMT

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

@@ -0,0 +1 @@
+oracledb-6.4.0-linux-x64.node v16.20.2 df971fa2503fcf9ab4a63f2f2508f5fb5780c0e1 31cd3b6682f32ad860df63d1dd06e3bf1c5e62aa Thu, 29 Feb 2024 14:56:18 GMT

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

@@ -0,0 +1 @@
+oracledb-6.4.0-win32-x64.node v18.16.0 df971fa2503fcf9ab4a63f2f2508f5fb5780c0e1 31cd3b6682f32ad860df63d1dd06e3bf1c5e62aa Thu, 29 Feb 2024 15:35:39 GMT

package/examples/README.md

@@ -63,6 +63,7 @@ File Name                                                 | Description
 [`aqobject.js`](aqobject.js)                              | Oracle Advanced Queuing (AQ) example passing an Oracle Database object
 [`aqoptions.js`](aqoptions.js)                            | Oracle Advanced Queuing (AQ) example setting options and message attributes
 [`aqraw.js`](aqraw.js)                                    | Basic Oracle Advanced Queuing (AQ) example passing text messages
+[`aqutil.js`](aqutil.js)                                  | Common file to setup the user credentials for all the Advanced Queuing (AQ) examples.
 [`blobhttp.js`](blobhttp.js)                              | Simple web app that streams an image
 [`calltimeout.js`](calltimeout.js)                        | Shows how to cancel a SQL statement if it doesn't complete in a specified time
 [`connect.js`](connect.js)                                | Basic example for creating a standalone (non-pooled) connection
@@ -112,6 +113,8 @@ File Name                                                 | Description
 [`resultset2.js`](resultset2.js)                          | Executes a query and uses a ResultSet to fetch batches of rows with `getRows()`
 [`resultsettoquerystream.js`](resultsettoquerystream.js)  | Converts a ResultSet returned from `execute()` into a Readable Stream.
 [`rowlimit.js`](rowlimit.js)                              | Shows ways to limit the number of records fetched by queries
+[`sampleazuretokenauth.js`](sampleazuretokenauth.js)      | Shows connection pooling with Azure token based authentication.
+[`sampleocitokenauth.js`](sampleocitokenauth.js)          | Shows connection pooling with OCI OAuth 2.0 token based authentication.
 [`select1.js`](select1.js)                                | Executes a basic query without using a connection pool or ResultSet
 [`select2.js`](select2.js)                                | Executes queries to show array and object output formats
 [`selectgeometry.js`](selectgeometry.js)                  | Insert and query Oracle Spatial geometries

package/lib/aqQueue.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2019, 2023, Oracle and/or its affiliates.
+// Copyright (c) 2019, 2024, Oracle and/or its affiliates.
 
 //-----------------------------------------------------------------------------
 //
@@ -169,7 +169,7 @@ class AqQueue {
     errors.assertArgCount(arguments, 1, 1);
     errors.assertParamValue(Number.isInteger(maxMessages) && maxMessages > 0,
       1);
-    const msgImpls = await this._impl.deqMany(maxMessages);
+    const msgImpls = await this._impl.deq(maxMessages);
     return  msgImpls.map(i => this._makeMessage(i));
   }
 
@@ -180,9 +180,9 @@ class AqQueue {
   //---------------------------------------------------------------------------
   async deqOne() {
     errors.assertArgCount(arguments, 0, 0);
-    const msgImpl = await this._impl.deqOne();
-    if (msgImpl)
-      return this._makeMessage(msgImpl);
+    const msgImpls = await this._impl.deq(1);
+    if (msgImpls)
+      return this._makeMessage(msgImpls[0]);
   }
 
   //---------------------------------------------------------------------------
@@ -212,7 +212,7 @@ class AqQueue {
     for (let i = 0; i < messages.length; i++) {
       verifiedMessages[i] = this._verifyMessage(messages[i]);
     }
-    const msgImpls = await this._impl.enqMany(verifiedMessages);
+    const msgImpls = await this._impl.enq(verifiedMessages);
     return msgImpls.map(i => this._makeMessage(i));
   }
 
@@ -224,8 +224,8 @@ class AqQueue {
   async enqOne(message) {
     errors.assertArgCount(arguments, 1, 1);
     message = this._verifyMessage(message);
-    const msgImpl = await this._impl.enqOne(message);
-    return this._makeMessage(msgImpl);
+    const msgImpls = await this._impl.enq([message]);
+    return this._makeMessage(msgImpls[0]);
   }
 
   //---------------------------------------------------------------------------

package/lib/connection.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2016, 2023, Oracle and/or its affiliates.
+// Copyright (c) 2016, 2024, Oracle and/or its affiliates.
 
 //-----------------------------------------------------------------------------
 //
@@ -43,6 +43,7 @@ const constants = require('./constants.js');
 const settings = require('./settings.js');
 const transformer = require('./transformer.js');
 const types = require('./types.js');
+const oson = require('./impl/datahandlers/oson.js');
 
 // global mapping of subscriptions; these cannot be tied to a particular
 // connection or pool since subscriptions can be created with one connection
@@ -105,7 +106,10 @@ class Connection extends EventEmitter {
       const cls = this._getDbObjectClass(objType.elementTypeClass);
       objType.elementTypeClass = cls;
     }
-    nodbUtil.addTypeProperties(objType, "elementType");
+    if (objType.isCollection) {
+      nodbUtil.addTypeProperties(objType, "elementType");
+      objType.elementTypeInfo.type = objType.elementType;
+    }
     if (objType.attributes) {
       const props = {};
       for (const attr of objType.attributes) {
@@ -197,6 +201,9 @@ class Connection extends EventEmitter {
       typeof value === 'string' ||
       typeof value === 'boolean' ||
       Array.isArray(value) ||
+      value instanceof Float32Array ||
+      value instanceof Float64Array ||
+      value instanceof Int8Array ||
       Buffer.isBuffer(value) ||
       util.isDate(value) ||
       value instanceof Lob ||
@@ -833,6 +840,29 @@ class Connection extends EventEmitter {
     this._impl.setECID(value);
   }
 
+  //---------------------------------------------------------------------------
+  // decode()
+  //
+  // Decodes OSON Buffer to JS data type.
+  //---------------------------------------------------------------------------
+  decodeOSON(buf) {
+    errors.assertArgCount(arguments, 1, 1);
+    errors.assertParamValue(Buffer.isBuffer(buf), 1);
+    const decoder = new oson.OsonDecoder(buf);
+    return decoder.decode();
+  }
+
+
+  //---------------------------------------------------------------------------
+  // encode()
+  //
+  // Encodes the JS value into OSON bytes.
+  //---------------------------------------------------------------------------
+  encodeOSON(value) {
+    const encoder = new oson.OsonEncoder();
+    return encoder.encode(transformer.transformJsonValue(value));
+  }
+
   //---------------------------------------------------------------------------
   // execute()
   //
@@ -844,13 +874,24 @@ class Connection extends EventEmitter {
     let options = {};
 
     // process arguments
-    errors.assertArgCount(arguments, 1, 3);
-    errors.assertParamValue(typeof sql === 'string', 1);
-    if (arguments.length >= 2) {
-      binds = await this._processExecuteBinds(a2);
-    }
-    if (arguments.length == 3) {
-      options = this._verifyExecOpts(a3, false);
+    if (nodbUtil.isObject(sql) && typeof sql.statement === 'string') {
+      errors.assertArgCount(arguments, 1, 2);
+      if (sql.values) {
+        binds = await this._processExecuteBinds(sql.values);
+      }
+      sql = sql.statement;
+      if (arguments.length == 2) {
+        options = this._verifyExecOpts(a2, false);
+      }
+    } else {
+      errors.assertArgCount(arguments, 1, 3);
+      errors.assertParamValue(typeof sql === 'string', 1);
+      if (arguments.length >= 2) {
+        binds = await this._processExecuteBinds(a2);
+      }
+      if (arguments.length == 3) {
+        options = this._verifyExecOpts(a3, false);
+      }
     }
     this._addDefaultsToExecOpts(options);
     errors.assert(this._impl, errors.ERR_INVALID_CONNECTION);
@@ -946,6 +987,11 @@ class Connection extends EventEmitter {
     const result = await this._impl.execute(sql, numIters, binds, options,
       true);
 
+    // convert ORA warnings to NJS
+    if (result.warning) {
+      result.warning = errors.transformErr(result.warning);
+    }
+
     // process output binds
     if (result.outBinds !== undefined) {
       for (let i = 0; i < result.outBinds.length; i++) {

package/lib/constants.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2022, 2023, Oracle and/or its affiliates.
+// Copyright (c) 2022, 2024, Oracle and/or its affiliates.
 
 //-----------------------------------------------------------------------------
 //
@@ -200,4 +200,10 @@ module.exports = {
   // TPC/XA two-phase commit flags
   TPC_END_NORMAL: 0,
   TPC_END_SUSPEND: 0x00100000,
+
+  // vector types
+  VECTOR_FORMAT_FLOAT32: 2,
+  VECTOR_FORMAT_FLOAT64: 3,
+  VECTOR_FORMAT_INT8: 4,
+
 };

package/lib/dbObject.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2019, 2023, Oracle and/or its affiliates.
+// Copyright (c) 2019, 2024, Oracle and/or its affiliates.
 
 //----------------------------------------------------------------------------
 //
@@ -32,6 +32,48 @@ const errors = require('./errors.js');
 const types = require('./types.js');
 const util = require('util');
 
+//---------------------------------------------------------------------------
+// validatePropertyValue
+//
+// Validate the value based on metadata.
+// For object type, metaData corresponds to the attribute which is set.
+// For collection type, metaData corresponds to element in the collection.
+//---------------------------------------------------------------------------
+function validatePropertyValue(objType, metaData, value, index) {
+  let valueLen, lengthErr = false;
+
+  if (value) {
+    switch (metaData.type) {
+      case types.DB_TYPE_VARCHAR:
+      case types.DB_TYPE_NVARCHAR:
+      case types.DB_TYPE_NCHAR:
+      case types.DB_TYPE_CHAR:
+        valueLen = Buffer.byteLength(value);
+        if (valueLen > metaData.maxSize) {
+          lengthErr = true;
+        }
+        break;
+      case types.DB_TYPE_RAW:
+        valueLen = value.length;
+        if (valueLen > metaData.maxSize) {
+          lengthErr = true;
+        }
+        break;
+      default:
+        break;
+    }
+    if (lengthErr) {
+      if (index !== undefined) {
+        errors.throwErr(errors.ERR_WRONG_LENGTH_FOR_DBOBJECT_ELEM,
+          index, objType.fqn, valueLen, metaData.maxSize);
+      } else {
+        errors.throwErr(errors.ERR_WRONG_LENGTH_FOR_DBOBJECT_ATTR,
+          metaData.name, objType.fqn, valueLen, metaData.maxSize);
+      }
+    }
+  }
+}
+
 // define base database object class; instances of this class are never
 // instantiated; instead, classes subclassed from this one will be
 // instantiated; a cache of these classes are maintained on each connection
@@ -61,6 +103,7 @@ class BaseDbObject {
     };
     const options = {allowArray: false};
     value = transformer.transformValueIn(info, value, options);
+    validatePropertyValue(this._objType, attr, value);
     this._impl.setAttrValue(attr, value);
   }
 
@@ -124,6 +167,13 @@ class BaseDbObject {
     };
     const options = {allowArray: false};
     value = transformer.transformValueIn(info, value, options);
+    let index = this._impl.getLastIndex();
+    if (index) {
+      index = index + 1; // element will be appended at index + 1.
+    } else {
+      index = 0; // undefined for initial append, so set it to 0
+    }
+    validatePropertyValue(this._objType, this._objType.elementTypeInfo, value, index);
     this._impl.append(value);
   }
 
@@ -344,6 +394,7 @@ class BaseDbObject {
     };
     const options = {allowArray: false};
     value = transformer.transformValueIn(info, value, options);
+    validatePropertyValue(this._objType, this._objType.elementTypeInfo, value, index);
     this._impl.setElement(index, value);
   }
 
@@ -388,6 +439,25 @@ class BaseDbObject {
     return (this._toPojo());
   }
 
+  //---------------------------------------------------------------------------
+  // toMap()
+  //
+  // Returns the Map object where the collection’s indexes are the keys and
+  // the elements are its values.
+  //---------------------------------------------------------------------------
+  toMap() {
+    errors.assertArgCount(arguments, 0, 0);
+    if (!this.isCollection) {
+      errors.throwErr(errors.ERR_OBJECT_IS_NOT_A_COLLECTION,
+        this.name);
+    }
+    const result = new Map();
+    this.getKeys().forEach(element => {
+      result.set(element, this.getElement(element));
+    });
+    return result;
+  }
+
 }
 
 // method for transforming the error
@@ -421,6 +491,7 @@ wrapFns(BaseDbObject.prototype,
   "getNextIndex",
   "getPrevIndex",
   "getValues",
+  "toMap",
   "hasElement",
   "setElement",
   "trim"

package/lib/errors.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2022, 2023, Oracle and/or its affiliates.
+// Copyright (c) 2022, 2024, Oracle and/or its affiliates.
 
 //-----------------------------------------------------------------------------
 //
@@ -107,7 +107,6 @@ const ERR_POOL_HAS_BUSY_CONNECTIONS = 104;
 const ERR_NAN_VALUE = 105;
 const ERR_INTERNAL = 106;
 const ERR_INVALID_REF_CURSOR = 107;
-const ERR_LOB_CLOSED = 108;
 const ERR_INVALID_TYPE_NUM = 109;
 const ERR_INVALID_ORACLE_TYPE_NUM = 110;
 const ERR_UNEXPECTED_NEGATIVE_INTEGER = 111;
@@ -138,6 +137,12 @@ const ERR_MISSING_BIND_VALUE = 137;
 const ERR_SERVER_VERSION_NOT_SUPPORTED = 138;
 const ERR_UNEXPECTED_XML_TYPE = 139;
 const ERR_WRONG_USER_FORMAT_EXTAUTH_PROXY = 140;
+const ERR_TOO_MANY_BATCH_ERRORS = 141;
+const ERR_WRONG_LENGTH_FOR_DBOBJECT_ATTR = 142;
+const ERR_WRONG_LENGTH_FOR_DBOBJECT_ELEM = 143;
+const ERR_VECTOR_FORMAT_NOT_SUPPORTED = 144;
+const ERR_VECTOR_VERSION_NOT_SUPPORTED = 145;
+const ERR_OBJECT_IS_NOT_A_COLLECTION = 146;
 
 // Oracle Net layer errors start from 500
 const ERR_CONNECTION_CLOSED = 500;
@@ -168,9 +173,8 @@ const WRN_COMPILATION_CREATE = 700;
 // define mapping for ODPI-C, OCI & ORA errors that need to be wrapped
 // with NJS errors
 const adjustErrorXref = new Map();
-adjustErrorXref.set("DPI-1010", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("DPI-1010", ERR_INVALID_CONNECTION);
 adjustErrorXref.set("DPI-1024", [ERR_INVALID_COLL_INDEX_GET, 'at index ([0-9]+) does']);
-adjustErrorXref.set("DPI-1040", ERR_LOB_CLOSED);
 adjustErrorXref.set("DPI-1044", ERR_ORACLE_NUMBER_NO_REPR);
 adjustErrorXref.set("DPI-1055", ERR_NAN_VALUE);
 adjustErrorXref.set("DPI-1063", ERR_EXEC_MODE_ONLY_FOR_DML);
@@ -190,7 +194,7 @@ const messages = new Map();
 messages.set(ERR_INVALID_POOL,                          // NJS-002
   'invalid pool');
 messages.set(ERR_INVALID_CONNECTION,                    // NJS-003
-  'invalid connection');
+  'invalid or closed connection');
 messages.set(ERR_INVALID_PROPERTY_VALUE,                // NJS-004
   'invalid value for property "%s"');
 messages.set(ERR_INVALID_PARAMETER_VALUE,               // NJS-005
@@ -341,8 +345,6 @@ messages.set(ERR_INTERNAL,                              // NJS-106
   'internal error: %s');
 messages.set(ERR_INVALID_REF_CURSOR,                    // NJS-107
   'invalid cursor');
-messages.set(ERR_LOB_CLOSED,                            // NJS-108
-  'LOB was already closed');
 messages.set(ERR_INVALID_TYPE_NUM,                      // NJS-109
   'invalid type number %d');
 messages.set(ERR_INVALID_ORACLE_TYPE_NUM,               // NJS-110
@@ -403,6 +405,18 @@ messages.set(ERR_UNEXPECTED_XML_TYPE,                   // NJS-139
   'unexpected XML type with flag %d');
 messages.set(ERR_WRONG_USER_FORMAT_EXTAUTH_PROXY,       // NJS-140
   'user name must be enclosed in [] when using external authentication with a proxy user');
+messages.set(ERR_TOO_MANY_BATCH_ERRORS,                 // NJS-141
+  'the number of batch errors from executemany() exceeds 65535');
+messages.set(ERR_WRONG_LENGTH_FOR_DBOBJECT_ATTR,        // NJS-142
+  'value too large for attribute %s of object %s (actual: %d, maximum: %d)');
+messages.set(ERR_WRONG_LENGTH_FOR_DBOBJECT_ELEM,        // NJS-143
+  'value too large for element %d of object %s (actual: %d, maximum: %d)');
+messages.set(ERR_VECTOR_FORMAT_NOT_SUPPORTED,           // NJS-144
+  'VECTOR format %d is not supported');
+messages.set(ERR_VECTOR_VERSION_NOT_SUPPORTED,          // NJS-145
+  'VECTOR version %d is not supported');
+messages.set(ERR_OBJECT_IS_NOT_A_COLLECTION,            // NJS-146
+  'object %s is not a collection');
 
 // Oracle Net layer errors
 
@@ -756,7 +770,6 @@ module.exports = {
   ERR_INVALID_REF_CURSOR,
   ERR_UNSUPPORTED_VERIFIER_TYPE,
   ERR_NAN_VALUE,
-  ERR_LOB_CLOSED,
   ERR_ORACLE_NUMBER_NO_REPR,
   ERR_INVALID_SERVICE_NAME,
   ERR_INVALID_SID,
@@ -789,6 +802,12 @@ module.exports = {
   ERR_SERVER_VERSION_NOT_SUPPORTED,
   ERR_UNEXPECTED_XML_TYPE,
   ERR_WRONG_USER_FORMAT_EXTAUTH_PROXY,
+  ERR_TOO_MANY_BATCH_ERRORS,
+  ERR_WRONG_LENGTH_FOR_DBOBJECT_ATTR,
+  ERR_WRONG_LENGTH_FOR_DBOBJECT_ELEM,
+  ERR_VECTOR_FORMAT_NOT_SUPPORTED,
+  ERR_VECTOR_VERSION_NOT_SUPPORTED,
+  ERR_OBJECT_IS_NOT_A_COLLECTION,
   ERR_CONNECTION_CLOSED_CODE: `${ERR_PREFIX}-${ERR_CONNECTION_CLOSED}`,
   WRN_COMPILATION_CREATE,
   assert,

package/lib/{thin/protocol → impl/datahandlers}/buffer.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2022, 2023, Oracle and/or its affiliates.
+// Copyright (c) 2022, 2024, Oracle and/or its affiliates.
 
 //-----------------------------------------------------------------------------
 //
@@ -29,8 +29,8 @@
 const { Buffer } = require('buffer');
 const constants = require("./constants.js");
 const errors = require("../../errors.js");
-const settings = require("../../settings.js");
 const types = require("../../types.js");
+const nodbUtil = require("../../util.js");
 
 /**
  * Base buffer class used for managing buffered data without unnecessary
@@ -184,7 +184,7 @@ class BaseBuffer {
       fseconds = Math.floor(buf.readUInt32BE(7) / (1000 * 1000));
     }
     const year = (buf[0] - 100) * 100 + buf[1] - 100;
-    return settings._makeDate(useLocalTime, year, buf[2], buf[3], buf[4] - 1,
+    return nodbUtil.makeDate(useLocalTime, year, buf[2], buf[3], buf[4] - 1,
       buf[5] - 1, buf[6] - 1, fseconds, 0);
   }
 
@@ -321,6 +321,22 @@ class BaseBuffer {
     return this.parseBinaryFloat(buf);
   }
 
+  //---------------------------------------------------------------------------
+  // readBinaryInteger()
+  //
+  // Reads a binary integer value from the buffer and returns a Number
+  //---------------------------------------------------------------------------
+  readBinaryInteger() {
+    const buf = this.readBytesWithLength();
+    if (!buf) {
+      return 0;
+    }
+    if (buf.length > 4) {
+      errors.throwErr(errors.ERR_INTEGER_TOO_LARGE, buf.length, 4, this.pos, this.packetNum);
+    }
+    return (buf.readIntBE(0, buf.length));
+  }
+
   //---------------------------------------------------------------------------
   // readBool()
   //
@@ -617,9 +633,10 @@ class BaseBuffer {
   //
   // Writes the number in binary double format to the buffer.
   //---------------------------------------------------------------------------
-  writeBinaryDouble(n) {
-    this.writeUInt8(8);
-    const pos = this.reserveBytes(8);
+  writeBinaryDouble(n, pos) {
+    if (!pos) {
+      pos = this.reserveBytes(8);
+    }
     this.buf.writeDoubleBE(n, pos);
     if ((this.buf[pos] & 0x80) === 0) {
       this.buf[pos] |= 0x80;
@@ -641,9 +658,10 @@ class BaseBuffer {
   //
   // Writes the number in binary float format to the buffer.
   //---------------------------------------------------------------------------
-  writeBinaryFloat(n) {
-    this.writeUInt8(4);
-    const pos = this.reserveBytes(4);
+  writeBinaryFloat(n, pos) {
+    if (!pos) {
+      pos = this.reserveBytes(4);
+    }
     this.buf.writeFloatBE(n, pos);
     if ((this.buf[pos] & 0x80) === 0) {
       this.buf[pos] |= 0x80;
@@ -869,29 +887,6 @@ class BaseBuffer {
 
   }
 
-  //---------------------------------------------------------------------------
-  // writeQLocator()
-  //
-  // Writes a QLocator. QLocators are always 40 bytes in length.
-  //---------------------------------------------------------------------------
-  writeQLocator(numBytes) {
-    this.writeUB4(40);                  // QLocator length
-    this.writeUInt8(40);                // repeated length
-    this.writeUInt16BE(38);             // internal length
-    this.writeUInt16BE(constants.TNS_LOB_QLOCATOR_VERSION);
-    this.writeUInt8(constants.TNS_LOB_LOC_FLAGS_VALUE_BASED |
-      constants.TNS_LOB_LOC_FLAGS_BLOB | constants.TNS_LOB_LOC_FLAGS_ABSTRACT);
-    this.writeUInt8(constants.TNS_LOB_LOC_FLAGS_INIT);
-    this.writeUInt16BE(0);              // additional flags
-    this.writeUInt16BE(1);              // byt1
-    this.writeUInt64BE(numBytes);
-    this.writeUInt16BE(0);              // unused
-    this.writeUInt16BE(0);              // csid
-    this.writeUInt16BE(0);              // unused
-    this.writeUInt64BE(0);              // unused
-    this.writeUInt64BE(0);              // unused
-  }
-
   //---------------------------------------------------------------------------
   // writeStr()
   //
@@ -984,6 +979,15 @@ class BaseBuffer {
     this.buf[pos] = n;
   }
 
+  // writeSB1()
+  //
+  // Writes an signed 8-bit integer to the buffer.
+  //---------------------------------------------------------------------------
+  writeSB1(n) {
+    const pos = this.reserveBytes(1);
+    this.buf[pos] = n;
+  }
+
   //---------------------------------------------------------------------------
   // writeUInt16BE()
   //