oracledb 6.9.0 → 7.0.0

package/lib/dbObject.js

@@ -79,6 +79,18 @@ function validatePropertyValue(objType, metaData, value, index) {
 // instantiated; a cache of these classes are maintained on each connection
 class BaseDbObject {
 
+  //---------------------------------------------------------------------------
+  // _ensureCollection()
+  //
+  // Ensures that the object is a collection.
+  //---------------------------------------------------------------------------
+  _ensureCollection() {
+    if (!this.isCollection) {
+      errors.throwErr(errors.ERR_OBJECT_IS_NOT_A_COLLECTION,
+        this.name);
+    }
+  }
+
   //---------------------------------------------------------------------------
   // _getAttrValue()
   //
@@ -165,6 +177,7 @@ class BaseDbObject {
   //---------------------------------------------------------------------------
   append(value) {
     errors.assertArgCount(arguments, 1, 1);
+    this._ensureCollection();
     const info = {
       fqn: this._objType.fqn,
       type: this._objType.elementType,
@@ -238,6 +251,7 @@ class BaseDbObject {
   //---------------------------------------------------------------------------
   deleteElement(index) {
     errors.assertArgCount(arguments, 1, 1);
+    this._ensureCollection();
     errors.assertParamValue(Number.isInteger(index), 1);
     return this._impl.deleteElement(index);
   }
@@ -300,6 +314,7 @@ class BaseDbObject {
   //---------------------------------------------------------------------------
   getElement(index) {
     errors.assertArgCount(arguments, 1, 1);
+    this._ensureCollection();
     errors.assertParamValue(Number.isInteger(index), 1);
     const value = this._impl.getElement(index);
     return this._transformValueOut(value, this.elementTypeClass, this._objType.elementTypeInfo);
@@ -312,6 +327,7 @@ class BaseDbObject {
   //---------------------------------------------------------------------------
   getKeys() {
     errors.assertArgCount(arguments, 0, 0);
+    this._ensureCollection();
     return this._impl.getKeys();
   }
 
@@ -322,6 +338,7 @@ class BaseDbObject {
   //---------------------------------------------------------------------------
   getFirstIndex() {
     errors.assertArgCount(arguments, 0, 0);
+    this._ensureCollection();
     return this._impl.getFirstIndex();
   }
 
@@ -332,6 +349,7 @@ class BaseDbObject {
   //---------------------------------------------------------------------------
   getLastIndex() {
     errors.assertArgCount(arguments, 0, 0);
+    this._ensureCollection();
     return this._impl.getLastIndex();
   }
 
@@ -342,6 +360,7 @@ class BaseDbObject {
   //---------------------------------------------------------------------------
   getNextIndex(index) {
     errors.assertArgCount(arguments, 1, 1);
+    this._ensureCollection();
     errors.assertParamValue(Number.isInteger(index), 1);
     return this._impl.getNextIndex(index);
   }
@@ -353,6 +372,7 @@ class BaseDbObject {
   //---------------------------------------------------------------------------
   getPrevIndex(index) {
     errors.assertArgCount(arguments, 1, 1);
+    this._ensureCollection();
     errors.assertParamValue(Number.isInteger(index), 1);
     return this._impl.getPrevIndex(index);
   }
@@ -364,6 +384,7 @@ class BaseDbObject {
   //---------------------------------------------------------------------------
   getValues() {
     errors.assertArgCount(arguments, 0, 0);
+    this._ensureCollection();
     const values = this._impl.getValues();
     for (let i = 0; i < values.length; i++) {
       values[i] = this._transformValueOut(values[i], this.elementTypeClass, this._objType.elementTypeInfo);
@@ -378,6 +399,7 @@ class BaseDbObject {
   //---------------------------------------------------------------------------
   hasElement(index) {
     errors.assertArgCount(arguments, 1, 1);
+    this._ensureCollection();
     errors.assertParamValue(Number.isInteger(index), 1);
     return this._impl.hasElement(index);
   }
@@ -426,6 +448,7 @@ class BaseDbObject {
   //---------------------------------------------------------------------------
   setElement(index, value) {
     errors.assertArgCount(arguments, 2, 2);
+    this._ensureCollection();
     errors.assertParamValue(Number.isInteger(index), 1);
     const info = {
       fqn: this._objType.fqn,
@@ -445,6 +468,7 @@ class BaseDbObject {
   //---------------------------------------------------------------------------
   trim(numToTrim) {
     errors.assertArgCount(arguments, 1, 1);
+    this._ensureCollection();
     errors.assertParamValue(Number.isInteger(numToTrim) && numToTrim >= 0, 1);
     this._impl.trim(numToTrim);
   }
@@ -487,10 +511,7 @@ class BaseDbObject {
   //---------------------------------------------------------------------------
   toMap() {
     errors.assertArgCount(arguments, 0, 0);
-    if (!this.isCollection) {
-      errors.throwErr(errors.ERR_OBJECT_IS_NOT_A_COLLECTION,
-        this.name);
-    }
+    this._ensureCollection();
     const result = new Map();
     this.getKeys().forEach(element => {
       result.set(element, this.getElement(element));

package/lib/endUserSecurityContext.js

@@ -0,0 +1,176 @@
+// Copyright (c) 2026, 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 { Buffer } = require('buffer');
+const errors = require('./errors.js');
+const oson = require('./impl/datahandlers/oson.js');
+const { ObfuscatedValue } = require('./obfuscation.js');
+const transformer = require('./transformer.js');
+
+const DEFAULT_MAX_FIELD_NAME_SIZE = 65535;
+const DEFAULT_MAX_PAYLOAD_LENGTH = 65535;
+
+function hasNonEmptyText(value) {
+  return (typeof value === 'string') && value.trim().length > 0;
+}
+
+/*
+Represents the credential set an application associates with an end user.
+
+Required properties
+- databaseAccessToken: non-empty string accepted by the database driver.
+- endUserToken or endUserName: at least one must be supplied as a string.
+- key: required whenever endUserName is supplied; otherwise optional.
+
+Optional properties
+- key: look-up identifier the database maps to stored context attributes; may be
+  omitted only when identifying users via endUserToken.
+- dataRoles: data roles enabled/disabled by the application logic, rather
+  than a database security policy.
+- attributes: Attributes are contained in JSON objects conforming
+  to a JSON schema of an END USER CONTEXT declared in the database.
+
+*/
+class EndUserSecurityContext {
+  constructor(options) {
+    errors.assertArgCount(arguments, 1, 1);
+    errors.assertParamValue(
+      typeof options === 'object' && options !== null && !Array.isArray(options),
+      1
+    );
+
+    const {
+      databaseAccessToken,
+      endUserToken,
+      endUserName,
+      key,
+      dataRoles,
+      attributes
+    } = options;
+
+    // The database access token is always required, and the end user must be
+    // identified either by token or by name.
+    errors.assertParamValue(hasNonEmptyText(databaseAccessToken), 1);
+    errors.assertParamValue(
+      (endUserToken !== undefined && endUserToken !== null) ||
+      (endUserName !== undefined && endUserName !== null),
+      1
+    );
+
+    // When supplied, token/name/key values must contain non-whitespace text.
+    if (endUserToken !== undefined && endUserToken !== null) {
+      errors.assertParamValue(hasNonEmptyText(endUserToken), 1);
+    }
+
+    // Name-based contexts require a key so the database can locate the stored
+    // end user context attributes.
+    if (endUserName !== undefined && endUserName !== null) {
+      errors.assertParamValue(hasNonEmptyText(endUserName), 1);
+      errors.assertParamValue(key !== undefined && key !== null, 1);
+    }
+
+    if (key !== undefined && key !== null) {
+      errors.assertParamValue(hasNonEmptyText(key), 1);
+    }
+
+    const payload = {
+      ver: '1.0',
+      database_access_token: databaseAccessToken
+    };
+
+    if (endUserToken != null) {
+      payload.end_user_token = endUserToken;
+    }
+
+    if (endUserName != null) {
+      payload.end_user_name = endUserName;
+    }
+
+    if (key != null) {
+      payload.end_user_contextid = key;
+    }
+
+    // Data roles are optional, but must be passed as an array when present.
+    if (dataRoles != null) {
+      errors.assertParamValue(Array.isArray(dataRoles), 1);
+      payload.data_roles = Array.from(dataRoles);
+    }
+
+    // Attributes are encoded as name/value entries expected by the OSON payload.
+    if (attributes != null) {
+      errors.assertParamValue(
+        typeof attributes === 'object' && !Array.isArray(attributes),
+        1
+      );
+      payload.attributes = Object.entries(attributes).map(
+        ([name, values]) => ({ name, values }));
+    }
+
+    this._payloadStore = new ObfuscatedValue();
+    this._encodeAndStorePayload(payload);
+  }
+
+  _encodePayload(value) {
+    const encoder = new oson.OsonEncoder();
+    return encoder.encode(
+      transformer.transformJsonValue(value),
+      DEFAULT_MAX_FIELD_NAME_SIZE
+    );
+  }
+
+  _encodeAndStorePayload(payload) {
+    const encodedPayload =
+      this._encodePayload(payload);
+    this.setEncodedPayload(encodedPayload);
+  }
+
+  setEncodedPayload(encodedPayload) {
+    errors.assertParamValue(Buffer.isBuffer(encodedPayload), 1);
+    const payloadLength = encodedPayload.length;
+    if (payloadLength > DEFAULT_MAX_PAYLOAD_LENGTH) {
+      encodedPayload.fill(0);
+      errors.throwErr(
+        errors.ERR_INVALID_END_USER_SECURITY_CONTEXT_LENGTH,
+        payloadLength
+      );
+    }
+    this.clearEncodedPayload();
+    this._payloadStore.set(encodedPayload, { returnBuffer: true });
+    encodedPayload.fill(0);
+  }
+
+  getDeobfuscatedValue() {
+    return this._payloadStore.get({ returnBuffer: true });
+  }
+
+  clearEncodedPayload() {
+    this._payloadStore.clear();
+  }
+}
+
+module.exports = EndUserSecurityContext;

package/lib/errors.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2022, 2025, Oracle and/or its affiliates.
+// Copyright (c) 2022, 2026, Oracle and/or its affiliates.
 //-----------------------------------------------------------------------------
 //
 // This software is dual-licensed to you under the Universal Permissive License
@@ -178,6 +178,26 @@ const ERR_CALLOUT_FN = 169;
 const ERR_SESSIONLESS_DIFFERING_METHODS = 170;
 const ERR_SESSIONLESS_ALREADY_ACTIVE = 171;
 const ERR_SESSIONLESS_INACTIVE = 172;
+const ERR_INVALID_SERVER_RESPONSE = 173;
+const ERR_PAYLOAD_CANNOT_BE_ENQUEUED = 174;
+const ERR_NULLS_NOT_ALLOWED = 175;
+const ERR_DPL_TOO_MUCH_DATA = 176;
+const ERR_DPL_INVALID_ROW_DATA = 177;
+const ERR_PIPELINE_OPERATION_NOT_SUPPORTED = 178;
+const ERR_PIPELINE_MISMATCHED_TOKEN = 179;
+const ERR_PIPELINE_DBOBJECTS_NOT_SUPPORTED = 180;
+const ERR_PIPELINE_LARGE_BUFFERS_NOT_SUPPORTED = 181;
+const ERR_PIPELINE_EXEC_OPTION_NOT_SUPPORTED = 182;
+const ERR_INVALID_SQL_NAME = 183;
+const ERR_APP_CONTEXT_EMPTY_NAMESPACE = 184;
+const ERR_APP_CONTEXT_INVALID_KEY_VALUE = 185;
+const ERR_APP_CONTEXT_KEY_TOO_LONG = 186;
+const ERR_APP_CONTEXT_VALUE_TOO_LONG = 187;
+const ERR_UNSUPPORTED_KEY_LENGTH = 188;
+const ERR_INVALID_END_USER_SECURITY_CONTEXT_LENGTH = 189;
+const ERR_END_USER_SECURITY_CONTEXT_REQUIRES_TCPS = 190;
+const ERR_UNSUPPORTED_DEEP_DATA_SECURITY_FEATURE = 191;
+const ERR_CHAR_CS_NOT_SUPPORTED = 192;
 
 // Oracle Net layer errors start from 500
 const ERR_CONNECTION_CLOSED = 500;
@@ -201,6 +221,7 @@ const ERR_INVALID_SERVICE_NAME = 518;
 const ERR_INVALID_SID = 519;
 const ERR_TNS_NAMES_FILE_MISSING = 520;
 const ERR_CONNECTION_EOF = 521;
+const ERR_CONNECT_DESCRIPTOR_LIMIT_EXCEEDED = 522;
 const ERR_CONFIG_PROVIDER_FAILED_TO_RETRIEVE_CONFIG = 523;
 const ERR_REGISTER_HOOKFN_CONFIGPROVIDER = 524;
 const ERR_WALLET_TYPE_NOT_SUPPORTED = 529;
@@ -210,6 +231,7 @@ const ERR_ANO_STATUS = 532;
 const ERR_ANO_NEGOTIATION = 533;
 const ERR_DATA_COMPRESSION = 534;
 const ERR_CONFIG_PROVIDER_PARAM_TYPE = 535;
+const ERR_TOO_MANY_REDIRECTS = 536;
 
 // Oracle SUCCESS_WITH_INFO warning start from 700
 const WRN_COMPILATION_CREATE = 700;
@@ -254,12 +276,14 @@ adjustErrorXref.set("ORA-12583", ERR_CONNECTION_CLOSED);
 adjustErrorXref.set("ORA-27146", ERR_CONNECTION_CLOSED);
 adjustErrorXref.set("ORA-28511", ERR_CONNECTION_CLOSED);
 adjustErrorXref.set("ORA-56600", ERR_CONNECTION_CLOSED);
+adjustErrorXref.set("ORA-24315", ERR_APP_CONTEXT_EMPTY_NAMESPACE);
 adjustErrorXref.set("ORA-24338", ERR_INVALID_REF_CURSOR);
 adjustErrorXref.set("ORA-25708", ERR_TOKEN_HAS_EXPIRED);
 adjustErrorXref.set("ORA-24344", WRN_COMPILATION_CREATE);
 adjustErrorXref.set("ORA-26202", ERR_SESSIONLESS_INACTIVE);
 adjustErrorXref.set("ORA-26211", ERR_SESSIONLESS_DIFFERING_METHODS);
 adjustErrorXref.set("ORA-26216", ERR_SESSIONLESS_ALREADY_ACTIVE);
+adjustErrorXref.set("DPI-1071", ERR_PAYLOAD_CANNOT_BE_ENQUEUED);
 
 // define mapping for error messages
 const messages = new Map();
@@ -386,7 +410,7 @@ messages.set(ERR_CONN_TOKEN_BASED_AUTH,                 // NJS-086
 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');
+  '%s is not supported by node-oracledb in %s mode');
 messages.set(ERR_INIT_ORACLE_CLIENT_ARGS,               // NJS-090
   'initOracleClient() was already called with different arguments');
 messages.set(ERR_MISSING_FILE,                          // NJS-091
@@ -398,9 +422,9 @@ messages.set(ERR_EXEC_MODE_ONLY_FOR_DML,                // NJS-095
 messages.set(ERR_INVALID_BIND_NAME,                     // NJS-097
   'no bind placeholder named ":%s" was found in the statement text');
 messages.set(ERR_WRONG_NUMBER_OF_BINDS,                 // NJS-098
-  '%s bind placeholders were used in the SQL statement but %s bind values were provided');
+  '%d bind placeholders were used in the SQL statement but %d bind values were provided');
 messages.set(ERR_BUFFER_LENGTH_INSUFFICIENT,            // NJS-099
-  'internal error: buffer of length %s insufficient to hold %s bytes');
+  'internal error: buffer of length %d insufficient to hold %d 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
@@ -539,6 +563,46 @@ messages.set(ERR_SESSIONLESS_ALREADY_ACTIVE,            //NJS-171
   'Suspend, commit or rollback the currently active sessionless transaction before beginning or resuming another one.');
 messages.set(ERR_SESSIONLESS_INACTIVE,                  //NJS-172
   'No sessionless transaction is active');
+messages.set(ERR_INVALID_SERVER_RESPONSE,               //NJS-173
+  'Invalid server response to connection request');
+messages.set(ERR_PAYLOAD_CANNOT_BE_ENQUEUED,            // NJS-174
+  "Payload cannot be enqueued since it does not match the payload type supported by the queue");
+messages.set(ERR_NULLS_NOT_ALLOWED,                     // NJS-175
+  'Value for column %s may not be null on row %d');
+messages.set(ERR_DPL_TOO_MUCH_DATA,                     // NJS-176
+  'The maximum size of a Direct Path load has been exceeded');
+messages.set(ERR_DPL_INVALID_ROW_DATA,                  // NJS-177
+  'The row data provided for Direct Path load is Invalid. Expected a 2D array (Array of Arrays) representing rows and columns.');
+messages.set(ERR_PIPELINE_OPERATION_NOT_SUPPORTED,      // NJS-178
+  'Unsupported pipeline operation type: %s');
+messages.set(ERR_PIPELINE_MISMATCHED_TOKEN,             // NJS-179
+  'Pipeline internal error: token number %d does not match expected token number %d');
+messages.set(ERR_PIPELINE_DBOBJECTS_NOT_SUPPORTED,      // NJS-180
+  'Oracle Database Object types are not supported in pipeline mode');
+messages.set(ERR_PIPELINE_LARGE_BUFFERS_NOT_SUPPORTED,  // NJS-181
+  'PL/SQL blocks with string/bytes object size greater than 32k are not supported in pipeline mode');
+messages.set(ERR_PIPELINE_EXEC_OPTION_NOT_SUPPORTED,    // NJS-182
+  `Execute option '%s' is not supported in pipeline mode`);
+messages.set(ERR_INVALID_SQL_NAME,                     // NJS-183
+  'invalid SQL name: embedded double quotes are not allowed');
+messages.set(ERR_APP_CONTEXT_EMPTY_NAMESPACE,           // NJS-184
+  'The namespace can not be empty for Application Context');
+messages.set(ERR_APP_CONTEXT_INVALID_KEY_VALUE,         // NJS-185
+  'Invalid Application Context entry: both key and value must be strings. Got key=%s, value=%s');
+messages.set(ERR_APP_CONTEXT_KEY_TOO_LONG,              // NJS-186
+  'Application Context key length (%d bytes) exceeds the maximum allowed (%d bytes)');
+messages.set(ERR_APP_CONTEXT_VALUE_TOO_LONG,            // NJS-187
+  'Application Context value length (%d bytes) exceeds the maximum allowed (%d bytes)');
+messages.set(ERR_UNSUPPORTED_KEY_LENGTH,               // NJS-188
+  'Unsupported encryption key length %d');
+messages.set(ERR_INVALID_END_USER_SECURITY_CONTEXT_LENGTH, // NJS-189
+  'Specified End User Context exceeds the maximum supported size %d');
+messages.set(ERR_END_USER_SECURITY_CONTEXT_REQUIRES_TCPS,  // NJS-190
+  'End User Context requires use of the tcps protocol');
+messages.set(ERR_UNSUPPORTED_DEEP_DATA_SECURITY_FEATURE,   // NJS-191
+  'database version does not support the Oracle Deep Data Security feature');
+messages.set(ERR_CHAR_CS_NOT_SUPPORTED,                 // NJS-192
+  'Character set id %d is not supported by node-oracledb in Thin mode');
 
 // Oracle Net layer errors
 
@@ -584,6 +648,8 @@ 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)');
+messages.set(ERR_CONNECT_DESCRIPTOR_LIMIT_EXCEEDED,     // NJS-522
+  'connection string exceeds supported descriptor %s limit of %d');
 messages.set(ERR_CONFIG_PROVIDER_FAILED_TO_RETRIEVE_CONFIG,   // NJS-523
   'Failed to retrieve configuration from Centralized Configuration Provider:\n %s');
 messages.set(ERR_REGISTER_HOOKFN_CONFIGPROVIDER,         // NJS-524
@@ -602,6 +668,8 @@ messages.set(ERR_DATA_COMPRESSION, 'Error during data compression/decompression:
 // Oracle SUCCESS_WITH_INFO warning
 messages.set(ERR_CONFIG_PROVIDER_PARAM_TYPE,               // NJS-535
   'Parameter does not have a valid type: %s\n');
+messages.set(ERR_TOO_MANY_REDIRECTS,               // NJS-536
+  'Too many connect redirects (limit: %d)');
 messages.set(WRN_COMPILATION_CREATE,                    // NJS-700
   'creation succeeded with compilation errors');
 
@@ -670,8 +738,8 @@ function assertParamPropInt(obj, parameterNum, propName) {
 //-----------------------------------------------------------------------------
 // assertParamPropUnsignedInt()
 //
-// Asserts that the property value of a parameter is a positive integer value
-// (or undefined).
+// Asserts that the property value of a parameter is a non-negative integer
+// value (or undefined).
 //-----------------------------------------------------------------------------
 function assertParamPropUnsignedInt(obj, parameterNum, propName) {
   if (obj[propName] !== undefined) {
@@ -779,10 +847,11 @@ function throwErrWithORAError() {
 //-----------------------------------------------------------------------------
 // throwNotImplemented()
 //
-// Throws an error that the feature is not supported in Thin mode
+// Throws an error that the feature is not supported in Thin/Thick mode
 //-----------------------------------------------------------------------------
 function throwNotImplemented(feature) {
-  throwErr(ERR_NOT_IMPLEMENTED, feature);
+  const settings = require('./settings.js');
+  throwErr(ERR_NOT_IMPLEMENTED, feature, settings.thin ? 'Thin' : 'Thick');
 }
 
 
@@ -847,6 +916,7 @@ function throwWrapErr(err, fnOpt) {
 
 // define exports
 module.exports = {
+  ERR_TOO_MANY_REDIRECTS,
   ERR_INTEGRITY_ERROR_CODES,
   ERR_INVALID_POOL,
   ERR_INVALID_CONNECTION,
@@ -930,6 +1000,7 @@ module.exports = {
   ERR_NO_CONFIG_DIR,
   ERR_TNS_ENTRY_NOT_FOUND,
   ERR_CONNECTION_EOF,
+  ERR_CONNECT_DESCRIPTOR_LIMIT_EXCEEDED,
   ERR_CONFIG_PROVIDER_FAILED_TO_RETRIEVE_CONFIG,
   ERR_CONFIG_PROVIDER_PARAM_TYPE,
   ERR_REGISTER_HOOKFN_CONFIGPROVIDER,
@@ -999,6 +1070,19 @@ module.exports = {
   ERR_SESSIONLESS_DIFFERING_METHODS,
   ERR_SESSIONLESS_ALREADY_ACTIVE,
   ERR_SESSIONLESS_INACTIVE,
+  ERR_INVALID_SERVER_RESPONSE,
+  ERR_PAYLOAD_CANNOT_BE_ENQUEUED,
+  ERR_NULLS_NOT_ALLOWED,
+  ERR_DPL_TOO_MUCH_DATA,
+  ERR_DPL_INVALID_ROW_DATA,
+  ERR_APP_CONTEXT_INVALID_KEY_VALUE,
+  ERR_APP_CONTEXT_KEY_TOO_LONG,
+  ERR_APP_CONTEXT_VALUE_TOO_LONG,
+  ERR_UNSUPPORTED_KEY_LENGTH,
+  ERR_APP_CONTEXT_EMPTY_NAMESPACE,
+  ERR_INVALID_END_USER_SECURITY_CONTEXT_LENGTH,
+  ERR_END_USER_SECURITY_CONTEXT_REQUIRES_TCPS,
+  ERR_UNSUPPORTED_DEEP_DATA_SECURITY_FEATURE,
   ERR_CONNECTION_CLOSED_CODE: `${ERR_PREFIX}-${ERR_CONNECTION_CLOSED}`,
   ERR_OPERATION_NOT_SUPPORTED_ON_BFILE,
   ERR_OPERATION_ONLY_SUPPORTED_ON_BFILE,
@@ -1015,6 +1099,13 @@ module.exports = {
   ERR_DB_FETCH_TYPE_HANDLER_RETURN_VALUE,
   ERR_ACCESS_TOKEN,
   ERR_CALLOUT_FN,
+  ERR_PIPELINE_OPERATION_NOT_SUPPORTED,
+  ERR_PIPELINE_MISMATCHED_TOKEN,
+  ERR_PIPELINE_DBOBJECTS_NOT_SUPPORTED,
+  ERR_PIPELINE_LARGE_BUFFERS_NOT_SUPPORTED,
+  ERR_PIPELINE_EXEC_OPTION_NOT_SUPPORTED,
+  ERR_INVALID_SQL_NAME,
+  ERR_CHAR_CS_NOT_SUPPORTED,
   WRN_COMPILATION_CREATE,
   assert,
   assertArgCount,

package/lib/impl/aqDeqOptions.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2022, Oracle and/or its affiliates.
+// Copyright (c) 2022, 2025, Oracle and/or its affiliates.
 
 //-----------------------------------------------------------------------------
 //
@@ -138,6 +138,15 @@ class AqDeqOptionsImpl {
     errors.throwNotImplemented("setting correlation (dequeue options)");
   }
 
+  //---------------------------------------------------------------------------
+  // setDeliveryMode()
+  //
+  // Sets the delivery mode to use for dequeuing messages.
+  //---------------------------------------------------------------------------
+  setDeliveryMode() {
+    errors.throwNotImplemented("setting deliveryMode (dequeue options)");
+  }
+
   //---------------------------------------------------------------------------
   // setMode()
   //

package/lib/impl/connection.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2022, 2025, Oracle and/or its affiliates.
+// Copyright (c) 2022, 2026, Oracle and/or its affiliates.
 
 //-----------------------------------------------------------------------------
 //
@@ -84,13 +84,16 @@ class ConnectionImpl {
     }
     traceConfig.serviceName = this.getServiceName();
     traceConfig.instanceName = this.getInstanceName();
-    traceConfig.pdbName = this.getDbName();
+    traceConfig.pdbName = this.getPdbName();
+    traceConfig.dbName = this.getDbName();
+    traceConfig.domainName = this.getDbDomain();
 
     // Thick mode doesnt have these properties for now.
     if (settings.thin) {
       traceConfig.hostName = this.getHostName();
       traceConfig.port = this.getPort();
       traceConfig.protocol = this.getProtocol();
+      traceConfig.dbUniqueName = this.getDbUniqueName();
     }
     return traceConfig;
   }
@@ -253,6 +256,24 @@ class ConnectionImpl {
     errors.throwNotImplemented("getting db name");
   }
 
+  //---------------------------------------------------------------------------
+  // getPdbName()
+  //
+  // Returns the name of a container associated with the connection..
+  //---------------------------------------------------------------------------
+  getPdbName() {
+    errors.throwNotImplemented("getting pdb name");
+  }
+
+  //---------------------------------------------------------------------------
+  // getDbUniqueName()
+  //
+  // Returns the Oracle Database unique name associated with the connection.
+  //---------------------------------------------------------------------------
+  getDbUniqueName() {
+    errors.throwNotImplemented("getting db unique name");
+  }
+
   //---------------------------------------------------------------------------
   // getDbObjectClass()
   //
@@ -539,6 +560,24 @@ class ConnectionImpl {
     errors.throwNotImplemented("setting end-to-end attribute 'module'");
   }
 
+  //---------------------------------------------------------------------------
+  // setEndUserSecurityContext()
+  //
+  // Sets the End Security Context.
+  //---------------------------------------------------------------------------
+  setEndUserSecurityContext() {
+    errors.throwNotImplemented("setting End User Security Context");
+  }
+
+  //---------------------------------------------------------------------------
+  // clearEndUserSecurityContext()
+  //
+  // Clears the End Security Context.
+  //---------------------------------------------------------------------------
+  clearEndUserSecurityContext() {
+    errors.throwNotImplemented("clearing End User Security Context");
+  }
+
   //---------------------------------------------------------------------------
   // setTag()
   //
@@ -638,6 +677,14 @@ class ConnectionImpl {
     errors.throwNotImplemented("unsubscribing from events");
   }
 
+  // supportsPipelining()
+  //
+  // Returns true if pipelining is supported.
+  //---------------------------------------------------------------------------
+  supportsPipelining() {
+    return false;
+  }
+
   //---------------------------------------------------------------------------
   // getHostName()
   //
@@ -665,6 +712,33 @@ class ConnectionImpl {
     errors.throwNotImplemented("getting Protocol");
   }
 
+  //---------------------------------------------------------------------------
+  // directPathLoad()
+  //
+  // Performs a direct path load into the specified table.
+  //---------------------------------------------------------------------------
+  directPathLoad() {
+    errors.throwNotImplemented("direct path load");
+  }
+
+  //---------------------------------------------------------------------------
+  // appContext()
+  //
+  // Add Application Context, keyValues identified by name, namespaceName.
+  //---------------------------------------------------------------------------
+  appContext() {
+    errors.throwNotImplemented("setting app context");
+  }
+
+  //---------------------------------------------------------------------------
+  // clearAppContext()
+  //
+  // Clears the Application Context, keyValues identified by name.
+  //---------------------------------------------------------------------------
+  clearAppContext() {
+    errors.throwNotImplemented("clear app context");
+  }
+
 }
 
 // export just the class