oracledb 6.3.0 → 6.5.0

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()
   //

package/lib/impl/datahandlers/constants.js

@@ -0,0 +1,106 @@
+// Copyright (c) 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
+// 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.
+//
+//-----------------------------------------------------------------------------
+
+'use strict';
+
+const constants = require('../../constants.js');
+
+module.exports = {
+
+  // vector constants
+  TNS_VECTOR_MAGIC_BYTE: 0xDB,
+  TNS_VECTOR_VERSION: 0,
+
+  // vector flags
+  TNS_VECTOR_FLAG_NORMSRC: 0x0010,
+  TNS_VECTOR_FLAG_NORM: 0x0002,
+
+  // base JSON constants
+  TNS_JSON_MAGIC_BYTE_1: 0xff,
+  TNS_JSON_MAGIC_BYTE_2: 0x4a,       // 'J'
+  TNS_JSON_MAGIC_BYTE_3: 0x5a,       // 'Z'
+  TNS_JSON_VERSION_MAX_FNAME_255: 1,
+  TNS_JSON_VERSION_MAX_FNAME_65535: 3,
+  TNS_JSON_FLAG_HASH_ID_UINT8: 0x0100,
+  TNS_JSON_FLAG_HASH_ID_UINT16: 0x0200,
+  TNS_JSON_FLAG_NUM_FNAMES_UINT16: 0x0400,
+  TNS_JSON_FLAG_FNAMES_SEG_UINT32: 0x0800,
+  TNS_JSON_FLAG_TINY_NODES_STAT: 0x2000,
+  TNS_JSON_FLAG_TREE_SEG_UINT32: 0x1000,
+  TNS_JSON_FLAG_REL_OFFSET_MODE: 0x01,
+  TNS_JSON_FLAG_INLINE_LEAF: 0x02,
+  TNS_JSON_FLAG_LEN_IN_PCODE: 0x04,
+  TNS_JSON_FLAG_NUM_FNAMES_UINT32: 0x08,
+  TNS_JSON_FLAG_IS_SCALAR: 0x10,
+  TNS_JSON_FLAG_SEC_FNAMES_SEG_UINT16: 0x100,
+
+  // JSON data types
+  TNS_JSON_TYPE_NULL: 0x30,
+  TNS_JSON_TYPE_TRUE: 0x31,
+  TNS_JSON_TYPE_FALSE: 0x32,
+  TNS_JSON_TYPE_STRING_LENGTH_UINT8: 0x33,
+  TNS_JSON_TYPE_NUMBER_LENGTH_UINT8: 0x34,
+  TNS_JSON_TYPE_BINARY_DOUBLE: 0x36,
+  TNS_JSON_TYPE_STRING_LENGTH_UINT16: 0x37,
+  TNS_JSON_TYPE_STRING_LENGTH_UINT32: 0x38,
+  TNS_JSON_TYPE_TIMESTAMP: 0x39,
+  TNS_JSON_TYPE_BINARY_LENGTH_UINT16: 0x3a,
+  TNS_JSON_TYPE_BINARY_LENGTH_UINT32: 0x3b,
+  TNS_JSON_TYPE_DATE: 0x3c,
+  TNS_JSON_TYPE_INTERVAL_YM: 0x3d,
+  TNS_JSON_TYPE_INTERVAL_DS: 0x3e,
+  TNS_JSON_TYPE_TIMESTAMP_TZ: 0x7c,
+  TNS_JSON_TYPE_TIMESTAMP7: 0x7d,
+  TNS_JSON_TYPE_BINARY_FLOAT: 0x7f,
+  TNS_JSON_TYPE_OBJECT: 0x84,
+  TNS_JSON_TYPE_ARRAY: 0xc0,
+  TNS_JSON_TYPE_EXTENDED: 0x7b,
+  TNS_JSON_TYPE_VECTOR: 0x01,
+  TNS_JSON_TYPE_ID: 0x7e,
+
+  // timezone offsets
+  TZ_HOUR_OFFSET: 20,
+  TZ_MINUTE_OFFSET: 60,
+
+  // general constants
+  TNS_MAX_SHORT_LENGTH: 252,
+  TNS_DURATION_MID: 0x80000000,
+  TNS_DURATION_OFFSET: 60,
+  TNS_CHUNK_SIZE: 32767,
+  TNS_HAS_REGION_ID: 0x80,
+  NUMBER_MAX_DIGITS: 40,
+  BUFFER_CHUNK_SIZE: 65536,
+  CSFRM_IMPLICIT: constants.CSFRM_IMPLICIT,
+
+  // vector generic constants
+  VECTOR_FORMAT_FLOAT32: constants.VECTOR_FORMAT_FLOAT32,
+  VECTOR_FORMAT_FLOAT64: constants.VECTOR_FORMAT_FLOAT64,
+  VECTOR_FORMAT_INT8: constants.VECTOR_FORMAT_INT8,
+
+  TNS_NULL_LENGTH_INDICATOR: 255,
+  TNS_LONG_LENGTH_INDICATOR: 254,
+
+};