orcaq 1.0.33 → 1.1.2

package/.output/server/node_modules/oracledb/lib/impl/datahandlers/vector.js

@@ -0,0 +1,197 @@
+// Copyright (c) 2024, 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.
+//
+//-----------------------------------------------------------------------------
+
+'use strict';
+
+const { BaseBuffer, GrowableBuffer } = require('./buffer.js');
+const { Buffer } = require('buffer');
+const constants = require("./constants.js");
+const errors = require("../../errors.js");
+const types = require("../../types.js");
+
+/**
+ * Class used for decoding
+ */
+class VectorDecoder extends BaseBuffer {
+
+  //---------------------------------------------------------------------------
+  // decode()
+  //
+  // Decodes the VECTOR image and returns a JavaScript array corresponding to
+  // its contents.
+  //---------------------------------------------------------------------------
+  decode() {
+
+    // parse header
+    const magicByte = this.readUInt8();
+    if (magicByte != constants.TNS_VECTOR_MAGIC_BYTE)
+      errors.throwErr(errors.ERR_UNEXPECTED_DATA,
+        Buffer.from([magicByte]).toString('hex'));
+    const version = this.readUInt8();
+    if (version > constants.TNS_VECTOR_VERSION_WITH_SPARSE)
+      errors.throwErr(errors.ERR_VECTOR_VERSION_NOT_SUPPORTED, version);
+    const flags = this.readUInt16BE();
+    const vectorFormat = this.readUInt8();
+    let numElements = this.readUInt32BE();
+    let elementSize, value, sparseValue;
+
+    // For binary vector, NORM will never be present but space for NORM is reserved to keep
+    // same header lengh across the different vector formats.
+    if (vectorFormat === constants.VECTOR_FORMAT_BINARY || flags & constants.TNS_VECTOR_FLAG_NORM)
+      this.skipBytes(8);
+
+    let sparseFormat;
+    if (flags & constants.TNS_VECTOR_FLAG_SPARSE) {
+      sparseFormat = true;
+      sparseValue = {};
+      sparseValue.numDimensions = numElements; // vector dimensions.
+      numElements = this.readUInt16BE(); // actual elements.
+      sparseValue.indices = new Uint32Array(numElements);
+      for (let i = 0; i < numElements; i++) {
+        sparseValue.indices[i] = this.readUInt32BE();
+      }
+    }
+
+    if (vectorFormat === constants.VECTOR_FORMAT_FLOAT32) {
+      elementSize = 4;
+      value = new Float32Array(numElements);
+    } else if (vectorFormat === constants.VECTOR_FORMAT_FLOAT64) {
+      elementSize = 8;
+      value = new Float64Array(numElements);
+    } else if (vectorFormat === constants.VECTOR_FORMAT_INT8) {
+      elementSize = 1;
+      value = new Int8Array(numElements);
+    } else if (vectorFormat === constants.VECTOR_FORMAT_BINARY) {
+      elementSize = 1;
+      // The number of dimensions are assumed to be multiple of 8.
+      numElements = numElements / 8;
+      value = new Uint8Array(numElements);
+    } else {
+      errors.throwErr(errors.ERR_VECTOR_FORMAT_NOT_SUPPORTED, vectorFormat);
+    }
+
+    if (sparseFormat) {
+      sparseValue.values = value;
+    }
+
+    // parse data
+    let res;
+    for (let i = 0; i < numElements; i++) {
+      const buf = this.readBytes(elementSize);
+      if (vectorFormat === constants.VECTOR_FORMAT_FLOAT32) {
+        res = this.parseBinaryFloat(buf);
+      } else if (vectorFormat === constants.VECTOR_FORMAT_FLOAT64)  {
+        res = this.parseBinaryDouble(buf);
+      } else {
+        res = buf[0];
+      }
+      value[i] = res;
+    }
+
+    return sparseFormat ? types.SparseVector.create(sparseValue) : value;
+  }
+
+}
+
+class VectorEncoder extends GrowableBuffer {
+
+  // Writes Header from value.
+  // It returns function to serialize the value.
+  // sparseVal is provided for SparseVector.
+  _updateVectorHeader(value, sparseVal) {
+    let flags = constants.TNS_VECTOR_FLAG_NORMSRC
+    | constants.TNS_VECTOR_FLAG_NORM; // NORM is present and reserve space.
+    let numElements = value.length;
+    let vectorVersion = constants.TNS_VECTOR_VERSION_BASE;
+    let vectorFormat = constants.VECTOR_FORMAT_FLOAT32;
+    let writeFn = this.writeBinaryFloat.bind(this);
+
+    if (Array.isArray(value) || value instanceof Float64Array) {
+      vectorFormat = constants.VECTOR_FORMAT_FLOAT64;
+      writeFn = this.writeBinaryDouble.bind(this);
+    } else if (value instanceof Int8Array) {
+      vectorFormat = constants.VECTOR_FORMAT_INT8;
+      writeFn = this.writeSB1.bind(this);
+    } else if (value.constructor.name === 'Uint8Array') {
+      vectorFormat = constants.VECTOR_FORMAT_BINARY;
+      // The number of dimensions are assumed to be multiple of 8.
+      numElements = numElements * 8;
+      vectorVersion = constants.TNS_VECTOR_VERSION_WITH_BINARY;
+      flags = constants.TNS_VECTOR_FLAG_NORMSRC; // only space is reserved.
+      writeFn = this.writeUInt8.bind(this);
+    }
+    if (sparseVal && sparseVal instanceof types.SparseVector) {
+      vectorVersion = constants.TNS_VECTOR_VERSION_WITH_SPARSE;
+      numElements = sparseVal.numDimensions;
+      flags |= constants.TNS_VECTOR_FLAG_SPARSE;
+    }
+
+    // write header
+    this.writeUInt8(constants.TNS_VECTOR_MAGIC_BYTE);
+    this.writeUInt8(vectorVersion);
+    this.writeUInt16BE(flags);
+    this.writeUInt8(vectorFormat);
+    this.writeUInt32BE(numElements);
+    this.reserveBytes(8);
+    return writeFn;
+  }
+
+  //---------------------------------------------------------------------------
+  // encode()
+  //
+  // Encodes the value as OSON and returns a buffer containing the OSON bytes.
+  //---------------------------------------------------------------------------
+  encode(value) {
+    let writeFn;
+
+    if (value instanceof types.SparseVector) {
+      writeFn = this._updateVectorHeader(value.values, value);
+      const numElements = value.indices.length;
+      this.writeUInt16BE(numElements);
+
+      // Write indices
+      value.indices.forEach((element) => {
+        this.writeUInt32BE(element);
+      });
+      value = value.values;
+    } else {
+      writeFn = this._updateVectorHeader(value);
+    }
+
+    // write data
+    value.forEach((element) => {
+      writeFn(element);
+    });
+
+    return this.buf.subarray(0, this.pos);
+  }
+
+}
+
+module.exports = {
+  VectorDecoder,
+  VectorEncoder
+};

package/.output/server/node_modules/oracledb/lib/impl/dbObject.js

@@ -0,0 +1,159 @@
+// Copyright (c) 2022, 2023, 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 errors = require('../errors.js');
+
+// 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
+class DbObjectImpl {
+
+  constructor(objType) {
+    this._objType = objType;
+  }
+
+  //---------------------------------------------------------------------------
+  // append()
+  //
+  // Appends an element to the collection.
+  //---------------------------------------------------------------------------
+  append() {
+    errors.throwNotImplemented("appending element to collection");
+  }
+
+  //---------------------------------------------------------------------------
+  // copy()
+  //
+  // Creates and returns a copy of the object.
+  //---------------------------------------------------------------------------
+  copy() {
+    errors.throwNotImplemented("copying an object");
+  }
+
+  //---------------------------------------------------------------------------
+  // deleteElement()
+  //
+  // Deletes an element from a collection.
+  //---------------------------------------------------------------------------
+  deleteElement() {
+    errors.throwNotImplemented("deleting an element from a collection");
+  }
+
+  //---------------------------------------------------------------------------
+  // getElement()
+  //
+  // Returns an element from the collection.
+  //---------------------------------------------------------------------------
+  getElement() {
+    errors.throwNotImplemented("getting an element from a collection");
+  }
+
+  //---------------------------------------------------------------------------
+  // getFirstIndex()
+  //
+  // Returns the first index in a collection.
+  //---------------------------------------------------------------------------
+  getFirstIndex() {
+    errors.throwNotImplemented("getting the first index in a collection");
+  }
+
+  //---------------------------------------------------------------------------
+  // getKeys()
+  //
+  // Returns the keys of the collection in a JavaScript array.
+  //---------------------------------------------------------------------------
+  getKeys() {
+    errors.throwNotImplemented("returning the keys of a collection");
+  }
+
+  //---------------------------------------------------------------------------
+  // getLastIndex()
+  //
+  // Returns the last index in a collection.
+  //---------------------------------------------------------------------------
+  getLastIndex() {
+    errors.throwNotImplemented("getting the last index in a collection");
+  }
+
+  //---------------------------------------------------------------------------
+  // getNextIndex()
+  //
+  // Returns the next index in a collection.
+  //---------------------------------------------------------------------------
+  getNextIndex() {
+    errors.throwNotImplemented("getting the next index in a collection");
+  }
+
+  //---------------------------------------------------------------------------
+  // getPrevIndex()
+  //
+  // Returns the previous index in a collection.
+  //---------------------------------------------------------------------------
+  getPrevIndex() {
+    errors.throwNotImplemented("getting the previous index in a collection");
+  }
+
+  //---------------------------------------------------------------------------
+  // getValues()
+  //
+  // Returns the values of the collection in a JavaScript array.
+  //---------------------------------------------------------------------------
+  getValues() {
+    errors.throwNotImplemented("getting the values in a collection");
+  }
+
+  //---------------------------------------------------------------------------
+  // hasElement()
+  //
+  // Returns whether an element exists at the given index.
+  //---------------------------------------------------------------------------
+  hasElement() {
+    errors.throwNotImplemented("getting if value exists in a collection");
+  }
+
+  //---------------------------------------------------------------------------
+  // setElement()
+  //
+  // Sets the element at the given index in the collection.
+  //---------------------------------------------------------------------------
+  setElement() {
+    errors.throwNotImplemented("setting an element in a collection");
+  }
+
+  //---------------------------------------------------------------------------
+  // trim()
+  //
+  // Trim the specified number of elements from the end of the collection.
+  //---------------------------------------------------------------------------
+  trim() {
+    errors.throwNotImplemented("trimming elements from a collection");
+  }
+
+}
+
+module.exports = DbObjectImpl;

package/.output/server/node_modules/oracledb/lib/impl/index.js

@@ -0,0 +1,59 @@
+// Copyright (c) 2022, 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 AqDeqOptionsImpl = require('./aqDeqOptions.js');
+const AqEnqOptionsImpl = require('./aqEnqOptions.js');
+const AqMessageImpl = require('./aqMessage.js');
+const AqQueueImpl = require('./aqQueue.js');
+const DbObjectImpl = require('./dbObject.js');
+const ConnectionImpl = require('./connection.js');
+const LobImpl = require('./lob.js');
+const PoolImpl = require('./pool.js');
+const ResultSetImpl = require('./resultset.js');
+const SodaCollectionImpl = require('./sodaCollection.js');
+const SodaDatabaseImpl = require('./sodaDatabase.js');
+const SodaDocCursorImpl = require('./sodaDocCursor.js');
+const SodaDocumentImpl = require('./sodaDocument.js');
+const SodaOperationImpl = require('./sodaOperation.js');
+
+module.exports = {
+  AqDeqOptionsImpl,
+  AqEnqOptionsImpl,
+  AqMessageImpl,
+  AqQueueImpl,
+  DbObjectImpl,
+  ConnectionImpl,
+  LobImpl,
+  PoolImpl,
+  ResultSetImpl,
+  SodaCollectionImpl,
+  SodaDatabaseImpl,
+  SodaDocCursorImpl,
+  SodaDocumentImpl,
+  SodaOperationImpl
+};

package/.output/server/node_modules/oracledb/lib/impl/lob.js

@@ -0,0 +1,113 @@
+// Copyright (c) 2022, 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 ConnectionImpl = require('./connection.js');
+const errors = require('../errors.js');
+const BaseImpl = require('./base.js');
+
+class LobImpl extends BaseImpl {
+
+  //---------------------------------------------------------------------------
+  // _getConnImpl()
+  //
+  // Common method on all classes that make use of a connection -- used to
+  // ensure serialization of all use of the connection.
+  //---------------------------------------------------------------------------
+  _getConnImpl() {
+    let parentObj = this._parentObj;
+    while (!(parentObj instanceof ConnectionImpl))
+      parentObj = parentObj._parentObj;
+    return parentObj;
+  }
+
+  //---------------------------------------------------------------------------
+  // close()
+  //
+  // Close the LOB.
+  //---------------------------------------------------------------------------
+  close() {
+    errors.throwNotImplemented("closing a LOB");
+  }
+
+  //---------------------------------------------------------------------------
+  // fileExists()
+  //
+  // Checks if BFILE present or not.
+  //---------------------------------------------------------------------------
+  fileExists() {
+    errors.throwNotImplemented("check if BFILE exists");
+  }
+
+  //---------------------------------------------------------------------------
+  // getData()
+  //
+  // Returns all of the data in the LOB.
+  //---------------------------------------------------------------------------
+  getData() {
+    errors.throwNotImplemented("getting all of the data from a LOB");
+  }
+
+  //---------------------------------------------------------------------------
+  // getDirFileName()
+  //
+  // returns directory and filename of LOB (BFILE).
+  //----------------------------------------------------------------------------
+  getDirFileName() {
+    errors.throwNotImplemented("getting directory and filename of LOB(BFILE)");
+  }
+
+  //---------------------------------------------------------------------------
+  // read()
+  //
+  // Reads data from the LOB at the specified offset.
+  //---------------------------------------------------------------------------
+  read() {
+    errors.throwNotImplemented("reading from a LOB");
+  }
+
+  //---------------------------------------------------------------------------
+  // setDirFileName()
+  //
+  // sets directory and filename for LOB (BFILE)
+  //---------------------------------------------------------------------------
+  setDirFileName() {
+    errors.throwNotImplemented("setting directory and filename of LOB(BFILE)");
+  }
+
+  //---------------------------------------------------------------------------
+  // write()
+  //
+  // Writes data to the LOB at the specified offset.
+  //---------------------------------------------------------------------------
+  write() {
+    errors.throwNotImplemented("writing to a LOB");
+  }
+
+}
+
+module.exports = LobImpl;