oracledb 5.4.0 → 6.0.0

package/lib/errors.js

@@ -0,0 +1,781 @@
+// 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 util = require('util');
+
+// define error prefix for all messages
+const ERR_PREFIX = "NJS";
+
+// define error number constants (used in JavaScript library)
+const ERR_INVALID_POOL = 2;
+const ERR_INVALID_CONNECTION = 3;
+const ERR_INVALID_PROPERTY_VALUE = 4;
+const ERR_INVALID_PARAMETER_VALUE = 5;
+const ERR_INVALID_PROPERTY_VALUE_IN_PARAM = 7;
+const ERR_INVALID_NUMBER_OF_PARAMETERS = 9;
+const ERR_UNSUPPORTED_DATA_TYPE = 10;
+const ERR_BIND_VALUE_AND_TYPE_MISMATCH = 11;
+const ERR_INVALID_BIND_DATA_TYPE = 12;
+const ERR_INVALID_BIND_DIRECTION = 13;
+const ERR_NO_TYPE_FOR_CONVERSION = 15;
+const ERR_INSUFFICIENT_BUFFER_FOR_BINDS = 16;
+const ERR_BUSY_RS = 17;
+const ERR_INVALID_RS = 18;
+const ERR_NOT_A_QUERY = 19;
+const ERR_INVALID_TYPE_FOR_CONVERSION = 21;
+const ERR_INVALID_LOB = 22;
+const ERR_BUSY_LOB = 23;
+const ERR_INSUFFICIENT_MEMORY = 24;
+const ERR_INVALID_TYPE_FOR_ARRAY_BIND = 34;
+const ERR_REQUIRED_MAX_ARRAY_SIZE = 35;
+const ERR_INVALID_ARRAY_SIZE = 36;
+const ERR_INCOMPATIBLE_TYPE_ARRAY_BIND = 37;
+const ERR_CONN_REQUEST_TIMEOUT = 40;
+const ERR_CANNOT_CONVERT_RS_TO_STREAM = 41;
+const ERR_CANNOT_INVOKE_RS_METHODS = 42;
+const ERR_RS_ALREADY_CONVERTED = 43;
+const ERR_INVALID_BIND_UNIT = 44;
+const ERR_CANNOT_LOAD_BINARY = 45;
+const ERR_POOL_WITH_ALIAS_ALREADY_EXISTS = 46;
+const ERR_POOL_WITH_ALIAS_NOT_FOUND = 47;
+const ERR_INCOMPATIBLE_TYPE_ARRAY_INDEX_BIND = 52;
+const ERR_MIXED_BIND = 55;
+const ERR_MISSING_MAX_SIZE_BY_POS = 56;
+const ERR_MISSING_MAX_SIZE_BY_NAME = 57;
+const ERR_MAX_SIZE_TOO_SMALL = 58;
+const ERR_MISSING_TYPE_BY_POS = 59;
+const ERR_MISSING_TYPE_BY_NAME = 60;
+const ERR_INVALID_SUBSCR = 61;
+const ERR_MISSING_SUBSCR_CALLBACK = 62;
+const ERR_MISSING_SUBSCR_SQL = 63;
+const ERR_POOL_CLOSING = 64;
+const ERR_POOL_CLOSED = 65;
+const ERR_INVALID_SODA_DOC_CURSOR = 66;
+const ERR_NO_BINARY_AVAILABLE = 67;
+const ERR_INVALID_ERR_NUM = 68;
+const ERR_NODE_TOO_OLD = 69;
+const ERR_INVALID_AQ_MESSAGE = 70;
+const ERR_DBL_CONNECT_STRING = 75;
+const ERR_QUEUE_MAX_EXCEEDED = 76;
+const ERR_UNSUPPORTED_DATA_TYPE_IN_JSON = 78;
+const ERR_DBL_USER = 80;
+const ERR_CONCURRENT_OPS = 81;
+const ERR_POOL_RECONFIGURING = 82;
+const ERR_POOL_STATISTICS_DISABLED = 83;
+const ERR_TOKEN_BASED_AUTH = 84;
+const ERR_POOL_TOKEN_BASED_AUTH = 85;
+const ERR_CONN_TOKEN_BASED_AUTH = 86;
+const ERR_TOKEN_HAS_EXPIRED = 87;
+const ERR_NOT_IMPLEMENTED = 89;
+const ERR_INIT_ORACLE_CLIENT_ARGS = 90;
+const ERR_MISSING_FILE = 91;
+const ERR_INVALID_NUMBER_OF_CONNECTIONS = 92;
+const ERR_EXEC_MODE_ONLY_FOR_DML = 95;
+const ERR_INVALID_BIND_NAME = 97;
+const ERR_WRONG_NUMBER_OF_POSITIONAL_BINDS = 98;
+const ERR_BUFFER_LENGTH_INSUFFICIENT = 99;
+const ERR_NCHAR_CS_NOT_SUPPORTED = 100;
+const ERR_MISSING_CREDENTIALS = 101;
+const ERR_UNEXPECTED_END_OF_DATA = 102;
+const ERR_UNEXPECTED_MESSAGE_TYPE = 103;
+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;
+const ERR_INTEGER_TOO_LARGE = 112;
+const ERR_UNEXPECTED_DATA = 113;
+const ERR_OSON_FIELD_NAME_LIMITATION = 114;
+const ERR_ORACLE_NUMBER_NO_REPR = 115;
+const ERR_UNSUPPORTED_VERIFIER_TYPE = 116;
+const ERR_INVALID_PRIVATE_KEY = 117;
+const ERR_THIN_CONNECTION_ALREADY_CREATED = 118;
+const ERR_UNSUPPORTED_CONVERSION = 119;
+const ERR_FETCH_TYPE_HANDLER_RETURN_VALUE = 120;
+const ERR_FETCH_TYPE_HANDLER_TYPE = 121;
+const ERR_FETCH_TYPE_HANDLER_CONVERTER = 122;
+const ERR_CALL_TIMEOUT_EXCEEDED = 123;
+const ERR_EMPTY_CONNECT_STRING = 125;
+const ERR_OSON_VERSION_NOT_SUPPORTED = 126;
+const ERR_UNKOWN_SERVER_SIDE_PIGGYBACK = 127;
+const ERR_UNKNOWN_COLUMN_TYPE_NAME = 128;
+const ERR_INVALID_OBJECT_TYPE_NAME = 129;
+const ERR_TDS_TYPE_NOT_SUPPORTED = 130;
+const ERR_INVALID_COLL_INDEX_SET = 131;
+const ERR_INVALID_COLL_INDEX_GET = 132;
+const ERR_DELETE_ELEMENTS_OF_VARRAY = 133;
+const ERR_WRONG_VALUE_FOR_DBOBJECT_ATTR = 134;
+const ERR_WRONG_VALUE_FOR_DBOBJECT_ELEM = 135;
+const ERR_WRONG_CRED_FOR_EXTAUTH = 136;
+const ERR_MISSING_BIND_VALUE = 137;
+
+// Oracle Net layer errors start from 500
+const ERR_CONNECTION_CLOSED = 500;
+const ERR_CONNECTION_LOSTCONTACT = 501;
+const ERR_CONNECTION_INCOMPLETE = 503;
+const ERR_PROXY_CONNECTION_FAILURE = 504;
+const ERR_TLS_INIT_FAILURE = 505;
+const ERR_TLS_AUTH_FAILURE = 506;
+const ERR_TLS_DNMATCH_FAILURE = 507;
+const ERR_TLS_HOSTMATCH_FAILURE = 508;
+const ERR_INVALID_PACKET = 509;
+const ERR_CONNECTION_TIMEDOUT = 510;
+const ERR_CONNECTION_REFUSED = 511;
+const ERR_INVALID_CONNECT_STRING_PARAMETERS = 512;
+const ERR_CONNECTION_INBAND = 513;
+const ERR_INVALID_CONNECT_STRING_SYNTAX = 514;
+const ERR_INVALID_EZCONNECT_SYNTAX = 515;
+const ERR_NO_CONFIG_DIR = 516;
+const ERR_TNS_ENTRY_NOT_FOUND = 517;
+const ERR_INVALID_SERVICE_NAME = 518;
+const ERR_INVALID_SID = 519;
+const ERR_TNS_NAMES_FILE_MISSING = 520;
+const ERR_CONNECTION_EOF = 521;
+
+// define mapping for ODPI-C errors that need to be wrapped with NJS errors
+const adjustErrorXref = new Map();
+adjustErrorXref.set("DPI-1010", ERR_CONNECTION_CLOSED);
+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);
+adjustErrorXref.set("DPI-1067", [ERR_CALL_TIMEOUT_EXCEEDED, "call timeout of ([0-9]+) ms"]);
+adjustErrorXref.set("DPI-1080", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("OCI-22303", [ERR_INVALID_OBJECT_TYPE_NAME, 'type "([^"]*"."[^"]*)"']);
+adjustErrorXref.set("OCI-22164", ERR_DELETE_ELEMENTS_OF_VARRAY);
+adjustErrorXref.set("OCI-22165", [ERR_INVALID_COLL_INDEX_SET, /index \[([0-9]+)\] must be in the range of \[([0-9]+)\] to \[([0-9]+)\]/]);
+adjustErrorXref.set("ORA-00028", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-00600", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-24338", ERR_INVALID_REF_CURSOR);
+adjustErrorXref.set("ORA-24422", ERR_POOL_HAS_BUSY_CONNECTIONS);
+adjustErrorXref.set("ORA-25708", ERR_TOKEN_HAS_EXPIRED);
+
+// define mapping for error messages
+const messages = new Map();
+messages.set(ERR_INVALID_POOL,                          // NJS-002
+  'invalid pool');
+messages.set(ERR_INVALID_CONNECTION,                    // NJS-003
+  'invalid connection');
+messages.set(ERR_INVALID_PROPERTY_VALUE,                // NJS-004
+  'invalid value for property "%s"');
+messages.set(ERR_INVALID_PARAMETER_VALUE,               // NJS-005
+  'invalid value for parameter %d');
+messages.set(ERR_INVALID_PROPERTY_VALUE_IN_PARAM,       // NJS-007
+  'invalid value for "%s" in parameter %d');
+messages.set(ERR_INVALID_NUMBER_OF_PARAMETERS,          // NJS-009
+  'invalid number of parameters');
+// used in C -- keep synchronized!
+messages.set(ERR_UNSUPPORTED_DATA_TYPE,                 // NJS-010
+  'unsupported data type %d in column %d');
+messages.set(ERR_BIND_VALUE_AND_TYPE_MISMATCH,          // NJS-011
+  'encountered bind value and type mismatch');
+messages.set(ERR_INVALID_BIND_DATA_TYPE,                // NJS-012
+  'encountered invalid bind data type in parameter %d');
+messages.set(ERR_INVALID_BIND_DIRECTION,                // NJS-013
+  'invalid bind direction');
+messages.set(ERR_NO_TYPE_FOR_CONVERSION,                // NJS-015
+  'type was not specified for conversion');
+// used in C -- keep synchronized!
+messages.set(ERR_INSUFFICIENT_BUFFER_FOR_BINDS,         // NJS-016
+  'buffer is too small for OUT binds');
+messages.set(ERR_BUSY_RS,                               // NJS-017
+  'concurrent operations on ResultSet are not allowed');
+messages.set(ERR_INVALID_RS,                            // NJS-018
+  'invalid ResultSet');
+messages.set(ERR_NOT_A_QUERY,                           // NJS-019
+  'ResultSet cannot be returned for non-query statements');
+messages.set(ERR_INVALID_TYPE_FOR_CONVERSION,           // NJS-021
+  'invalid type for conversion specified');
+messages.set(ERR_INVALID_LOB,                           // NJS-022
+  'invalid Lob');
+messages.set(ERR_BUSY_LOB,                              // NJS-023
+  'concurrent operations on a Lob are not allowed');
+// used in C -- keep synchronized!
+messages.set(ERR_INSUFFICIENT_MEMORY,                   // NJS-024
+  'memory allocation failed');
+messages.set(ERR_INVALID_TYPE_FOR_ARRAY_BIND,           // NJS-034
+  'data type is unsupported for array bind');
+messages.set(ERR_REQUIRED_MAX_ARRAY_SIZE,               // NJS-035
+  'maxArraySize is required for IN OUT array bind');
+messages.set(ERR_INVALID_ARRAY_SIZE,                    // NJS-036
+  'length of given array is greater than "maxArraySize"');
+messages.set(ERR_INCOMPATIBLE_TYPE_ARRAY_BIND,          // NJS-037
+  'invalid data type at array index %d for bind ":%s"');
+messages.set(ERR_CONN_REQUEST_TIMEOUT,                  // NJS-040
+  'connection request timeout. Request exceeded "queueTimeout" of %d');
+messages.set(ERR_CANNOT_CONVERT_RS_TO_STREAM,           // NJS-041
+  'cannot convert ResultSet to QueryStream after invoking methods');
+messages.set(ERR_CANNOT_INVOKE_RS_METHODS,              // NJS-042
+  'cannot invoke ResultSet methods after converting to QueryStream');
+messages.set(ERR_RS_ALREADY_CONVERTED,                  // NJS-043
+  'ResultSet already converted to QueryStream');
+messages.set(ERR_INVALID_BIND_UNIT,                     // NJS-044
+  'bind object must contain one of the following attributes: "dir", "type", "maxSize", or "val"');
+messages.set(ERR_CANNOT_LOAD_BINARY,                    // NJS-045
+  'cannot load a node-oracledb Thick mode binary for Node.js. Please try using Thin mode. %s');
+messages.set(ERR_POOL_WITH_ALIAS_ALREADY_EXISTS,        // NJS-046
+  'pool alias "%s" already exists in the connection pool cache');
+messages.set(ERR_POOL_WITH_ALIAS_NOT_FOUND,             // NJS-047
+  'pool alias "%s" not found in connection pool cache');
+messages.set(ERR_INCOMPATIBLE_TYPE_ARRAY_INDEX_BIND,    // NJS-052
+  'invalid data type at array index %d for bind position %d');
+messages.set(ERR_MIXED_BIND,                            // NJS-055
+  'binding by position and name cannot be mixed');
+messages.set(ERR_MISSING_MAX_SIZE_BY_POS,               // NJS-056
+  'maxSize for bind position %d must be specified and be greater than zero');
+messages.set(ERR_MISSING_MAX_SIZE_BY_NAME,              // NJS-057
+  'maxSize for bind "%s" must be specified and greater than zero');
+messages.set(ERR_MAX_SIZE_TOO_SMALL,                    // NJS-058
+  'maxSize of %d is too small for value of length %d in row %d');
+messages.set(ERR_MISSING_TYPE_BY_POS,                   // NJS-059
+  'type must be specified for bind position %d');
+messages.set(ERR_MISSING_TYPE_BY_NAME,                  // NJS-060
+  'type must be specified for bind "%s"');
+messages.set(ERR_INVALID_SUBSCR,                        // NJS-061
+  'invalid subscription');
+messages.set(ERR_MISSING_SUBSCR_CALLBACK,               // NJS-062
+  'subscription notification callback missing');
+messages.set(ERR_MISSING_SUBSCR_SQL,                    // NJS-063
+  'subscription notification SQL missing');
+messages.set(ERR_POOL_CLOSING,                          // NJS-064
+  'connection pool is closing');
+messages.set(ERR_POOL_CLOSED,                           // NJS-065
+  'connection pool was closed');
+messages.set(ERR_INVALID_SODA_DOC_CURSOR,               // NJS-066
+  'invalid SODA document cursor');
+messages.set(ERR_NO_BINARY_AVAILABLE,                   // NJS-067
+  'a pre-built node-oracledb Thick mode binary was not found for %s');
+messages.set(ERR_INVALID_ERR_NUM,                       // NJS-068
+  'invalid error number %d supplied');
+messages.set(ERR_NODE_TOO_OLD,                          // NJS-069
+  'node-oracledb %s requires Node.js %s or later');
+messages.set(ERR_INVALID_AQ_MESSAGE,                    // NJS-070
+  'message must be a string, buffer, database object or an object containing a payload property which itself is a string, buffer or database object');
+messages.set(ERR_DBL_CONNECT_STRING,                    // NJS-075
+  'only one of "connectString" and "connectionString" can be used');
+messages.set(ERR_QUEUE_MAX_EXCEEDED,                    // NJS-076
+  'connection request rejected. Pool queue length "queueMax" %d reached');
+// used in C -- keep synchronized!
+messages.set(ERR_UNSUPPORTED_DATA_TYPE_IN_JSON,         // NJS-078
+  'unsupported data type %d in JSON value');
+messages.set(ERR_DBL_USER,                              // NJS-080
+  'only one of "user" and "username" can be used');
+messages.set(ERR_CONCURRENT_OPS,                        // NJS-081
+  'concurrent operations on a connection are disabled');
+messages.set(ERR_POOL_RECONFIGURING,                    // NJS-082
+  'connection pool is being reconfigured');
+messages.set(ERR_POOL_STATISTICS_DISABLED,              // NJS-083
+  'pool statistics are not enabled');
+messages.set(ERR_TOKEN_BASED_AUTH,                      // NJS-084
+  'invalid access token');
+messages.set(ERR_POOL_TOKEN_BASED_AUTH,                 // NJS-085
+  'invalid connection pool configuration with token-based authentication. The "homogeneous" and "externalAuth" attributes must be set to true');
+messages.set(ERR_CONN_TOKEN_BASED_AUTH,                 // NJS-086
+  'invalid standalone configuration with token-based authentication. The "externalAuth" attribute must be set to true');
+messages.set(ERR_TOKEN_HAS_EXPIRED,                     // NJS-087
+  'access token has expired');
+messages.set(ERR_NOT_IMPLEMENTED,                       // NJS-089
+  '%s is not supported by node-oracledb in Thin mode');
+messages.set(ERR_INIT_ORACLE_CLIENT_ARGS,               // NJS-090
+  'initOracleClient() was already called with different arguments');
+messages.set(ERR_MISSING_FILE,                          // NJS-091
+  'file %s is missing');
+messages.set(ERR_INVALID_NUMBER_OF_CONNECTIONS,         // NJS-092
+  '"poolMax" %d must be greater than or equal to "poolMin" %d');
+messages.set(ERR_EXEC_MODE_ONLY_FOR_DML,                // NJS-095
+  'setting "batchErrors" or "dmlRowCounts" to true is only permitted for DML statements');
+messages.set(ERR_INVALID_BIND_NAME,                     // NJS-097
+  'no bind placeholder named ":%s" was found in the SQL text');
+messages.set(ERR_WRONG_NUMBER_OF_POSITIONAL_BINDS,      // NJS-098
+  '%s positional bind values are required but %s were provided');
+messages.set(ERR_BUFFER_LENGTH_INSUFFICIENT,            // NJS-099
+  'internal error: buffer of length %s insufficient to hold %s bytes');
+messages.set(ERR_NCHAR_CS_NOT_SUPPORTED,                // NJS-100
+  'national character set id %d is not supported by node-oracledb in Thin mode');
+messages.set(ERR_MISSING_CREDENTIALS,                   // NJS-101
+  'no credentials specified');
+messages.set(ERR_UNEXPECTED_END_OF_DATA,                // NJS-102
+  'unexpected end of data: want %d bytes but only %d bytes are available');
+messages.set(ERR_UNEXPECTED_MESSAGE_TYPE,               // NJS-103
+  'unexpected message type %d received');
+messages.set(ERR_POOL_HAS_BUSY_CONNECTIONS,             // NJS-104
+  'connection pool cannot be closed because connections are busy');
+messages.set(ERR_NAN_VALUE,                             // NJS-105
+  'value is not a number (NaN) and cannot be used in Oracle Database numbers');
+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
+  'invalid Oracle type number %d [csfrm: %d]');
+messages.set(ERR_UNEXPECTED_NEGATIVE_INTEGER,           // NJS-111
+  'internal error: read a negative integer when expecting a positive integer');
+messages.set(ERR_INTEGER_TOO_LARGE,                     // NJS-112
+  'internal error: read integer of length %d when expecting integer of no more than length %d');
+messages.set(ERR_UNEXPECTED_DATA,                       // NJS-113
+  'unexpected data received: %s');
+messages.set(ERR_OSON_FIELD_NAME_LIMITATION,            // NJS-114
+  'OSON field names may not exceed 255 UTF-8 encoded bytes');
+messages.set(ERR_ORACLE_NUMBER_NO_REPR,                 // NJS-115
+  'value cannot be represented as an Oracle Database number');
+messages.set(ERR_UNSUPPORTED_VERIFIER_TYPE,             // NJS-116
+  'password verifier type 0x%s is not supported by node-oracledb in Thin mode');
+messages.set(ERR_INVALID_PRIVATE_KEY,                   // NJS-117
+  'invalid private key. Headers and footers are not allowed');
+messages.set(ERR_THIN_CONNECTION_ALREADY_CREATED,       // NJS-118
+  'node-oracledb Thick mode cannot be enabled because a Thin mode connection has already been created');
+messages.set(ERR_UNSUPPORTED_CONVERSION,                // NJS-119
+  'conversion from type %s to type %s is not supported');
+messages.set(ERR_FETCH_TYPE_HANDLER_RETURN_VALUE,       // NJS-120
+  'fetchTypeHandler return value must be an object');
+messages.set(ERR_FETCH_TYPE_HANDLER_TYPE,               // NJS-121
+  'fetchTypeHandler return value attribute "type" must be a valid database type');
+messages.set(ERR_FETCH_TYPE_HANDLER_CONVERTER,          // NJS-122
+  'fetchTypeHandler return value attribute "converter" must be a function');
+messages.set(ERR_CALL_TIMEOUT_EXCEEDED,                 // NJS-123
+  'call timeout of %d ms exceeded');
+messages.set(ERR_EMPTY_CONNECT_STRING,                  // NJS-125
+  '"connectString" cannot be empty or undefined. Bequeath connections are not supported in Thin mode');
+messages.set(ERR_OSON_VERSION_NOT_SUPPORTED,            // NJS-126
+  'OSON version %s is not supported');
+messages.set(ERR_UNKOWN_SERVER_SIDE_PIGGYBACK,          // NJS-127
+  'internal error: unknown server side piggyback opcode %s');
+messages.set(ERR_UNKNOWN_COLUMN_TYPE_NAME,              // NJS-128
+  'internal error: unknown column type name "%s"');
+messages.set(ERR_INVALID_OBJECT_TYPE_NAME,              // NJS-129
+  'invalid object type name: "%s"');
+messages.set(ERR_TDS_TYPE_NOT_SUPPORTED,                // NJS-130
+  'Oracle TDS data type %d is not supported');
+messages.set(ERR_INVALID_COLL_INDEX_SET,                // NJS-131
+  'given index %d must be in the range of %d to %d');
+messages.set(ERR_INVALID_COLL_INDEX_GET,                // NJS-132
+  'element at index %d does not exist');
+messages.set(ERR_DELETE_ELEMENTS_OF_VARRAY,             // NJS-133
+  'cannot delete elements of a VARRAY');
+messages.set(ERR_WRONG_VALUE_FOR_DBOBJECT_ATTR,         // NJS-134
+  'value is of wrong type for attribute %s of object %s');
+messages.set(ERR_WRONG_VALUE_FOR_DBOBJECT_ELEM,         // NJS-135
+  'value is of wrong type for an element of object %s');
+messages.set(ERR_WRONG_CRED_FOR_EXTAUTH,                // NJS-136
+  'user name and password cannot be set when using external authentication');
+messages.set(ERR_MISSING_BIND_VALUE,                    // NJS-137
+  'a bind variable replacement value for placeholder ":%s" was not provided');
+
+// Oracle Net layer errors
+
+messages.set(ERR_CONNECTION_CLOSED,                     // NJS-500
+  'connection to the Oracle Database was broken');
+messages.set(ERR_CONNECTION_LOSTCONTACT,                // NJS-501
+  'connection to host %s port %d terminated unexpectedly. (CONNECTION_ID=%s)\n%s');
+messages.set(ERR_CONNECTION_INCOMPLETE,                 // NJS-503
+  'connection to host %s port %d could not be established. (CONNECTION_ID=%s)\n%s');
+messages.set(ERR_PROXY_CONNECTION_FAILURE,              // NJS-504
+  'connection establishment through a web proxy at host %s port %d failed. (CONNECTION_ID=%s)\n%s');
+messages.set(ERR_TLS_INIT_FAILURE,                      // NJS-505
+  'unable to initiate TLS connection. Please check if wallet credentials are valid');
+messages.set(ERR_TLS_AUTH_FAILURE,                      // NJS-506
+  'connection to host %s port %d encountered TLS handshake failure. (CONNECTION_ID=%s)\n%s');
+messages.set(ERR_TLS_DNMATCH_FAILURE,                   // NJS-507
+  'TLS detected an invalid certificate. Server DN in certificate does not match the specified DN');
+messages.set(ERR_TLS_HOSTMATCH_FAILURE,                 // NJS-508
+  'TLS detected an invalid certificate. %s not present in certificate');
+messages.set(ERR_INVALID_PACKET,                        // NJS-509
+  'internal error: invalid packet type or malformed packet received');
+messages.set(ERR_CONNECTION_TIMEDOUT,                   // NJS-510
+  'connection to host %s port %d timed out. Request exceeded "%s" of %d seconds. (CONNECTION_ID=%s)');
+messages.set(ERR_CONNECTION_REFUSED,                    // NJS-511
+  'connection to listener at host %s port %d was refused. (CONNECTION_ID=%s)\nCause: %s');
+messages.set(ERR_INVALID_CONNECT_STRING_PARAMETERS,     // NJS-512
+  'invalid connection string parameters.\n%s');
+messages.set(ERR_CONNECTION_INBAND,                     // NJS-513
+  'error received through in-band notification: %s');
+messages.set(ERR_INVALID_CONNECT_STRING_SYNTAX,         // NJS-514
+  'syntax error in connection string');
+messages.set(ERR_INVALID_EZCONNECT_SYNTAX,              // NJS-515
+  'error in Easy Connect connection string: %s: %s');
+messages.set(ERR_NO_CONFIG_DIR,                         // NJS-516
+  'no configuration directory set or available to search for tnsnames.ora');
+messages.set(ERR_TNS_ENTRY_NOT_FOUND,                   // NJS-517
+  'cannot connect to Oracle Database. Unable to find "%s" in "%s"');
+messages.set(ERR_INVALID_SERVICE_NAME,                  // NJS-518
+  'cannot connect to Oracle Database. Service "%s" is not registered with the listener at host %s port %s. (CONNECTION_ID=%s)');
+messages.set(ERR_INVALID_SID,                           // NJS-519
+  'cannot connect to Oracle Database. SID "%s" is not registered with the listener at host %s port %s. (CONNECTION_ID=%s)');
+messages.set(ERR_TNS_NAMES_FILE_MISSING,                // NJS-520
+  'cannot connect to Oracle Database. File tnsnames.ora not found in %s');
+messages.set(ERR_CONNECTION_EOF,                        // NJS-521
+  'connection to host %s port %d received end-of-file on communication channel. (CONNECTION_ID=%s)');
+
+//-----------------------------------------------------------------------------
+// assert()
+//
+// Checks the condition, and if the condition is not true, throws an exception
+// using the specified error number and arguments.
+//-----------------------------------------------------------------------------
+function assert(condition) {
+  if (!condition) {
+    const args = Array.prototype.slice.call(arguments, 1);
+    throwErr(...args);
+  }
+}
+
+//-----------------------------------------------------------------------------
+// assertArgCount()
+//
+// Asserts that the argument count falls between the minimum and maximum number
+// of arguments.
+//-----------------------------------------------------------------------------
+function assertArgCount(args, minArgCount, maxArgCount) {
+  assert(args.length >= minArgCount && args.length <= maxArgCount,
+    ERR_INVALID_NUMBER_OF_PARAMETERS);
+}
+
+//-----------------------------------------------------------------------------
+// assertParamPropBool()
+//
+// Asserts that the property value of a parmeter is a boolean value (or
+// undefined).
+//-----------------------------------------------------------------------------
+function assertParamPropBool(obj, parameterNum, propName) {
+  if (obj[propName] !== undefined) {
+    assertParamPropValue(typeof obj[propName] === 'boolean', parameterNum,
+      propName);
+  }
+}
+
+//-----------------------------------------------------------------------------
+// assertParamPropFunction()
+//
+// Asserts that the property value of a parmeter is a function (or undefined).
+//-----------------------------------------------------------------------------
+function assertParamPropFunction(obj, parameterNum, propName) {
+  if (obj[propName] !== undefined) {
+    assertParamPropValue(typeof obj[propName] === 'function', parameterNum,
+      propName);
+  }
+}
+
+//-----------------------------------------------------------------------------
+// assertParamPropInt()
+//
+// Asserts that the property value of a parmeter is an integer value (or
+// undefined).
+//-----------------------------------------------------------------------------
+function assertParamPropInt(obj, parameterNum, propName) {
+  if (obj[propName] !== undefined) {
+    assertParamPropValue(Number.isInteger(obj[propName]), parameterNum,
+      propName);
+  }
+}
+
+//-----------------------------------------------------------------------------
+// assertParamPropUnsignedInt()
+//
+// Asserts that the property value of a parmeter is a positive integer value
+// (or undefined).
+//-----------------------------------------------------------------------------
+function assertParamPropUnsignedInt(obj, parameterNum, propName) {
+  if (obj[propName] !== undefined) {
+    assertParamPropValue(Number.isInteger(obj[propName]) && obj[propName] >= 0,
+      parameterNum, propName);
+  }
+}
+
+//-----------------------------------------------------------------------------
+// assertParamPropString()
+//
+// Asserts that the property value of a parmeter is a function (or undefined).
+//-----------------------------------------------------------------------------
+function assertParamPropString(obj, parameterNum, propName) {
+  if (obj[propName] !== undefined) {
+    assertParamPropValue(typeof obj[propName] === 'string', parameterNum,
+      propName);
+  }
+}
+
+//-----------------------------------------------------------------------------
+// assertParamPropValue()
+//
+// Asserts that the property value of a parmeter passes the specified
+// condition.
+//-----------------------------------------------------------------------------
+function assertParamPropValue(condition, parameterNum, propName) {
+  assert(condition, ERR_INVALID_PROPERTY_VALUE_IN_PARAM, propName,
+    parameterNum);
+}
+
+//-----------------------------------------------------------------------------
+// assertParamValue()
+//
+// Asserts that the parmeter value passes the specified condition.
+//-----------------------------------------------------------------------------
+function assertParamValue(condition, parameterNum) {
+  assert(condition, ERR_INVALID_PARAMETER_VALUE, parameterNum);
+}
+
+//-----------------------------------------------------------------------------
+// assertPropValue()
+//
+// Asserts that the property value passes the specified condition.
+//-----------------------------------------------------------------------------
+function assertPropValue(condition, propName) {
+  assert(condition, ERR_INVALID_PROPERTY_VALUE, propName);
+}
+
+//-----------------------------------------------------------------------------
+// getErr()
+//
+// Returns an error object with the given error number after formatting it with
+// the given arguments.
+//-----------------------------------------------------------------------------
+function getErr(errorNum) {
+  let baseText = messages.get(errorNum);
+  let args = [...arguments];
+  if (!baseText) {
+    args = [undefined, errorNum];
+    errorNum = ERR_INVALID_ERR_NUM;
+    baseText = messages.get(errorNum);
+  }
+  const errorNumStr = errorNum.toString().padStart(3, '0');
+  const code = `${ERR_PREFIX}-${errorNumStr}`;
+  args[0] = `${code}: ${baseText}`;
+  const err = new Error(util.format(...args));
+  err.code = code;
+  Error.captureStackTrace(err, getErr);
+  return err;
+}
+
+//-----------------------------------------------------------------------------
+// throwErr()
+//
+// Throws an error with the given error number after formatting it with the
+// given arguments.
+//-----------------------------------------------------------------------------
+function throwErr() {
+  throw (getErr(...arguments));
+}
+
+//-----------------------------------------------------------------------------
+// throwNotImplemented()
+//
+// Throws an error that the feature is not supported in Thin mode
+//-----------------------------------------------------------------------------
+function throwNotImplemented(feature) {
+  throwErr(ERR_NOT_IMPLEMENTED, feature);
+}
+
+//-----------------------------------------------------------------------------
+// transformErr()
+//
+// Adjusts the supplied error, if necessary, by looking for specific ODPI-C and
+// Oracle errors and replacing them with driver specific errors.
+//-----------------------------------------------------------------------------
+function transformErr(err, fnOpt) {
+  if (!err.code) {
+    const pos = err.message.indexOf(":");
+    if (pos > 0) {
+      err.code = err.message.substr(0, pos);
+      if (adjustErrorXref.has(err.code)) {
+        let args = [];
+        let driverErrorNum;
+        let driverErrorInfo = adjustErrorXref.get(err.code);
+        if (typeof driverErrorInfo === 'number') {
+          driverErrorNum = driverErrorInfo;
+        } else {
+          driverErrorNum = driverErrorInfo[0];
+          const pattern = driverErrorInfo[1];
+          const results = err.message.match(pattern);
+          if (results) {
+            args = results.slice(1);
+          }
+        }
+        const newErr = getErr(driverErrorNum, ...args);
+        err.code = newErr.code;
+        err.message = newErr.message + "\n" + err.message;
+      }
+    }
+  }
+
+  if (err.requiresStackCapture) {
+    delete err.requiresStackCapture;
+    Error.captureStackTrace(err, fnOpt);
+  }
+  return err;
+}
+
+// define exports
+module.exports = {
+  ERR_INVALID_POOL,
+  ERR_INVALID_CONNECTION,
+  ERR_INVALID_PROPERTY_VALUE,
+  ERR_INVALID_PARAMETER_VALUE,
+  ERR_INVALID_PROPERTY_VALUE_IN_PARAM,
+  ERR_INVALID_NUMBER_OF_PARAMETERS,
+  ERR_UNSUPPORTED_DATA_TYPE,
+  ERR_BIND_VALUE_AND_TYPE_MISMATCH,
+  ERR_INVALID_BIND_DATA_TYPE,
+  ERR_INVALID_BIND_DIRECTION,
+  ERR_NO_TYPE_FOR_CONVERSION,
+  ERR_INSUFFICIENT_BUFFER_FOR_BINDS,
+  ERR_BUSY_RS,
+  ERR_INVALID_RS,
+  ERR_NOT_A_QUERY,
+  ERR_INVALID_TYPE_FOR_CONVERSION,
+  ERR_INVALID_LOB,
+  ERR_BUSY_LOB,
+  ERR_INSUFFICIENT_MEMORY,
+  ERR_INVALID_TYPE_FOR_ARRAY_BIND,
+  ERR_REQUIRED_MAX_ARRAY_SIZE,
+  ERR_INVALID_ARRAY_SIZE,
+  ERR_INCOMPATIBLE_TYPE_ARRAY_BIND,
+  ERR_CONN_REQUEST_TIMEOUT,
+  ERR_CANNOT_CONVERT_RS_TO_STREAM,
+  ERR_CANNOT_INVOKE_RS_METHODS,
+  ERR_RS_ALREADY_CONVERTED,
+  ERR_INVALID_BIND_UNIT,
+  ERR_CANNOT_LOAD_BINARY,
+  ERR_POOL_WITH_ALIAS_ALREADY_EXISTS,
+  ERR_POOL_WITH_ALIAS_NOT_FOUND,
+  ERR_INCOMPATIBLE_TYPE_ARRAY_INDEX_BIND,
+  ERR_MIXED_BIND,
+  ERR_MISSING_MAX_SIZE_BY_POS,
+  ERR_MISSING_MAX_SIZE_BY_NAME,
+  ERR_MAX_SIZE_TOO_SMALL,
+  ERR_MISSING_TYPE_BY_POS,
+  ERR_MISSING_TYPE_BY_NAME,
+  ERR_INVALID_SUBSCR,
+  ERR_MISSING_SUBSCR_CALLBACK,
+  ERR_MISSING_SUBSCR_SQL,
+  ERR_POOL_CLOSING,
+  ERR_POOL_CLOSED,
+  ERR_INVALID_SODA_DOC_CURSOR,
+  ERR_NO_BINARY_AVAILABLE,
+  ERR_INVALID_ERR_NUM,
+  ERR_NODE_TOO_OLD,
+  ERR_INVALID_AQ_MESSAGE,
+  ERR_DBL_CONNECT_STRING,
+  ERR_QUEUE_MAX_EXCEEDED,
+  ERR_UNSUPPORTED_DATA_TYPE_IN_JSON,
+  ERR_DBL_USER,
+  ERR_CONCURRENT_OPS,
+  ERR_POOL_RECONFIGURING,
+  ERR_POOL_STATISTICS_DISABLED,
+  ERR_TOKEN_BASED_AUTH,
+  ERR_POOL_TOKEN_BASED_AUTH,
+  ERR_CONN_TOKEN_BASED_AUTH,
+  ERR_TOKEN_HAS_EXPIRED,
+  ERR_NOT_IMPLEMENTED,
+  ERR_INIT_ORACLE_CLIENT_ARGS,
+  ERR_MISSING_FILE,
+  ERR_INVALID_NUMBER_OF_CONNECTIONS,
+  ERR_EXEC_MODE_ONLY_FOR_DML,
+  ERR_CONNECTION_CLOSED,
+  ERR_CONNECTION_LOSTCONTACT,
+  ERR_CONNECTION_INCOMPLETE,
+  ERR_PROXY_CONNECTION_FAILURE,
+  ERR_TLS_INIT_FAILURE,
+  ERR_TLS_AUTH_FAILURE,
+  ERR_TLS_DNMATCH_FAILURE,
+  ERR_TLS_HOSTMATCH_FAILURE,
+  ERR_INVALID_PACKET,
+  ERR_CONNECTION_TIMEDOUT,
+  ERR_CONNECTION_REFUSED,
+  ERR_INVALID_CONNECT_STRING_PARAMETERS,
+  ERR_CONNECTION_INBAND,
+  ERR_INVALID_CONNECT_STRING_SYNTAX,
+  ERR_INVALID_EZCONNECT_SYNTAX,
+  ERR_NO_CONFIG_DIR,
+  ERR_TNS_ENTRY_NOT_FOUND,
+  ERR_CONNECTION_EOF,
+  ERR_INVALID_BIND_NAME,
+  ERR_WRONG_NUMBER_OF_POSITIONAL_BINDS,
+  ERR_BUFFER_LENGTH_INSUFFICIENT,
+  ERR_NCHAR_CS_NOT_SUPPORTED,
+  ERR_MISSING_CREDENTIALS,
+  ERR_UNEXPECTED_END_OF_DATA,
+  ERR_UNEXPECTED_MESSAGE_TYPE,
+  ERR_POOL_HAS_BUSY_CONNECTIONS,
+  ERR_INTERNAL,
+  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,
+  ERR_TNS_NAMES_FILE_MISSING,
+  ERR_INVALID_TYPE_NUM,
+  ERR_INVALID_ORACLE_TYPE_NUM,
+  ERR_UNEXPECTED_NEGATIVE_INTEGER,
+  ERR_INTEGER_TOO_LARGE,
+  ERR_UNEXPECTED_DATA,
+  ERR_OSON_FIELD_NAME_LIMITATION,
+  ERR_OSON_VERSION_NOT_SUPPORTED,
+  ERR_INVALID_PRIVATE_KEY,
+  ERR_THIN_CONNECTION_ALREADY_CREATED,
+  ERR_UNSUPPORTED_CONVERSION,
+  ERR_FETCH_TYPE_HANDLER_RETURN_VALUE,
+  ERR_FETCH_TYPE_HANDLER_TYPE,
+  ERR_FETCH_TYPE_HANDLER_CONVERTER,
+  ERR_CALL_TIMEOUT_EXCEEDED,
+  ERR_EMPTY_CONNECT_STRING,
+  ERR_UNKOWN_SERVER_SIDE_PIGGYBACK,
+  ERR_UNKNOWN_COLUMN_TYPE_NAME,
+  ERR_INVALID_OBJECT_TYPE_NAME,
+  ERR_TDS_TYPE_NOT_SUPPORTED,
+  ERR_INVALID_COLL_INDEX_SET,
+  ERR_INVALID_COLL_INDEX_GET,
+  ERR_DELETE_ELEMENTS_OF_VARRAY,
+  ERR_WRONG_VALUE_FOR_DBOBJECT_ATTR,
+  ERR_WRONG_VALUE_FOR_DBOBJECT_ELEM,
+  ERR_WRONG_CRED_FOR_EXTAUTH,
+  ERR_MISSING_BIND_VALUE,
+  ERR_CONNECTION_CLOSED_CODE: `${ERR_PREFIX}-${ERR_CONNECTION_CLOSED}`,
+  assert,
+  assertArgCount,
+  assertParamPropBool,
+  assertParamPropFunction,
+  assertParamPropInt,
+  assertParamPropString,
+  assertParamPropUnsignedInt,
+  assertParamPropValue,
+  assertParamValue,
+  assertPropValue,
+  getErr,
+  throwErr,
+  throwNotImplemented,
+  transformErr
+};