orcaq 1.0.32 → 1.1.1

package/.output/server/node_modules/oracledb/lib/thin/sqlnet/connStrategy.js

@@ -0,0 +1,316 @@
+// Copyright (c) 2022, 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 { NavAddress, NavAddressList, NavDescription, NavDescriptionList } = require("./navNodes.js");
+const { createNVPair } = require("./nvStrToNvPair.js");
+const errors = require("../../errors.js");
+const constants = require("./constants.js");
+
+/**
+ * Class that holds all possible attributes under Description
+ */
+class ConnectDescription {
+  constructor() {
+    this.cOpts = new Array();
+  }
+
+  addConnectOption(opt) {
+    this.cOpts.push(opt);
+  }
+
+  getConnectOptions() {
+    return this.cOpts;
+  }
+
+}
+
+/**
+ * Class that holds a list of possible connection options.
+ */
+class ConnStrategy {
+  constructor() {
+    this.reset();
+    this.retryCount = 0;
+    this.currentDescription = null;
+    this.descriptionList = new Array();
+    this.sBuf = new Array();
+  }
+
+  reset() {
+    this.nextOptToTry = 0;
+    this.lastRetryCounter = 0;
+    this.lastRetryConnectDescription = 0;
+    this.reorderDescriptionList = 0;
+  }
+
+  hasMoreOptions() {
+    let cOptsSize = 0;
+
+    for (let i = 0; i < this.descriptionList.length; ++i) {
+      cOptsSize += this.descriptionList[i].getConnectOptions().length;
+    }
+    return (this.nextOptToTry < cOptsSize);
+  }
+
+  newConnectionDescription() {
+    this.currentDescription = new ConnectDescription();
+    return this.currentDescription;
+  }
+
+  getcurrentDescription() {
+    return this.currentDescription;
+  }
+
+  closeDescription() {
+    this.descriptionList.push(this.currentDescription);
+    this.currentDescription = null;
+  }
+
+  /**
+  * Execute the Connection Options from the array.  When a refuse packet is received from
+  * server this method is called again and the next connect option is tried.
+  */
+  async execute(config) {
+    /* Check for retryCount in the config if no retryCount exists in the description string */
+    if (config != null) {
+      if (this.retryCount == 0 && config.retryCount > 0) {
+        this.retryCount = config.retryCount;
+      }
+    }
+    if (!this.reorderDescriptionList) {
+      this.descriptionList = SOLE_INST_DHCACHE.reorderDescriptionList(this.descriptionList);
+      this.reorderDescriptionList = true;
+    }
+    /* We try the address list at least once and upto (1 + retryCount) times */
+    for (let d = this.lastRetryConnectDescription; d < this.descriptionList.length; d++) {
+      const desc = this.descriptionList[d];
+      let cOpts = new Array();
+      cOpts = desc.getConnectOptions();
+      let delay = desc.delayInMillis;
+      /* check for retryDelay in config if it doesn't exist in description string */
+      if (config != null) {
+        if ((delay == 0 || delay == undefined) && config.retryDelay > 0) {
+          delay = config.retryDelay * 1000;
+        } else if (!delay) {
+          delay = constants.DEFAULT_RETRY_DELAY; // 1 sec default
+        }
+      }
+      for (let i = this.lastRetryCounter; i <= this.retryCount; ++i) {
+        //Conn options must be reordered only when all options are tried
+        // i.e for retry and before the first try.
+        if (this.nextOptToTry == 0) {
+          cOpts = SOLE_INST_DHCACHE.reorderAddresses(cOpts);
+        }
+        while (this.nextOptToTry < cOpts.length) {
+          const copt = cOpts[this.nextOptToTry];
+          this.lastRetryCounter = i;
+          this.lastRetryConnectDescription = d;
+          this.nextOptToTry++;
+          return copt;
+        }
+        this.nextOptToTry = 0;
+        // if we reached here then we are retrying other descriptor
+        if (delay > 0 && i < this.retryCount) {
+          await sleep(delay);
+        }// end of (delay > 0)
+
+      }// end of for(lastRetryCounter..retryCount)
+      this.lastRetryCounter = 0; // reset after one description is completed
+    }
+    // if we get here, all options were tried and none are valid
+    this.nextOptToTry = 1000;
+    this.lastRetryCounter = 1000;
+    throw new Error("All options tried");
+  }
+  // sleep time expects milliseconds
+
+}
+
+function sleep(time) {
+  return new Promise((resolve) => setTimeout(resolve, time));
+}
+
+
+/**
+ * create different nodes (schemaobject) as per the given input.
+ * @param {string} str - input description string
+ * @returns {object} - returns a connection strategy object.
+ */
+async function createNode(str, userConfig) {
+  let nvpair;
+  if (typeof str === 'string')
+    nvpair = createNVPair(str);
+  else
+    nvpair = str; //Already a NVPair
+
+  const arg = nvpair.name.toUpperCase();
+  let navobj = null;
+  switch (arg) {
+    case "ADDRESS":
+      navobj = new NavAddress();
+      break;
+    case "ADDRESS_LIST":
+      navobj = new NavAddressList();
+      break;
+    case "DESCRIPTION":
+      navobj = new NavDescription();
+      break;
+    case "DESCRIPTION_LIST":
+      navobj = new NavDescriptionList();
+      break;
+    default:
+      errors.throwErr(errors.ERR_INVALID_CONNECT_STRING_PARAMETERS,
+        `unknown top element ${arg}`);
+  }
+  navobj.initFromNVPair(nvpair);
+  const cs = new ConnStrategy();
+  cs.driverName = userConfig.driverName;
+  cs.machine = userConfig.machine;
+  cs.terminal = userConfig.terminal;
+  cs.osUser = userConfig.osUser;
+  cs.program = userConfig.program;
+  cs.httpsProxy = userConfig.httpsProxy;
+  await navobj.navigate(cs);
+  return cs;
+}
+
+
+class DownHostsCache {
+
+  constructor() {
+    // Timeout for each item in the cache
+    this.DOWN_HOSTS_TIMEOUT = 600;
+    // Minimum amount of time between each refresh
+    this.MIN_TIME_BETWEEN_REFRESH = 60;
+    // DownHostsCache Map
+    this.downHostsCacheMap = new Map();
+    // Last Refresh Time
+    this.lastRefreshTime = 0;
+  }
+
+  /**
+   * Add an address to the cache
+   *
+   * @param connOption
+   *            address to be cached
+   * @return Map with address as key and time of insertion as value
+   */
+  markDownHost(addr) {
+    return this.downHostsCacheMap.set(addr, Date.now());
+  }
+
+  // Remove elements older than DownHostsTimeout
+  refreshCache() {
+    if (Date.now() - this.MIN_TIME_BETWEEN_REFRESH * 1000 > this.lastRefreshTime) {
+      this.downHostsCacheMap.forEach((value, key) => {
+        const entryTime = value;
+        if (entryTime != null && ((Date.now() - this.DOWN_HOSTS_TIMEOUT * 1000) > entryTime)) {
+          this.downHostsCacheMap.delete(key);
+        }
+      });
+      this.lastRefreshTime = Date.now();
+    }
+  }
+
+  /**
+   * Reorder addresses such that cached elements
+   * occur at the end of the array.
+   */
+  reorderAddresses(cOpts) {
+    this.refreshCache();
+
+    let topIdx = 0, btmIdx = cOpts.length - 1;
+
+    while (topIdx < btmIdx) {
+
+      // increment topIdx if the address is not cached
+      while (topIdx <= btmIdx
+          && !this.isDownHostsCached(cOpts[topIdx]))
+        topIdx++;
+
+      // decrement btmIdx if address is cached
+      while (btmIdx >= topIdx
+          && this.isDownHostsCached(cOpts[btmIdx]))
+        btmIdx--;
+
+      // swap cached with uncached
+      if (topIdx < btmIdx)
+        [cOpts[topIdx], cOpts[btmIdx]] = [cOpts[btmIdx], cOpts[topIdx]];
+
+    }
+    return cOpts;
+  }
+  /**
+   * Return if a desc is cached.
+   * A desc is cached if all the connection options(addresses)
+   * in that description are cached.
+   */
+  isDownDescCached(desc) {
+    const cOpts = desc.getConnectOptions();
+    for (let i = 0; i < cOpts.length; i++) {
+      if (!this.isDownHostsCached(cOpts[i]))
+        return false;
+    }
+    return true;
+  }
+  /**
+   * Reorder description list such that description with all connection options in downcache
+   * is pushed to the end of the description list
+   */
+  reorderDescriptionList(descs) {
+    this.refreshCache();
+
+    let topIdx = 0, btmIdx = descs.length - 1;
+
+    while (topIdx < btmIdx) {
+
+      // increment topIdx if the desc is not cached
+      while (topIdx <= btmIdx
+          && !this.isDownDescCached(descs[topIdx]))
+        topIdx++;
+
+      // decrement btmIdx if desc is cached
+      while (btmIdx >= topIdx
+          && this.isDownDescCached(descs[btmIdx]))
+        btmIdx--;
+
+      // swap cached with uncached
+      if (topIdx < btmIdx) {
+        [descs[topIdx], descs[btmIdx]] = [descs[btmIdx], descs[topIdx]];
+      }
+    }
+    return descs;
+  }
+  // Return if a host is cached
+  isDownHostsCached(copt) {
+    return this.downHostsCacheMap.has(copt.host);
+  }
+}
+// Single instance
+const SOLE_INST_DHCACHE = new DownHostsCache();
+module.exports = { createNode, SOLE_INST_DHCACHE };

package/.output/server/node_modules/oracledb/lib/thin/sqlnet/constants.js

@@ -0,0 +1,210 @@
+// Copyright (c) 2022, 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.
+//
+//-----------------------------------------------------------------------------
+
+
+module.exports =  {
+  // TNS packet types
+  NSPTCN: 1,          // Connect
+  NSPTAC: 2,          // Accept
+  NSPTAK: 3,          // Acknowledge
+  NSPTRF: 4,          // Refuse
+  NSPTRD: 5,          // Redirect
+  NSPTDA: 6,          // Data
+  NSPTNL: 7,          // Null
+  NSPTAB: 9,          // Abort
+  NSPTRS: 11,         // Re-send
+  NSPTMK: 12,         // Marker
+  NSPTAT: 13,         // Attention
+  NSPTCNL: 14,        // Control information
+  NSPTDD: 15,         // data descriptor
+  NSPTHI: 19,         // Highest legal packet type
+
+  // Packet Header
+  NSPHDLEN: 0,       // Packet length
+  NSPHDPSM: 2,       // Packet checksum(deprecated in version 3.15 with large sdu support)
+  NSPHDTYP: 4,       // Packet type
+  NSPHDFLGS: 5,      // Packet flags
+  NSPHDHSM: 6,       // Header checksum
+  NSPSIZHD: 8,       // Packet header size
+
+  /* Packet flags for NSPHDFLGS */
+  NSPFSID: 0x01,     // SID is given
+  NSPFRDS: 0x02,     // ReDirect Separation of cnda vs cndo
+  NSPFRDR: 0x04,     // ReDiRected client Connect (NSPTCN)
+  NSPFLSD: 0x20,     // packet with large sdu field
+  NO_HEADER_FLAGS: 0,
+  NSPFSRN: 0x08,
+
+  // Connect Packet
+  NSPCNVSN: 8,    // My version number
+  NSPCNLOV: 10,   // Lowest version number I can be compatible with
+  NSPCNOPT: 12,   // Global service options
+  NSPCNSDU: 14,   // My SDU size
+  NSPCNTDU: 16,   // Maximum TDU size
+  NSPCNNTC: 18,   // NT characterstics
+  NSPCNTNA: 20,   // Line turnaround value
+  NSPCNONE: 22,   // The value '1' in my hardware byte order
+  NSPCNLEN: 24,   // Length of connect data
+  NSPCNOFF: 26,   // Offset to connect data
+  NSPCNMXC: 28,   // Maximum connect data you can send me
+  NSPCNFL0: 32,   // Connect flags
+  NSPCNFL1: 33,
+  NSPCNTMO: 50,   // local connection timeout val
+  NSPCNTCK: 52,   // local tick size
+  NSPCNADL: 54,
+  NSPCNAOF: 56,   // offset to reconnect tns addr
+  NSPCNLSD: 58,   // large sdu
+  NSPCNLTD: 62,   // large tdu
+  NSPCNCFL: 66,   // compression data
+  NSPCNCFL2: 70,  // connect flag2
+  //  NSPCNV310DAT : (NSPCNTMO + 8), start of connect data, V3.10   packet
+  //  NSPCNV315DAT : (NSPCNCFL + 4),
+  NSPCNDAT: 74,      // Start connect data
+  NSPMXCDATA: 230,   // Maximum length of connect data
+  // Connect flags (Used mostly by NA)
+  NSINAWANTED: 0x01, // Want to use NA
+  NSINAINTCHG: 0x02, // Interchange involved
+  NSINADISABLEDFORCONNECTION: 0x04, // Disable NA
+  NSINANOSERVICES: 0x08, // No NA services linked
+  NSINAREQUIRED: 0x10,   // NA is required
+  NSINAAUTHWANTED: 0x20, // Authentication linked
+  NSISUPSECRENEG: 0x80,  // bkwrd comp: SUPport SECurity RE-NEG
+  // Connect options
+  NSGDONTCARE: 0x0001, // "don't care"
+  NSGHDX: 0x0002, // half-duplex (w/ token management)
+  NSGFDX: 0x0004, // full-duplex
+  NSGHDRCHKSUM: 0x0008, // checksum on packet header
+  NSGPAKCHKSUM: 0x0010, // checksum on entire packet
+  NSGBROKEN: 0x0020, // provide broken connection notification
+  NSGUSEVIO: 0x0040, // can use Vectored I/O
+  NSGOSAUTHOK: 0x0080, // use OS authentication
+  NSGSENDATTN: 0x0200, // can send attention
+  NSGRECVATTN: 0x0400, // can recv attention
+  NSGNOATTNPR: 0x0800, // no attention processing
+  NSGRAW: 0x1000, // I/O is direct to/from transport
+  TNS_VERSION_DESIRED: 319,
+  TNS_VERSION_MINIMUM: 300,
+  TNS_VERSION_MIN_DATA_FLAGS: 318,
+  TNS_VERSION_MIN_END_OF_RESPONSE: 319,
+  TNS_UUID_OFFSET: 45,
+
+  /* Accept Packet */
+  NSPACVSN: 8,   // connection version
+  NSPACOPT: 10,  // global service options
+  NSPACSDU: 12,  // SDU size
+  NSPACTDU: 14,  // Maximum TDU
+  NSPACONE: 16,  // The value '1' in my hardware byte order
+  NSPACLEN: 18,  // connect data length
+  NSPACOFF: 20,  // offset to connect data
+  NSPACFL0: 22,  // connect flags
+  NSPACFL1: 23,
+  NSPACTMO: 24,  // connection pool timeout value
+  NSPACTCK: 26,  // local tick size
+  NSPACADL: 28,  // reconnect tns address length
+  NSPACAOF: 30,  // offset to reconnect tns addr
+  NSPACLSD: 32,  // Large sdu
+  NSPACLTD: 36,  // Large tdu
+  NSPACCFL: 40,  // compression flag
+  NSPACFL2: 41,  // accept flag2 (4 bytes)
+  NSPACV310DAT: 32, /* start of accept data, V3.10     packet */
+  NSPACV315DAT: 41, // start of accept data, V3.15     packet
+
+  /* Refuse Packet */
+  NSPRFURS: 8,  // User (appliction) reason for refusal
+  NSPRFSRS: 9,  // System (NS) reason for
+  NSPRFLEN: 10, // Length of refuse data
+  NSPRFDAT: 12, // Start of connect data
+  // Compression flags
+  NSPACCFON: 0x80, // 1st MSB:  compression on/off
+  NSPACCFAT: 0x40, // 2nd MSB :   compression auto
+  NSPACCFNT: 0x02, // Second last LSB : compression for non-tcp protocol
+  // Accept flag2
+  NSPACOOB: 0x00000001, // OOB support check at connection time
+  NSGPCHKSCMD: 0x01000000, // Support for Poll and Check logic
+  TNS_ACCEPT_FLAG_HAS_END_OF_REQUEST: 0x02000000,
+  TNS_ACCEPT_FLAG_FAST_AUTH: 0x10000000, // Support Fast Auth
+
+  /* Redirect packet */
+  NSPRDLEN: 8,   // Length of redirect data
+  NSPRDDAT: 10,  // Start of connect data
+
+  /* Data Packet */
+  NSPDAFLG: 8,    // Data flags
+  NSPDADAT: 10,   // Start of Data
+  NSPDAFEOF: 0x40, // "end of file"
+  NSPDAFCMP: 0x400,  // "compressed data"
+
+  /* Marker Packet */
+  NSPMKTYP: 8,     // marker type (see below)
+  NSPMKODT: 9,     // old (pre-V3.05) data byte
+  NSPMKDAT: 10,    // data byte
+  NSPMKTD0: 0,     // data marker - 0 data bytes
+  NSPMKTD1: 1,     // data marker - 1 data byte
+  NSPMKTAT: 2,     // Attention Marker
+  NIQBMARK: 1,     // Break marker
+  NIQRMARK: 2,     // Reset marker
+  NIQIMARK: 3,     // Interrupt marker
+
+  /* Control Packet */
+  NSPCTLCMD: 8,  // Control Command length is 2 bytes
+  NSPCTLDAT: 10, // Control Data length is specific to the Command type.
+  NSPCTL_SERR: 8,  // Error Control Command Type
+  NSPCTL_CLRATTN: 9,  // Clear OOB option
+
+  /* OPTIONS */
+  NSPDFSDULN: 8192,    // default SDU size
+  NSPABSSDULN: 2097152, // maximim SDU size
+  NSPMXSDULN: 65535,   // maximim SDU size
+  NSPMNSDULN: 512,     // minimum SDU size
+  NSPDFTDULN: 2097152, // default TDU size
+  NSPMXTDULN: 2097152, // maximum TDU size
+  NSPMNTDULN: 255,     // minimum TDU size
+  NSFIMM: 0x0040,  // immediate close
+
+  /* PARAMETERS */
+  DISABLE_OOB_STR: 'DISABLE_OOB', // disable OOB parameter
+  EXPIRE_TIME: 'EXPIRE_TIME', // expire Time
+  PEM_WALLET_FILE_NAME: 'ewallet.pem',
+  DEFAULT_TRANSPORT_CONNECT_TIMEOUT: 20000, //default transport connect timeout
+  DEFAULT_RETRY_DELAY: 1000, //default retry delay
+
+  /* Get/Set options */
+  NT_MOREDATA: 1, // More Data in Transport available
+  NS_MOREDATA: 2, // More Data available to be read
+  SVCNAME: 3, // Service name
+  SERVERTYPE: 4, // Server type
+  REMOTEADDR: 5, // Remote Address
+  HEALTHCHECK: 6, // Health check of connection
+  CONNCLASS: 7, // Connection Class
+  PURITY: 8, // Purity
+  SID: 9, // SID
+
+  /* Network Compression Algorithms */
+  NETWORK_COMPRESSION_ZLIB: 2,
+
+  /* FLAGS */
+  NSNOBLOCK: 0x0001, // Do not block
+};